public ConnectionHolder(ConnectionHandle connectionHandle) 
{
	              	 
		Assert.notNull(connectionHandle, "ConnectionHandle must not be null");
		this.connectionHandle = connectionHandle;
}

Create a new ConnectionHolder for the given ConnectionHandle.

Parameters:

connectionHandle - the ConnectionHandle to hold

 public ConnectionHolder(Connection connection) 
{
		this.connectionHandle = new SimpleConnectionHandle(connection);
}

Create a new ConnectionHolder for the given JDBC Connection, wrapping it with a SimpleConnectionHandle , assuming that there is no ongoing transaction.

Parameters:

connection - the JDBC Connection to hold

Also see:

SimpleConnectionHandle
ConnectionHolder(java.sql.Connection, boolean)

 public ConnectionHolder(Connection connection,
    boolean transactionActive) 
{
		this(connection);
		this.transactionActive = transactionActive;
}

Create a new ConnectionHolder for the given JDBC Connection, wrapping it with a SimpleConnectionHandle .

Parameters:

connection - the JDBC Connection to hold

transactionActive - whether the given Connection is involved in an ongoing transaction

Also see:

SimpleConnectionHandle

 public  void clear() 
{
		super.clear();
		this.transactionActive = false;
		this.savepointsSupported = null;
		this.savepointCounter = 0;
}

 public Savepoint createSavepoint() throws SQLException 
{
		this.savepointCounter++;
		return getConnection().setSavepoint(SAVEPOINT_NAME_PREFIX + this.savepointCounter);
}

Create a new JDBC 3.0 Savepoint for the current Connection, using generated savepoint names that are unique for the Connection.

 public Connection getConnection() 
{
		Assert.notNull(this.connectionHandle, "Active Connection is required");
		if (this.currentConnection == null) {
			this.currentConnection = this.connectionHandle.getConnection();
		}
		return this.currentConnection;
}

Return the current Connection held by this ConnectionHolder.

This will be the same Connection until released gets called on the ConnectionHolder, which will reset the held Connection, fetching a new Connection on demand.

 public ConnectionHandle getConnectionHandle() 
{
		return this.connectionHandle;
}

Return the ConnectionHandle held by this ConnectionHolder.

 protected boolean hasConnection() 
{
		return (this.connectionHandle != null);
}

Return whether this holder currently has a Connection.

 protected boolean isTransactionActive() 
{
		return this.transactionActive;
}

Return whether this holder represents an active, JDBC-managed transaction.

 public  void released() 
{
		super.released();
		if (this.currentConnection != null) {
			this.connectionHandle.releaseConnection(this.currentConnection);
			this.currentConnection = null;
		}
}

Releases the current Connection held by this ConnectionHolder.

This is necessary for ConnectionHandles that expect "Connection borrowing", where each returned Connection is only temporarily leased and needs to be returned once the data operation is done, to make the Connection available for other operations within the same transaction. This is the case with JDO 2.0 DataStoreConnections, for example.

 protected  void setConnection(Connection connection) 
{
		if (this.currentConnection != null) {
			this.connectionHandle.releaseConnection(this.currentConnection);
			this.currentConnection = null;
		}
		if (connection != null) {
			this.connectionHandle = new SimpleConnectionHandle(connection);
		}
		else {
			this.connectionHandle = null;
		}
}

Override the existing Connection handle with the given Connection. Reset the handle if given null.

Used for releasing the Connection on suspend (with a null argument) and setting a fresh Connection on resume.

 protected  void setTransactionActive(boolean transactionActive) 
{
		this.transactionActive = transactionActive;
}

Set whether this holder represents an active, JDBC-managed transaction.

 public boolean supportsSavepoints() throws SQLException 
{
		if (this.savepointsSupported == null) {
			this.savepointsSupported = new Boolean(getConnection().getMetaData().supportsSavepoints());
		}
		return this.savepointsSupported.booleanValue();
}

Return whether JDBC 3.0 Savepoints are supported. Caches the flag for the lifetime of this ConnectionHolder.