org.avaje.datasource.pool

Class PooledConnection

java.lang.Object

org.avaje.datasource.delegate.ConnectionDelegator

org.avaje.datasource.pool.PooledConnection

All Implemented Interfaces:

AutoCloseable, Connection, Wrapper

public class PooledConnection
extends ConnectionDelegator

Is a connection that belongs to a DataSourcePool.

It is designed to be part of DataSourcePool. Closing the connection puts it back into the pool.

It defaults autoCommit and Transaction Isolation to the defaults of the DataSourcePool.

It has caching of Statements and PreparedStatements. Remembers the last statement that was executed. Keeps statistics on how long it is in use.

Field Summary

Fields inherited from interface java.sql.Connection

TRANSACTION_NONE, TRANSACTION_READ_COMMITTED, TRANSACTION_READ_UNCOMMITTED, TRANSACTION_REPEATABLE_READ, TRANSACTION_SERIALIZABLE

Constructor Summary

Constructors

Constructor and Description
PooledConnection(ConnectionPool pool, int uniqueId, Connection connection) Construct the connection that can refer back to the pool it belongs to.

Method Summary

Modifier and Type	Method and Description
void	clearWarnings()
void	close() close the connection putting it back into the connection pool.
void	commit()
Statement	createStatement() Creates a wrapper ExtendedStatement so that I can get the executed sql.
Statement	createStatement(int resultSetType, int resultSetConcurreny)
Statement	createStatement(int i, int x, int y)
boolean	getAutoCommit()
String	getCatalog()
int	getHoldability()
DatabaseMetaData	getMetaData()
int	getTransactionIsolation()
Map<String,Class<?>>	getTypeMap()
SQLWarning	getWarnings()
boolean	isClosed()
boolean	isReadOnly()
String	nativeSQL(String sql)
CallableStatement	prepareCall(String sql)
CallableStatement	prepareCall(String sql, int resultSetType, int resultSetConcurreny)
CallableStatement	prepareCall(String s, int i, int x, int y)
PreparedStatement	prepareStatement(String sql) This will try to use a cache of PreparedStatements.
PreparedStatement	prepareStatement(String sql, int returnKeysFlag) This will try to use a cache of PreparedStatements.
PreparedStatement	prepareStatement(String s, int[] i)
PreparedStatement	prepareStatement(String sql, int resultSetType, int resultSetConcurreny)
PreparedStatement	prepareStatement(String s, int i, int x, int y)
PreparedStatement	prepareStatement(String s, String[] s2)
void	releaseSavepoint(Savepoint sp)
void	rollback()
void	rollback(Savepoint sp)
void	setAutoCommit(boolean autoCommit)
void	setCatalog(String catalog)
void	setHoldability(int i)
void	setLongRunning(boolean longRunning) Set this to true if the connection is a long running connection and should skip the 'suspected connection pool leak' checking.
void	setReadOnly(boolean readOnly) Also note the read only status needs to be reset when put back into the pool.
Savepoint	setSavepoint()
Savepoint	setSavepoint(String savepointName)
void	setTransactionIsolation(int level) Also note the Isolation level needs to be reset when put back into the pool.
void	setTypeMap(Map<String,Class<?>> map)
String	toString()

Methods inherited from class org.avaje.datasource.delegate.ConnectionDelegator

abort, createArrayOf, createBlob, createClob, createNClob, createSQLXML, createStruct, getClientInfo, getClientInfo, getNetworkTimeout, getSchema, isValid, isWrapperFor, setClientInfo, setClientInfo, setNetworkTimeout, setSchema, unwrap

Methods inherited from class java.lang.Object

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

Constructor Detail

PooledConnection

public PooledConnection(ConnectionPool pool,
                        int uniqueId,
                        Connection connection)

Construct the connection that can refer back to the pool it belongs to.

close() will return the connection back to the pool , while closeDestroy() will close() the underlining connection properly.

Method Detail

toString

public String toString()

Overrides:

toString in class Object

setLongRunning

public void setLongRunning(boolean longRunning)

Set this to true if the connection is a long running connection and should skip the 'suspected connection pool leak' checking.

createStatement

public Statement createStatement()
                          throws SQLException

