org.apache.commons.dbcp2

Class PoolingDriver

java.lang.Object

org.apache.commons.dbcp2.PoolingDriver

All Implemented Interfaces:

Driver

public class PoolingDriver
extends Object
implements Driver

A Driver implementation that obtains Connections from a registered ObjectPool.

Since:

2.0

Version:

$Id: PoolingDriver.java 1649430 2015-01-04 21:29:32Z tn $

Author:

Rodney Waldhoff, Dirk Verbeeck

Field Summary

Fields

Modifier and Type	Field and Description
protected static int	MAJOR_VERSION
protected static int	MINOR_VERSION
protected static HashMap<String,ObjectPool<? extends Connection>>	pools The map of registered pools.
protected static String	URL_PREFIX My URL prefix
protected static int	URL_PREFIX_LEN

Constructor Summary

Constructors

Modifier	Constructor and Description
	PoolingDriver()
protected	PoolingDriver(boolean accessToUnderlyingConnectionAllowed) For unit testing purposes.

Method Summary

Modifier and Type	Method and Description
boolean	acceptsURL(String url)
void	closePool(String name)
Connection	connect(String url, Properties info)
ObjectPool<? extends Connection>	getConnectionPool(String name)
int	getMajorVersion()
int	getMinorVersion()
Logger	getParentLogger()
String[]	getPoolNames()
DriverPropertyInfo[]	getPropertyInfo(String url, Properties info)
void	invalidateConnection(Connection conn) Invalidates the given connection.
protected boolean	isAccessToUnderlyingConnectionAllowed() Returns the value of the accessToUnderlyingConnectionAllowed property.
boolean	jdbcCompliant()
void	registerPool(String name, ObjectPool<? extends Connection> pool)

Methods inherited from class java.lang.Object

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

Field Detail

pools

protected static final HashMap<String,ObjectPool<? extends Connection>> pools

The map of registered pools.

URL_PREFIX

protected static final String URL_PREFIX

My URL prefix

See Also:

Constant Field Values

URL_PREFIX_LEN

protected static final int URL_PREFIX_LEN

MAJOR_VERSION

protected static final int MAJOR_VERSION

See Also:

Constant Field Values

MINOR_VERSION

protected static final int MINOR_VERSION

See Also:

Constant Field Values

Constructor Detail

PoolingDriver

public PoolingDriver()

PoolingDriver

protected PoolingDriver(boolean accessToUnderlyingConnectionAllowed)

For unit testing purposes.

Method Detail

isAccessToUnderlyingConnectionAllowed

protected boolean isAccessToUnderlyingConnectionAllowed()

Returns the value of the accessToUnderlyingConnectionAllowed property.

Returns:

true if access to the underlying is allowed, false otherwise.

getConnectionPool

public ObjectPool<? extends Connection> getConnectionPool(String name)
                                                   throws SQLException

Throws:

SQLException

registerPool

public void registerPool(String name,
                         ObjectPool<? extends Connection> pool)

closePool

public void closePool(String name)
               throws SQLException

Throws:

SQLException

getPoolNames

public String[] getPoolNames()

acceptsURL

public boolean acceptsURL(String url)
                   throws SQLException

Specified by:

acceptsURL in interface Driver

Throws:

SQLException

connect

public Connection connect(String url,
                          Properties info)
                   throws SQLException

Specified by:

connect in interface Driver

Throws:

SQLException

getParentLogger

public Logger getParentLogger()
                       throws SQLFeatureNotSupportedException

Specified by:

getParentLogger in interface Driver

Throws:

SQLFeatureNotSupportedException

invalidateConnection

public void invalidateConnection(Connection conn)
                          throws SQLException

Invalidates the given connection.

Parameters:

conn - connection to invalidate

Throws:

SQLException - if the connection is not a PoolGuardConnectionWrapper or an error occurs invalidating the connection

getMajorVersion

public int getMajorVersion()

Specified by:

getMajorVersion in interface Driver

getMinorVersion

public int getMinorVersion()

Specified by:

getMinorVersion in interface Driver

jdbcCompliant

public boolean jdbcCompliant()

Specified by:

jdbcCompliant in interface Driver

getPropertyInfo

public DriverPropertyInfo[] getPropertyInfo(String url,
                                            Properties info)

Specified by:

getPropertyInfo in interface Driver