org.apache.derbyTesting.junit

Class JDBCDataSource

java.lang.Object

org.apache.derbyTesting.junit.JDBCDataSource

public class JDBCDataSource
extends java.lang.Object

Utility methods related to JDBC DataSource objects. J2EEDataSource exists to return XA and connection pooling data sources.

See Also:

J2EEDataSource

Constructor Summary

Constructors

Constructor and Description
JDBCDataSource()

Method Summary

Modifier and Type	Method and Description
static void	clearStringBeanProperty(java.lang.Object ds, java.lang.String property) Clear a String Java bean property by setting it to null.
static java.lang.Object	getBeanProperty(java.lang.Object ds, java.lang.String property) Get a bean property for a data source.
static javax.sql.DataSource	getDataSource() Return a new DataSource corresponding to the current configuration.
static javax.sql.DataSource	getDataSource(java.lang.String dbName) Return a new DataSource corresponding to the current configuration except that the database name is different.
(package private) static javax.sql.DataSource	getDataSource(TestConfiguration config, java.util.HashMap beanProperties) Create a new DataSource object setup from the passed in TestConfiguration.
(package private) static java.lang.Object	getDataSource(TestConfiguration config, java.util.HashMap beanProperties, java.lang.String dsClassName) Create a new DataSource object setup from the passed in TestConfiguration using the received properties and data source class name.
static javax.sql.DataSource	getDataSourceLogical(java.lang.String logicalDatabasename) Return a DataSource corresponding to one of the logical databases in the current configuration.
(package private) static javax.sql.DataSource	getDataSourceObject(java.lang.String classname, java.util.HashMap beanProperties) Return a DataSource object of the passed in type configured with the passed in Java bean properties.
(package private) static java.util.HashMap<java.lang.String,java.lang.Object>	getDataSourceProperties(TestConfiguration config) Create a HashMap with the set of Derby DataSource Java bean properties corresponding to the configuration.
private static java.lang.String	getGetterName(java.lang.String attribute)
private static java.lang.String	getSetterName(java.lang.String attribute)
static void	setBeanProperty(java.lang.Object ds, java.lang.String property, java.lang.Object value) Set a bean property for a data source.
static void	shutdownDatabase(javax.sql.DataSource ds) Shutdown the database described by this data source.
static void	shutEngine(javax.sql.DataSource ds) Shutdown the engine described by this data source.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

JDBCDataSource

public JDBCDataSource()

Method Detail

getDataSource

public static javax.sql.DataSource getDataSource()

Return a new DataSource corresponding to the current configuration. The getConnection() method will return a connection identical to TestConfiguration.openDefaultConnection().

getDataSource

public static javax.sql.DataSource getDataSource(java.lang.String dbName)

Return a new DataSource corresponding to the current configuration except that the database name is different.

getDataSourceLogical

public static javax.sql.DataSource getDataSourceLogical(java.lang.String logicalDatabasename)

Return a DataSource corresponding to one of the logical databases in the current configuration.

getDataSource

static javax.sql.DataSource getDataSource(TestConfiguration config,
                                          java.util.HashMap beanProperties)

Create a new DataSource object setup from the passed in TestConfiguration. The getConnection() method will return a connection identical to TestConfiguration.openDefaultConnection().

getDataSource

static java.lang.Object getDataSource(TestConfiguration config,
                                      java.util.HashMap beanProperties,
                                      java.lang.String dsClassName)

Create a new DataSource object setup from the passed in TestConfiguration using the received properties and data source class name.

getDataSourceProperties

static java.util.HashMap<java.lang.String,java.lang.Object> getDataSourceProperties(TestConfiguration config)

Create a HashMap with the set of Derby DataSource Java bean properties corresponding to the configuration.

getDataSourceObject

static javax.sql.DataSource getDataSourceObject(java.lang.String classname,
                                                java.util.HashMap beanProperties)

Return a DataSource object of the passed in type configured with the passed in Java bean properties. This will actually work with any object that has Java bean setter methods.
If a thread context class loader exists then it is used to try and load the class.

setBeanProperty

public static void setBeanProperty(java.lang.Object ds,
                                   java.lang.String property,
                                   java.lang.Object value)

Set a bean property for a data source. This code can be used on any data source type.

Parameters:

ds - DataSource to have property set

property - name of property.

value - Value, type is derived from value's class.

getBeanProperty

public static java.lang.Object getBeanProperty(java.lang.Object ds,
                                               java.lang.String property)
                                        throws java.lang.Exception

Get a bean property for a data source. This code can be used on any data source type.

Parameters:

ds - DataSource to fetch property from

property - name of property.

Throws:

java.lang.Exception

clearStringBeanProperty

public static void clearStringBeanProperty(java.lang.Object ds,
                                           java.lang.String property)

Clear a String Java bean property by setting it to null.

Parameters:

ds - DataSource to have property cleared

property - name of property.

getSetterName

private static java.lang.String getSetterName(java.lang.String attribute)

getGetterName

private static java.lang.String getGetterName(java.lang.String attribute)

shutdownDatabase

public static void shutdownDatabase(javax.sql.DataSource ds)

Shutdown the database described by this data source. The shutdownDatabase property is cleared by this method.

shutEngine

public static void shutEngine(javax.sql.DataSource ds)
                       throws java.sql.SQLException

Shutdown the engine described by this data source. The shutdownDatabase property is cleared by this method.

Throws:

java.sql.SQLException