Creates a wrapper ExtendedStatement so that I can get the executed sql. I want to do this so that I can get the slowest query statments etc, and log that information.

Specified by:

createStatement in interface Connection

Overrides:

createStatement in class ConnectionDelegator

Throws:

SQLException

createStatement

public Statement createStatement(int resultSetType,
                                 int resultSetConcurreny)
                          throws SQLException

Specified by:

createStatement in interface Connection

Overrides:

createStatement in class ConnectionDelegator

Throws:

SQLException

prepareStatement

public PreparedStatement prepareStatement(String sql,
                                          int returnKeysFlag)
                                   throws SQLException

This will try to use a cache of PreparedStatements.

Specified by:

prepareStatement in interface Connection

Overrides:

prepareStatement in class ConnectionDelegator

Throws:

SQLException

prepareStatement

public PreparedStatement prepareStatement(String sql)
                                   throws SQLException

This will try to use a cache of PreparedStatements.

Specified by:

prepareStatement in interface Connection

Overrides:

prepareStatement in class ConnectionDelegator

Throws:

SQLException

prepareStatement

public PreparedStatement prepareStatement(String sql,
                                          int resultSetType,
                                          int resultSetConcurreny)
                                   throws SQLException

Specified by:

prepareStatement in interface Connection

Overrides:

prepareStatement in class ConnectionDelegator

Throws:

SQLException

close

public void close()
           throws SQLException

close the connection putting it back into the connection pool.

Note that to ensure that the next transaction starts at the correct time a commit() or rollback() should be called. If neither has occured at this time then a rollback() is used (to end the transaction).

To close the connection fully use closeConnectionFully().

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Connection

Overrides:

close in class ConnectionDelegator

Throws:

SQLException

setReadOnly

public void setReadOnly(boolean readOnly)
                 throws SQLException

Also note the read only status needs to be reset when put back into the pool.

Specified by:

setReadOnly in interface Connection

Overrides:

setReadOnly in class ConnectionDelegator

Throws:

SQLException

setTransactionIsolation

public void setTransactionIsolation(int level)
                             throws SQLException

Also note the Isolation level needs to be reset when put back into the pool.

Specified by:

setTransactionIsolation in interface Connection

Overrides:

setTransactionIsolation in class ConnectionDelegator

Throws:

SQLException

clearWarnings

public void clearWarnings()
                   throws SQLException

Specified by:

clearWarnings in interface Connection

Overrides:

clearWarnings in class ConnectionDelegator

Throws:

SQLException

commit

public void commit()
            throws SQLException

Specified by:

commit in interface Connection

Overrides:

commit in class ConnectionDelegator

Throws:

SQLException

getAutoCommit

public boolean getAutoCommit()
                      throws SQLException

Specified by:

getAutoCommit in interface Connection

Overrides:

getAutoCommit in class ConnectionDelegator

Throws:

SQLException

getCatalog

public String getCatalog()
                  throws SQLException

Specified by:

getCatalog in interface Connection

Overrides:

getCatalog in class ConnectionDelegator

Throws:

SQLException

getMetaData

public DatabaseMetaData getMetaData()
                             throws SQLException

Specified by:

getMetaData in interface Connection

Overrides:

getMetaData in class ConnectionDelegator

Throws:

SQLException

getTransactionIsolation

public int getTransactionIsolation()
                            throws SQLException

Specified by:

getTransactionIsolation in interface Connection

Overrides:

getTransactionIsolation in class ConnectionDelegator

Throws:

SQLException

getTypeMap

public Map<String,Class<?>> getTypeMap()
                                throws SQLException

Specified by:

getTypeMap in interface Connection

Overrides:

getTypeMap in class ConnectionDelegator

Throws:

SQLException

getWarnings

public SQLWarning getWarnings()
                       throws SQLException

Specified by:

getWarnings in interface Connection

Overrides:

getWarnings in class ConnectionDelegator

Throws:

SQLException

isClosed

public boolean isClosed()
                 throws SQLException

Specified by:

isClosed in interface Connection

Overrides:

isClosed in class ConnectionDelegator

Throws:

SQLException

isReadOnly

public boolean isReadOnly()
                   throws SQLException

