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: 500687 $ $Date: 2007-01-27 16:33:47 -0700 (Sat, 27 Jan 2007) $
Author:
Rodney Waldhoff, Dirk Verbeeck

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()
           
 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
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

PoolingDriver

public PoolingDriver()
Method Detail

acceptsURL

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

closePool

public void closePool(java.lang.String name)
               throws java.sql.SQLException
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

getConnectionPool

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

getMajorVersion

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

getMinorVersion

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

getPoolNames

public java.lang.String[] getPoolNames()
                                throws java.sql.SQLException
Throws:
java.sql.SQLException

getPropertyInfo

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

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

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 java.sql.Driver

registerPool

public void registerPool(java.lang.String name,
                         org.apache.commons.pool.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.


Copyright © 2001-2004 Apache Software Foundation. Documenation generated May 18 2009.