org.quartz.utils
Class PoolingConnectionProvider

java.lang.Object
  org.quartz.utils.PoolingConnectionProvider

All Implemented Interfaces:

ConnectionProvider

public class PoolingConnectionProvider
extends Object
implements ConnectionProvider

A ConnectionProvider implementation that creates its own pool of connections.

This class uses DBCP, an Apache-Jakarta-Commons product.

Author:

Sharada Jambula, James House, Mohammad Rezaei

See Also:

DBConnectionManager, ConnectionProvider

Field Summary

static String	DB_DRIVER The JDBC database driver.
static String	DB_MAX_CONNECTIONS The maximum number of database connections to have in the pool.
static String	DB_PASSWORD The database user password.
static String	DB_URL The JDBC database URL.
static String	DB_USER The database user name.
static String	DB_VALIDATION_QUERY The database sql query to execute everytime a connection is retrieved from the pool to ensure that it is still valid.
static int	DEFAULT_DB_MAX_CONNECTIONS Default maximum number of database connections in the pool.

Constructor Summary

PoolingConnectionProvider(Properties config)
Create a connection pool using the given properties.

PoolingConnectionProvider(String dbDriver, String dbURL, String dbUser, String dbPassword, int maxConnections, String dbValidationQuery)

Method Summary

Connection	getConnection()
protected org.apache.commons.dbcp.BasicDataSource	getDataSource() Get the DBCP BasicDataSource created during initialization.
void	shutdown()

Methods inherited from class java.lang.Object

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

Field Detail

DB_DRIVER

public static final String DB_DRIVER

The JDBC database driver.

See Also:

Constant Field Values

DB_URL

public static final String DB_URL

The JDBC database URL.

See Also:

Constant Field Values

DB_USER

public static final String DB_USER

The database user name.

See Also:

Constant Field Values

DB_PASSWORD

public static final String DB_PASSWORD

The database user password.

See Also:

Constant Field Values

DB_MAX_CONNECTIONS

public static final String DB_MAX_CONNECTIONS

The maximum number of database connections to have in the pool.

See Also:

Constant Field Values

DB_VALIDATION_QUERY

public static final String DB_VALIDATION_QUERY

The database sql query to execute everytime a connection is retrieved from the pool to ensure that it is still valid.

See Also:

Constant Field Values

DEFAULT_DB_MAX_CONNECTIONS

public static final int DEFAULT_DB_MAX_CONNECTIONS

Default maximum number of database connections in the pool.

See Also:

Constant Field Values

Constructor Detail

PoolingConnectionProvider

public PoolingConnectionProvider(String dbDriver,
                                 String dbURL,
                                 String dbUser,
                                 String dbPassword,
                                 int maxConnections,
                                 String dbValidationQuery)
                          throws SQLException

Throws:

SQLException

PoolingConnectionProvider

public PoolingConnectionProvider(Properties config)
                          throws SQLException

Create a connection pool using the given properties.

The properties passed should contain:

• DB_DRIVER- The database driver class name
• DB_URL- The database URL
• DB_USER- The database user
• DB_PASSWORD- The database password
• DB_MAX_CONNECTIONS- The maximum # connections in the pool, optional
• DB_VALIDATION_QUERY- The sql validation query, optional

Parameters:

config - configuration properties

Throws:

SQLException

Method Detail

getDataSource

protected org.apache.commons.dbcp.BasicDataSource getDataSource()

Get the DBCP BasicDataSource created during initialization.

This can be used to set additional data source properties in a subclass's constructor.

getConnection

public Connection getConnection()
                         throws SQLException

Specified by:

getConnection in interface ConnectionProvider

Returns:

connection managed by this provider

Throws:

SQLException

shutdown

public void shutdown()
              throws SQLException

Specified by:

shutdown in interface ConnectionProvider

Throws:

SQLException