com.bea.p13n.util.jdbc
Class DatabaseFactory

java.lang.Object
  com.bea.p13n.util.jdbc.DatabaseFactory

public class DatabaseFactory

extends Object

The DatabaseFactory class provides a means for creating and returning specific Database instances relative to the database being used. This is necessary for CLOB and BLOB column processing. There are many different ways JDBC driver vendors choose to implement CLOB and BLOB handling. Here we address the need for driver-specific Database objects and attempt to handle them appropriately.

A java.sql.Connection object is passed in and the java.sql.DatabaseMetaData for that object is used to determine which database driver is responsible for creating the connection. A driver-specific Database instance will then be returned.

See Also:

Database

Constructor Summary

DatabaseFactory()

Method Summary

static void	deregisterDatabase(Database instance) Deprecated. In order to improve performance, dynamically registering/deregistering of databases with the DatabaseFactory is no longer supported. To change the list of supported databases you must modify database-registry.properties and restart your server.
static Connection	getConnection(DataSource src, int retries) Deprecated. Use DataSource.getConnection(), set retries by configuring the Pool
static Connection	getConnection(DataSource src, int retries, long waitTime) Deprecated. Use DataSource.getConnection(), set retries and waitTime by configuring the Pool
static Database	getInstance(Connection connection) Get the driver-specific Database instance.
static void	registerDatabase(Database instance) Deprecated. In order to improve performance, dynamically registering/deregistering of databases with the DatabaseFactory is no longer supported. To change the list of supported databases you must modify database-registry.properties and restart your server.

Methods inherited from class java.lang.Object

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

Constructor Detail

DatabaseFactory

public DatabaseFactory()

Method Detail

deregisterDatabase

public static void deregisterDatabase(Database instance)

Deprecated. In order to improve performance, dynamically registering/deregistering of databases with the DatabaseFactory is no longer supported. To change the list of supported databases you must modify database-registry.properties and restart your server.

Remove Database instance from the list of registered instances.

Parameters:

instance - The Database instance.

getConnection

public static Connection getConnection(DataSource src,
                                       int retries)
                                throws SQLException

Deprecated. Use DataSource.getConnection(), set retries by configuring the Pool

Get a connection from a DataSource.

This method no longer honors the retry parameter; it will use the 'Connection Reserve Timeout' parameter set on the JdbcConnectionPool via the WLS console.

Parameters:

src - The DataSource.

retries - No longer used - the settings on the pool are now used

Returns:

A Connection from the DataSource on success.

Throws:

SQLException - Thrown on an error when getting a connection.

getConnection

public static Connection getConnection(DataSource src,
                                       int retries,
                                       long waitTime)
                                throws SQLException

Deprecated. Use DataSource.getConnection(), set retries and waitTime by configuring the Pool

Get a connection from a DataSource.

This method no longer honors the retry parameter; it will use the 'Connection Reserve Timeout' parameter set on the JdbcConnectionPool via the WLS console.

Parameters:

src - The DataSource.

retries - No longer used - the settings on the pool are now used

waitTime - No longer used - the settings on the pool are now used

Returns:

A Connection from the DataSource on success.

Throws:

SQLException - Thrown when trying to get a connection.

getInstance

public static Database getInstance(Connection connection)
                            throws SQLException

Get the driver-specific Database instance.

Parameters:

connection - A java.sql.Connection object.

Returns:

The driver-specific Database instance.

Throws:

SQLException - Cannot create or cannot find Database instance for the connection.

registerDatabase

public static void registerDatabase(Database instance)

Deprecated. In order to improve performance, dynamically registering/deregistering of databases with the DatabaseFactory is no longer supported. To change the list of supported databases you must modify database-registry.properties and restart your server.

Add Database instance to the list of registered instances.

Parameters:

instance - The Database instance.