org.beiter.michael.db

Class ConnectionFactory

java.lang.Object

org.beiter.michael.db.ConnectionFactory

public final class ConnectionFactory
extends Object

This class creates and manages JDBC Connection instances from:

• A named JNDI managed connection
• A connection pool that is maintained by this factory

Method Summary

Modifier and Type	Method and Description
static Connection	getConnection(String jndiName) Return a Connection instance for a JNDI managed JDBC connection.
static Connection	getConnection(String driver, ConnectionSpec connectionSpec, ConnectionPoolSpec poolSpec) Return a Connection instance from a pool that managed JDBC driver based connections.
static Connection	getConnection(String driver, String url, Map<String,String> properties, ConnectionPoolSpec poolSpec) Return a Connection instance from a pool that manages JDBC driver based connections.
static void	reset() Resets the internal state of the factory.

Methods inherited from class java.lang.Object

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

Method Detail

getConnection

public static Connection getConnection(String jndiName)
                                throws FactoryException

Return a Connection instance for a JNDI managed JDBC connection.

Parameters:

jndiName - The JNDI connection name

Returns:

a JDBC connection

Throws:

FactoryException - When the connection cannot be retrieved from JNDI

getConnection

public static Connection getConnection(String driver,
                                       ConnectionSpec connectionSpec,
                                       ConnectionPoolSpec poolSpec)
                                throws FactoryException

Return a Connection instance from a pool that managed JDBC driver based connections.

The driver-based connection are managed in a connection pool.

Parameters:

driver - The JDBC driver class to use

connectionSpec - The connection spec to use

poolSpec - A connection pool spec

Returns:

a JDBC connection

Throws:

FactoryException - When the connection cannot be retrieved from the pool, or the pool cannot be created

getConnection

public static Connection getConnection(String driver,
                                       String url,
                                       Map<String,String> properties,
                                       ConnectionPoolSpec poolSpec)
                                throws FactoryException

Return a Connection instance from a pool that manages JDBC driver based connections.

The driver-based connection are managed in a connection pool. The pool is created using the provided properties for both the connection and the pool spec. Once the pool has been created, it is cached (based on URL and username), and can no longer be changed. Subsequent calls to this method will return a connection from the cached pool, and changes in the pool spec (e.g. changes to the size of the pool) will be ignored.

Parameters:

driver - The JDBC driver class to use

url - The JDBC database URL of the form jdbc:subprotocol:subname

properties - A list of key/value configuration parameters to pass as connection arguments. Normally at least a "user" and "password" property should be included

poolSpec - A connection pool spec

Returns:

a JDBC connection

Throws:

FactoryException - When the connection cannot be retrieved from the pool, or the pool cannot be created

reset

public static void reset()

Resets the internal state of the factory.

This method does not release any resources that have been borrowed from the connection pools managed by this factory. To avoid resource leaks, you must close / return all connections to their pools before calling this method.