Package org.apache.tomcat.dbcp.dbcp2
Class PoolingDataSource<C extends java.sql.Connection>
- java.lang.Object
-
- org.apache.tomcat.dbcp.dbcp2.PoolingDataSource<C>
-
- Type Parameters:
C- The connection type
- All Implemented Interfaces:
java.lang.AutoCloseable,java.sql.Wrapper,javax.sql.CommonDataSource,javax.sql.DataSource
- Direct Known Subclasses:
ManagedDataSource
public class PoolingDataSource<C extends java.sql.Connection> extends java.lang.Object implements javax.sql.DataSource, java.lang.AutoCloseable- Since:
- 2.0
-
-
Constructor Summary
Constructors Constructor Description PoolingDataSource(ObjectPool<C> pool)Constructs a new instance backed by the given connection pool.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description voidclose()Closes and free allConnections from the pool.java.sql.ConnectiongetConnection()Returns aConnectionfrom my pool, according to the contract specified byObjectPool.borrowObject().java.sql.ConnectiongetConnection(java.lang.String uname, java.lang.String passwd)ThrowsUnsupportedOperationExceptionintgetLoginTimeout()ThrowsUnsupportedOperationException.java.io.PrintWritergetLogWriter()Returns my log writer.java.util.logging.LoggergetParentLogger()protected ObjectPool<C>getPool()booleanisAccessToUnderlyingConnectionAllowed()Returns the value of the accessToUnderlyingConnectionAllowed property.booleanisWrapperFor(java.lang.Class<?> iface)voidsetAccessToUnderlyingConnectionAllowed(boolean allow)Sets the value of the accessToUnderlyingConnectionAllowed property.voidsetLoginTimeout(int seconds)ThrowsUnsupportedOperationException.voidsetLogWriter(java.io.PrintWriter out)Sets my log writer.<T> Tunwrap(java.lang.Class<T> iface)
-
-
-
Constructor Detail
-
PoolingDataSource
public PoolingDataSource(ObjectPool<C> pool)
Constructs a new instance backed by the given connection pool.- Parameters:
pool- the given connection pool.
-
-
Method Detail
-
close
public void close() throws java.lang.RuntimeException, java.sql.SQLExceptionCloses and free allConnections from the pool.- Specified by:
closein interfacejava.lang.AutoCloseable- Throws:
java.lang.RuntimeExceptionjava.sql.SQLException- Since:
- 2.1
-
getConnection
public java.sql.Connection getConnection() throws java.sql.SQLExceptionReturns aConnectionfrom my pool, according to the contract specified byObjectPool.borrowObject().- Specified by:
getConnectionin interfacejavax.sql.DataSource- Throws:
java.sql.SQLException
-
getConnection
public java.sql.Connection getConnection(java.lang.String uname, java.lang.String passwd) throws java.sql.SQLExceptionThrowsUnsupportedOperationException- Specified by:
getConnectionin interfacejavax.sql.DataSource- Throws:
java.lang.UnsupportedOperationException- always thrownjava.sql.SQLException
-
getLoginTimeout
public int getLoginTimeout()
ThrowsUnsupportedOperationException.- Specified by:
getLoginTimeoutin interfacejavax.sql.CommonDataSource- Specified by:
getLoginTimeoutin interfacejavax.sql.DataSource- Throws:
java.lang.UnsupportedOperationException- As this implementation does not support this feature.
-
getLogWriter
public java.io.PrintWriter getLogWriter()
Returns my log writer.- Specified by:
getLogWriterin interfacejavax.sql.CommonDataSource- Specified by:
getLogWriterin interfacejavax.sql.DataSource- Returns:
- my log writer
- See Also:
DataSource.getLogWriter()
-
getParentLogger
public java.util.logging.Logger getParentLogger() throws java.sql.SQLFeatureNotSupportedException- Specified by:
getParentLoggerin interfacejavax.sql.CommonDataSource- Throws:
java.sql.SQLFeatureNotSupportedException
-
getPool
protected ObjectPool<C> getPool()
-
isAccessToUnderlyingConnectionAllowed
public boolean isAccessToUnderlyingConnectionAllowed()
Returns the value of the accessToUnderlyingConnectionAllowed property.- Returns:
- true if access to the underlying
Connectionis allowed, false otherwise.
-
isWrapperFor
public boolean isWrapperFor(java.lang.Class<?> iface) throws java.sql.SQLException- Specified by:
isWrapperForin interfacejava.sql.Wrapper- Throws:
java.sql.SQLException
-
setAccessToUnderlyingConnectionAllowed
public 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.
-
setLoginTimeout
public void setLoginTimeout(int seconds)
ThrowsUnsupportedOperationException.- Specified by:
setLoginTimeoutin interfacejavax.sql.CommonDataSource- Specified by:
setLoginTimeoutin interfacejavax.sql.DataSource- Throws:
java.lang.UnsupportedOperationException- As this implementation does not support this feature.
-
setLogWriter
public void setLogWriter(java.io.PrintWriter out)
Sets my log writer.- Specified by:
setLogWriterin interfacejavax.sql.CommonDataSource- Specified by:
setLogWriterin interfacejavax.sql.DataSource- See Also:
DataSource.setLogWriter(java.io.PrintWriter)
-
unwrap
public <T> T unwrap(java.lang.Class<T> iface) throws java.sql.SQLException- Specified by:
unwrapin interfacejava.sql.Wrapper- Throws:
java.sql.SQLException
-
-