PooledConnection (MollyPages.org Foundation API)

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

fc.jdbc
Class PooledConnection

java.lang.Object
  fc.jdbc.PooledConnection

All Implemented Interfaces:: java.sql.Connection, java.sql.Wrapper

public class PooledConnection
extends java.lang.Object
implements java.sql.Connection
extends java.lang.Object
implements java.sql.Connection

A poolable Connection that works with the PooledConnectionMgr. Closing this connection marks it as closed and returns it to the pool.

The connection can be retrieved and closed as many times as needed. It is very important that a connection be closed after use (this is true for all connections, pooled or regular).

Typically one does so by saying:

Connection con;
try {
        con = [..get either a pooled or regular connection..]
        ..use..
        con.commit();  //if transactional
        }
catch (SQLException e) {
        con.rollback(); //if transactional
        }
finally {
        con.close();  //always (transactional or not)
        }

Super Important: transactions are not rolled back or committed when close is invoked. You must either commit or rollback the transaction if in transaction mode (ie you have called setAutoCommit(false) on this connection). Returning the connection (via close) back to the pool without committing/rolling-back will keep the prior statements around and those will be committed/rolledback at a later date if commit/rollback is invoked upon retrieving/using the connection again.

Field Summary

Fields inherited from interface java.sql.Connection
`TRANSACTION_NONE, TRANSACTION_READ_COMMITTED, TRANSACTION_READ_UNCOMMITTED, TRANSACTION_REPEATABLE_READ, TRANSACTION_SERIALIZABLE`

Constructor Summary
`PooledConnection(PooledConnectionMgr pool, java.sql.Connection con)` Creates a initially open pooled connection that wraps the specified jdbc connection.

Method Summary
`void`	`clearWarnings()`
`void`	`close()` transactions are not rolled back or committed when `close` is invoked.
`void`	`commit()`
`java.sql.Array`	`createArrayOf(java.lang.String str, java.lang.Object[] arr)`
`java.sql.Blob`	`createBlob()`
`java.sql.Clob`	`createClob()`
`java.sql.NClob`	`createNClob()`
`java.sql.SQLXML`	`createSQLXML()`
`java.sql.Statement`	`createStatement()`
`java.sql.Statement`	`createStatement(int resultSetType, int resultSetConcurrency)`
`java.sql.Statement`	`createStatement(int resultSetType, int resultSetConcurrency, int resultSetHoldability)`
`java.sql.Struct`	`createStruct(java.lang.String str, java.lang.Object[] arr)`
`boolean`	`getAutoCommit()`
`java.sql.PreparedStatement`	`getCachedPreparedStatement(java.lang.String sql)`
`java.lang.String`	`getCatalog()`
`java.util.Properties`	`getClientInfo()`
`java.lang.String`	`getClientInfo(java.lang.String name)`
`int`	`getHoldability()`
`java.sql.DatabaseMetaData`	`getMetaData()`
`int`	`getTransactionIsolation()`
`java.util.Map`	`getTypeMap()`
`java.sql.SQLWarning`	`getWarnings()`
`boolean`	`isClosed()`
`boolean`	`isReadOnly()`
`boolean`	`isValid(int timeout)`
`boolean`	`isWrapperFor(java.lang.Class iface)`
`java.lang.String`	`nativeSQL(java.lang.String sql)`
`java.sql.CallableStatement`	`prepareCall(java.lang.String sql)`
`java.sql.CallableStatement`	`prepareCall(java.lang.String sql, int resultSetType, int resultSetConcurrency)`
`java.sql.CallableStatement`	`prepareCall(java.lang.String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability)`
`java.sql.PreparedStatement`	`prepareStatement(java.lang.String sql)`
`java.sql.PreparedStatement`	`prepareStatement(java.lang.String sql, int autoGeneratedKeys)`
`java.sql.PreparedStatement`	`prepareStatement(java.lang.String sql, int[] columnIndexes)`
`java.sql.PreparedStatement`	`prepareStatement(java.lang.String sql, int resultSetType, int resultSetConcurrency)`
`java.sql.PreparedStatement`	`prepareStatement(java.lang.String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability)`
`java.sql.PreparedStatement`	`prepareStatement(java.lang.String sql, java.lang.String[] columnNames)`
`void`	`releaseSavepoint(java.sql.Savepoint savepoint)`
`void`	`rollback()`
`void`	`rollback(java.sql.Savepoint savepoint)`
`void`	`setAutoCommit(boolean b)`
`void`	`setCatalog(java.lang.String catalog)`
`void`	`setClientInfo(java.util.Properties props)`
`void`	`setClientInfo(java.lang.String key, java.lang.String val)`
`void`	`setHoldability(int holdability)`
`void`	`setReadOnly(boolean readOnly)`
`java.sql.Savepoint`	`setSavepoint()`
`java.sql.Savepoint`	`setSavepoint(java.lang.String name)`
`void`	`setTransactionIsolation(int level)`
`void`	`setTypeMap(java.util.Map map)`
`java.lang.String`	`toString()`
`java.lang.Object`	`unwrap(java.lang.Class iface)`

Methods inherited from class java.lang.Object
`equals, getClass, hashCode, notify, notifyAll, wait, wait, wait`

Constructor Detail