org.apache.commons.dbcp

Class PoolingDriver

java.lang.Object

org.apache.commons.dbcp.PoolingDriver

All Implemented Interfaces:

Driver

public class PoolingDriver
extends Object
implements Driver

A Driver implementation that obtains Connections from a registered ObjectPool.

Version:

$Revision: 902692 $ $Date: 2010-01-24 22:28:54 -0500 (Sun, 24 Jan 2010) $

Author:

Rodney Waldhoff, Dirk Verbeeck

Constructor Summary

Constructors

Constructor and Description
PoolingDriver()

Method Summary

Methods

Modifier and Type	Method and Description
boolean	acceptsURL(String url)
void	closePool(String name)
Connection	connect(String url, Properties info)
ObjectPool	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.
static boolean	isAccessToUnderlyingConnectionAllowed() Returns the value of the accessToUnderlyingConnectionAllowed property.
boolean	jdbcCompliant()
void	registerPool(String name, ObjectPool pool)
static void	setAccessToUnderlyingConnectionAllowed(boolean allow) Sets the value of the accessToUnderlyingConnectionAllowed property.

Methods inherited from class java.lang.Object

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

Constructor Detail

PoolingDriver

public PoolingDriver()

Method Detail

acceptsURL

public boolean acceptsURL(String url)
                   throws SQLException

Specified by:

acceptsURL in interface Driver

Throws:

SQLException

closePool

public void closePool(String name)
               throws SQLException

Throws:

SQLException

connect

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

Specified by:

connect in interface Driver

Throws:

SQLException

getConnectionPool

public ObjectPool getConnectionPool(String name)
                             throws SQLException

Throws:

SQLException

getMajorVersion

public int getMajorVersion()

Specified by:

getMajorVersion in interface Driver

getMinorVersion

public int getMinorVersion()

Specified by:

getMinorVersion in interface Driver

getParentLogger

public Logger getParentLogger()
                       throws SQLFeatureNotSupportedException

Specified by:

getParentLogger in interface Driver

Throws:

SQLFeatureNotSupportedException

getPoolNames

public String[] getPoolNames()

getPropertyInfo

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

Specified by:

getPropertyInfo in interface Driver

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

Since:

1.2.2

isAccessToUnderlyingConnectionAllowed

public static boolean isAccessToUnderlyingConnectionAllowed()

Returns the value of the accessToUnderlyingConnectionAllowed property.

Returns:

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

jdbcCompliant

public boolean jdbcCompliant()

Specified by:

jdbcCompliant in interface Driver

registerPool

public void registerPool(String name,
                ObjectPool pool)

setAccessToUnderlyingConnectionAllowed

public static void setAccessToUnderlyingConnectionAllowed(boolean allow)

Sets the value of the accessToUnderlyingConnectionAllowed property. It controls if the PoolGuard allows access to the underlying connection. (Default: false)

Parameters:

allow - Access to the underlying connection is granted when true.