Specified by:

isReadOnly in interface Connection

Overrides:

isReadOnly in class ConnectionDelegator

Throws:

SQLException

nativeSQL

public String nativeSQL(String sql)
                 throws SQLException

Specified by:

nativeSQL in interface Connection

Overrides:

nativeSQL in class ConnectionDelegator

Throws:

SQLException

prepareCall

public CallableStatement prepareCall(String sql)
                              throws SQLException

Specified by:

prepareCall in interface Connection

Overrides:

prepareCall in class ConnectionDelegator

Throws:

SQLException

prepareCall

public CallableStatement prepareCall(String sql,
                                     int resultSetType,
                                     int resultSetConcurreny)
                              throws SQLException

Specified by:

prepareCall in interface Connection

Overrides:

prepareCall in class ConnectionDelegator

Throws:

SQLException

rollback

public void rollback()
              throws SQLException

Specified by:

rollback in interface Connection

Overrides:

rollback in class ConnectionDelegator

Throws:

SQLException

setAutoCommit

public void setAutoCommit(boolean autoCommit)
                   throws SQLException

Specified by:

setAutoCommit in interface Connection

Overrides:

setAutoCommit in class ConnectionDelegator

Throws:

SQLException

setCatalog

public void setCatalog(String catalog)
                throws SQLException

Specified by:

setCatalog in interface Connection

Overrides:

setCatalog in class ConnectionDelegator

Throws:

SQLException

setTypeMap

public void setTypeMap(Map<String,Class<?>> map)
                throws SQLException

Specified by:

setTypeMap in interface Connection

Overrides:

setTypeMap in class ConnectionDelegator

Throws:

SQLException

setSavepoint

public Savepoint setSavepoint()
                       throws SQLException

Specified by:

setSavepoint in interface Connection

Overrides:

setSavepoint in class ConnectionDelegator

Throws:

SQLException

setSavepoint

public Savepoint setSavepoint(String savepointName)
                       throws SQLException

Specified by:

setSavepoint in interface Connection

Overrides:

setSavepoint in class ConnectionDelegator

Throws:

SQLException

rollback

public void rollback(Savepoint sp)
              throws SQLException

Specified by:

rollback in interface Connection

Overrides:

rollback in class ConnectionDelegator

Throws:

SQLException

releaseSavepoint

public void releaseSavepoint(Savepoint sp)
                      throws SQLException

Specified by:

releaseSavepoint in interface Connection

Overrides:

releaseSavepoint in class ConnectionDelegator

Throws:

SQLException

setHoldability

public void setHoldability(int i)
                    throws SQLException

Specified by:

setHoldability in interface Connection

Overrides:

setHoldability in class ConnectionDelegator

Throws:

SQLException

getHoldability

public int getHoldability()
                   throws SQLException

Specified by:

getHoldability in interface Connection

Overrides:

getHoldability in class ConnectionDelegator

Throws:

SQLException

createStatement

public Statement createStatement(int i,
                                 int x,
                                 int y)
                          throws SQLException

Specified by:

createStatement in interface Connection

Overrides:

createStatement in class ConnectionDelegator

Throws:

SQLException

prepareStatement

public PreparedStatement prepareStatement(String s,
                                          int i,
                                          int x,
                                          int y)
                                   throws SQLException

Specified by:

prepareStatement in interface Connection

Overrides:

prepareStatement in class ConnectionDelegator

Throws:

SQLException

prepareStatement

public PreparedStatement prepareStatement(String s,
                                          int[] i)
                                   throws SQLException

Specified by:

prepareStatement in interface Connection

Overrides:

prepareStatement in class ConnectionDelegator

Throws:

SQLException

prepareStatement

public PreparedStatement prepareStatement(String s,
                                          String[] s2)
                                   throws SQLException

Specified by:

prepareStatement in interface Connection

Overrides:

prepareStatement in class ConnectionDelegator

Throws:

SQLException

prepareCall

public CallableStatement prepareCall(String s,
                                     int i,
                                     int x,
                                     int y)
                              throws SQLException

Specified by:

prepareCall in interface Connection

Overrides:

prepareCall in class ConnectionDelegator

Throws:

SQLException