org.apache.commons.dbcp
Class PoolingDriver

java.lang.Object
  extended by org.apache.commons.dbcp.PoolingDriver
All Implemented Interfaces:
java.sql.Driver

public class PoolingDriver
extends java.lang.Object
implements java.sql.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

Field Summary
protected static java.util.HashMap _pools
          The map of registered pools.
protected static int MAJOR_VERSION
           
protected static int MINOR_VERSION
           
protected static java.lang.String URL_PREFIX
          My URL prefix
protected static int URL_PREFIX_LEN
           
 
Constructor Summary
PoolingDriver()
           
 
Method Summary
 boolean acceptsURL(java.lang.String url)
           
 void closePool(java.lang.String name)
           
 java.sql.Connection connect(java.lang.String url, java.util.Properties info)
           
 org.apache.commons.pool.ObjectPool getConnectionPool(java.lang.String name)
           
 int getMajorVersion()
           
 int getMinorVersion()
           
 org.apache.commons.pool.ObjectPool getPool(java.lang.String name)
          Deprecated. This will be removed in a future version of DBCP.
 java.lang.String[] getPoolNames()
           
 java.sql.DriverPropertyInfo[] getPropertyInfo(java.lang.String url, java.util.Properties info)
           
 void invalidateConnection(java.sql.Connection conn)
          Invalidates the given connection.
static boolean isAccessToUnderlyingConnectionAllowed()
          Returns the value of the accessToUnderlyingConnectionAllowed property.
 boolean jdbcCompliant()
           
 void registerPool(java.lang.String name, org.apache.commons.pool.ObjectPool pool)
           
static void setAccessToUnderlyingConnectionAllowed(boolean allow)
          Sets the value of the accessToUnderlyingConnectionAllowed property.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

_pools

protected static final java.util.HashMap _pools
The map of registered pools.


URL_PREFIX

protected static final java.lang.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()
Method Detail

isAccessToUnderlyingConnectionAllowed

public static boolean isAccessToUnderlyingConnectionAllowed()
Returns the value of the accessToUnderlyingConnectionAllowed property.

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

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.

getPool

public org.apache.commons.pool.ObjectPool getPool(java.lang.String name)
Deprecated. This will be removed in a future version of DBCP.

WARNING: This method throws DbcpExceptions (RuntimeExceptions) and will be replaced by the protected getConnectionPool method.


getConnectionPool

public org.apache.commons.pool.ObjectPool getConnectionPool(java.lang.String name)
                                                     throws java.sql.SQLException
Throws:
java.sql.SQLException

registerPool

public void registerPool(java.lang.String name,
                         org.apache.commons.pool.ObjectPool pool)

closePool

public void closePool(java.lang.String name)
               throws java.sql.SQLException
Throws:
java.sql.SQLException

getPoolNames

public java.lang.String[] getPoolNames()

acceptsURL

public boolean acceptsURL(java.lang.String url)
                   throws java.sql.SQLException
Specified by:
acceptsURL in interface java.sql.Driver
Throws:
java.sql.SQLException

connect

public java.sql.Connection connect(java.lang.String url,
                                   java.util.Properties info)
                            throws java.sql.SQLException
Specified by:
connect in interface java.sql.Driver
Throws:
java.sql.SQLException

invalidateConnection

public void invalidateConnection(java.sql.Connection conn)
                          throws java.sql.SQLException
Invalidates the given connection.

Parameters:
conn - connection to invalidate
Throws:
java.sql.SQLException - if the connection is not a PoolGuardConnectionWrapper or an error occurs invalidating the connection
Since:
1.2.2

getMajorVersion

public int getMajorVersion()
Specified by:
getMajorVersion in interface java.sql.Driver

getMinorVersion

public int getMinorVersion()
Specified by:
getMinorVersion in interface java.sql.Driver

jdbcCompliant

public boolean jdbcCompliant()
Specified by:
jdbcCompliant in interface java.sql.Driver

getPropertyInfo

public java.sql.DriverPropertyInfo[] getPropertyInfo(java.lang.String url,
                                                     java.util.Properties info)
Specified by:
getPropertyInfo in interface java.sql.Driver


Copyright © 2001-2011 Apache Software Foundation. All Rights Reserved.