PoolingDataSource (Apache Tomcat 8.0.53 API Documentation)

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
```
public class PoolingDataSource<C extends java.sql.Connection>
extends java.lang.Object
implements javax.sql.DataSource, java.lang.AutoCloseable
```
A simple DataSource implementation that obtains Connections from the specified ObjectPool.

Since:

2.0

Constructor Summary

Constructors
Constructor and Description

PoolingDataSource(ObjectPool<C> pool)
Constructs a new instance backed by the given connection pool.

Constructors
Constructor and Description
`PoolingDataSource(ObjectPool<C> pool)` Constructs a new instance backed by the given connection pool.

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`close()` Closes and free all `Connection`s from the pool.
`java.sql.Connection`	`getConnection()` Returns a `Connection` from my pool, according to the contract specified by `ObjectPool.borrowObject()`.
`java.sql.Connection`	`getConnection(java.lang.String uname, java.lang.String passwd)` Throws `UnsupportedOperationException`
`int`	`getLoginTimeout()` Throws `UnsupportedOperationException`.
`java.io.PrintWriter`	`getLogWriter()` Returns my log writer.
`java.util.logging.Logger`	`getParentLogger()`
`protected ObjectPool<C>`	`getPool()`
`boolean`	`isAccessToUnderlyingConnectionAllowed()` Returns the value of the accessToUnderlyingConnectionAllowed property.
`boolean`	`isWrapperFor(java.lang.Class<?> iface)`
`void`	`setAccessToUnderlyingConnectionAllowed(boolean allow)` Sets the value of the accessToUnderlyingConnectionAllowed property.
`void`	`setLoginTimeout(int seconds)` Throws `UnsupportedOperationException`.
`void`	`setLogWriter(java.io.PrintWriter out)` Sets my log writer.
`<T> T`	`unwrap(java.lang.Class<T> iface)`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 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.Exception
```
    Closes and free all Connections from the pool.
    
    Specified by:
    
    close in interface java.lang.AutoCloseable
    
    Throws:
    
    java.lang.Exception
    Since:
    
    2.1
  - isAccessToUnderlyingConnectionAllowed
```
public boolean isAccessToUnderlyingConnectionAllowed()
```
    Returns the value of the accessToUnderlyingConnectionAllowed property.
    
    Returns:
    true if access to the underlying Connection is allowed, false otherwise.
  - 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.
  - isWrapperFor
```
public boolean isWrapperFor(java.lang.Class<?> iface)
                     throws java.sql.SQLException
```
    Specified by:
    
    isWrapperFor in interface java.sql.Wrapper
    
    Throws:
    
    java.sql.SQLException
  - unwrap
```
public <T> T unwrap(java.lang.Class<T> iface)
         throws java.sql.SQLException
```
    Specified by:
    
    unwrap in interface java.sql.Wrapper
    
    Throws:
    
    java.sql.SQLException
  - getParentLogger
```
public java.util.logging.Logger getParentLogger()
                                         throws java.sql.SQLFeatureNotSupportedException
```
    Specified by:
    
    getParentLogger in interface javax.sql.CommonDataSource
    
    Throws:
    
    java.sql.SQLFeatureNotSupportedException
  - getConnection
```
public java.sql.Connection getConnection()
                                  throws java.sql.SQLException
```
    Returns a Connection from my pool, according to the contract specified by ObjectPool.borrowObject().
    
    Specified by:
    
    getConnection in interface javax.sql.DataSource
    
    Throws:
    
    java.sql.SQLException
  - getConnection
```
public java.sql.Connection getConnection(java.lang.String uname,
                                java.lang.String passwd)
                                  throws java.sql.SQLException
```
    Throws UnsupportedOperationException
    
    Specified by:
    
    getConnection in interface javax.sql.DataSource
    
    Throws:
    
    java.lang.UnsupportedOperationException - always thrown
    
    java.sql.SQLException
  - getLogWriter
```
public java.io.PrintWriter getLogWriter()
```
    Returns my log writer.
    
    Specified by:
    
    getLogWriter in interface javax.sql.CommonDataSource
    
    Returns:
    my log writer
    See Also:
    CommonDataSource.getLogWriter()
  - getLoginTimeout
```
public int getLoginTimeout()
```
    Throws UnsupportedOperationException.
    
    Specified by:
    
    getLoginTimeout in interface javax.sql.CommonDataSource
    
    Throws:
    
    java.lang.UnsupportedOperationException - As this implementation does not support this feature.
  - setLoginTimeout
```
public void setLoginTimeout(int seconds)
```
    Throws UnsupportedOperationException.
    
    Specified by:
    
    setLoginTimeout in interface javax.sql.CommonDataSource
    
    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:
    
    setLogWriter in interface javax.sql.CommonDataSource
    
    See Also:
    CommonDataSource.setLogWriter(java.io.PrintWriter)
  - getPool
```
protected ObjectPool<C> getPool()
```

Class PoolingDataSource<C extends java.sql.Connection>

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

PoolingDataSource

Method Detail

close

isAccessToUnderlyingConnectionAllowed

setAccessToUnderlyingConnectionAllowed

isWrapperFor

unwrap

getParentLogger

getConnection

getConnection

getLogWriter

getLoginTimeout

setLoginTimeout

setLogWriter

getPool