Class ConnectionImpl

java.lang.Object

org.datanucleus.store.rdbms.datasource.dbcp2.AbandonedTrace

org.datanucleus.store.rdbms.datasource.dbcp2.DelegatingConnection<Connection>

org.datanucleus.store.rdbms.datasource.dbcp2.cpdsadapter.ConnectionImpl

All Implemented Interfaces:

AutoCloseable, Connection, Wrapper, TrackedUse

class ConnectionImpl
extends DelegatingConnection<Connection>

This class is the Connection that will be returned from PooledConnectionImpl.getConnection(). Most methods are wrappers around the JDBC 1.x Connection. A few exceptions include preparedStatement and close. In accordance with the JDBC specification this Connection cannot be used after closed() is called. Any further usage will result in an SQLException.

ConnectionImpl extends DelegatingConnection to enable access to the underlying connection.

Since:

2.0

Field Summary

Fields

Modifier and Type	Field	Description
private final boolean	accessToUnderlyingConnectionAllowed
private final PooledConnectionImpl	pooledConnection	The object that instantiated this object

Fields inherited from interface Connection

TRANSACTION_NONE, TRANSACTION_READ_COMMITTED, TRANSACTION_READ_UNCOMMITTED, TRANSACTION_REPEATABLE_READ, TRANSACTION_SERIALIZABLE

Constructor Summary

Constructors

Constructor	Description
ConnectionImpl(PooledConnectionImpl pooledConnection, Connection connection, boolean accessToUnderlyingConnectionAllowed)	Creates a ConnectionImpl.

Method Summary

Modifier and Type	Method	Description
void	close()	Marks the Connection as closed, and notifies the pool that the pooled connection is available.
Connection	getDelegate()	Get the delegated connection, if allowed.
Connection	getInnermostDelegate()	Get the innermost connection, if allowed.
boolean	isAccessToUnderlyingConnectionAllowed()	If false, getDelegate() and getInnermostDelegate() will return null.
CallableStatement	prepareCall(String sql)	If pooling of CallableStatements is turned on in the DriverAdapterCPDS, a pooled object may be returned, otherwise delegate to the wrapped JDBC 1.x Connection.
CallableStatement	prepareCall(String sql, int resultSetType, int resultSetConcurrency)	If pooling of CallableStatements is turned on in the DriverAdapterCPDS, a pooled object may be returned, otherwise delegate to the wrapped JDBC 1.x Connection.
CallableStatement	prepareCall(String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability)	If pooling of CallableStatements is turned on in the DriverAdapterCPDS, a pooled object may be returned, otherwise delegate to the wrapped JDBC 1.x Connection.
PreparedStatement	prepareStatement(String sql)	If pooling of PreparedStatements is turned on in the DriverAdapterCPDS, a pooled object may be returned, otherwise delegate to the wrapped JDBC 1.x Connection.
PreparedStatement	prepareStatement(String sql, int autoGeneratedKeys)
PreparedStatement	prepareStatement(String sql, int[] columnIndexes)
PreparedStatement	prepareStatement(String sql, int resultSetType, int resultSetConcurrency)	If pooling of PreparedStatements is turned on in the DriverAdapterCPDS, a pooled object may be returned, otherwise delegate to the wrapped JDBC 1.x Connection.
PreparedStatement	prepareStatement(String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability)
PreparedStatement	prepareStatement(String sql, String[] columnNames)

Methods inherited from class DelegatingConnection

abort, activate, checkOpen, clearCachedState, clearWarnings, closeInternal, commit, createArrayOf, createBlob, createClob, createNClob, createSQLXML, createStatement, createStatement, createStatement, createStruct, getAutoCommit, getCacheState, getCatalog, getClientInfo, getClientInfo, getDefaultQueryTimeout, getDelegateInternal, getHoldability, getInnermostDelegateInternal, getMetaData, getNetworkTimeout, getSchema, getTransactionIsolation, getTypeMap, getWarnings, handleException, handleExceptionNoThrow, innermostDelegateEquals, isClosed, isClosedInternal, isReadOnly, isValid, isWrapperFor, nativeSQL, passivate, releaseSavepoint, rollback, rollback, setAutoCommit, setCacheState, setCatalog, setClientInfo, setClientInfo, setClosedInternal, setDefaultQueryTimeout, setDelegate, setHoldability, setNetworkTimeout, setReadOnly, setSavepoint, setSavepoint, setSchema, setTransactionIsolation, setTypeMap, toString, unwrap

Methods inherited from class AbandonedTrace

addTrace, clearTrace, getLastUsed, getTrace, removeThisTrace, removeTrace, setLastUsed, setLastUsed

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface Connection

beginRequest, endRequest, setShardingKey, setShardingKey, setShardingKeyIfValid, setShardingKeyIfValid

Field Details

accessToUnderlyingConnectionAllowed

private final boolean accessToUnderlyingConnectionAllowed

pooledConnection

private final PooledConnectionImpl pooledConnection

The object that instantiated this object

Constructor Details

ConnectionImpl

ConnectionImpl(PooledConnectionImpl pooledConnection,
 Connection connection,
 boolean accessToUnderlyingConnectionAllowed)

Creates a ConnectionImpl.

Parameters:

pooledConnection - The PooledConnection that is calling the ctor.

connection - The JDBC 1.x Connection to wrap.

accessToUnderlyingConnectionAllowed - if true, then access is allowed to the underlying connection

Method Details

close

public void close()
           throws SQLException

Marks the Connection as closed, and notifies the pool that the pooled connection is available.

In accordance with the JDBC specification this Connection cannot be used after closed() is called. Any further usage will result in an SQLException.

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Connection

Overrides:

close in class DelegatingConnection<Connection>

Throws:

SQLException - The database connection couldn't be closed.

prepareCall

public CallableStatement prepareCall(String sql)
                              throws SQLException

If pooling of CallableStatements is turned on in the DriverAdapterCPDS, a pooled object may be returned, otherwise delegate to the wrapped JDBC 1.x Connection.

Specified by:

prepareCall in interface Connection

Overrides:

prepareCall in class DelegatingConnection<Connection>

Parameters:

sql - an SQL statement that may contain one or more '?' parameter placeholders. Typically this statement is specified using JDBC call escape syntax.

Returns:

a default CallableStatement object containing the pre-compiled SQL statement.

Throws:

SQLException - Thrown if a database access error occurs or this method is called on a closed connection.

Since:

2.4.0

prepareCall

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

If pooling of CallableStatements is turned on in the DriverAdapterCPDS, a pooled object may be returned, otherwise delegate to the wrapped JDBC 1.x Connection.

Specified by:

prepareCall in interface Connection

Overrides:

prepareCall in class DelegatingConnection<Connection>

Parameters:

sql - a String object that is the SQL statement to be sent to the database; may contain on or more '?' parameters.

resultSetType - a result set type; one of ResultSet.TYPE_FORWARD_ONLY, ResultSet.TYPE_SCROLL_INSENSITIVE, or ResultSet.TYPE_SCROLL_SENSITIVE.

resultSetConcurrency - a concurrency type; one of ResultSet.CONCUR_READ_ONLY or ResultSet.CONCUR_UPDATABLE.

Returns:

a CallableStatement object containing the pre-compiled SQL statement that will produce ResultSet objects with the given type and concurrency.

Throws:

SQLException - Thrown if a database access error occurs, this method is called on a closed connection or the given parameters are not ResultSet constants indicating type and concurrency.

Since:

2.4.0

prepareCall

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

If pooling of CallableStatements is turned on in the DriverAdapterCPDS, a pooled object may be returned, otherwise delegate to the wrapped JDBC 1.x Connection.

Specified by:

prepareCall in interface Connection

Overrides:

prepareCall in class DelegatingConnection<Connection>

Parameters:

sql - a String object that is the SQL statement to be sent to the database; may contain on or more '?' parameters.

resultSetType - one of the following ResultSet constants: ResultSet.TYPE_FORWARD_ONLY, ResultSet.TYPE_SCROLL_INSENSITIVE, or ResultSet.TYPE_SCROLL_SENSITIVE.

resultSetConcurrency - one of the following ResultSet constants: ResultSet.CONCUR_READ_ONLY or ResultSet.CONCUR_UPDATABLE.

resultSetHoldability - one of the following ResultSet constants: ResultSet.HOLD_CURSORS_OVER_COMMIT or ResultSet.CLOSE_CURSORS_AT_COMMIT.

Returns:

a new CallableStatement object, containing the pre-compiled SQL statement, that will generate ResultSet objects with the given type, concurrency, and holdability.

Throws:

SQLException - Thrown if a database access error occurs, this method is called on a closed connection or the given parameters are not ResultSet constants indicating type, concurrency, and holdability.

Since:

2.4.0

prepareStatement

public PreparedStatement prepareStatement(String sql)
                                   throws SQLException

If pooling of PreparedStatements is turned on in the DriverAdapterCPDS, a pooled object may be returned, otherwise delegate to the wrapped JDBC 1.x Connection.

Specified by:

prepareStatement in interface Connection

Overrides:

prepareStatement in class DelegatingConnection<Connection>

Parameters:

sql - SQL statement to be prepared

Returns:

the prepared statement

Throws:

SQLException - if this connection is closed or an error occurs in the wrapped connection.

prepareStatement

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

If pooling of PreparedStatements is turned on in the DriverAdapterCPDS, a pooled object may be returned, otherwise delegate to the wrapped JDBC 1.x Connection.

Specified by:

prepareStatement in interface Connection

Overrides:

prepareStatement in class DelegatingConnection<Connection>

Throws:

SQLException - if this connection is closed or an error occurs in the wrapped connection.

prepareStatement

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

Specified by:

prepareStatement in interface Connection

Overrides:

prepareStatement in class DelegatingConnection<Connection>

Throws:

SQLException

prepareStatement

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

Specified by:

prepareStatement in interface Connection

Overrides:

prepareStatement in class DelegatingConnection<Connection>

Throws:

SQLException

prepareStatement

public PreparedStatement prepareStatement(String sql,
 int[] columnIndexes)
                                   throws SQLException

Specified by:

prepareStatement in interface Connection

Overrides:

prepareStatement in class DelegatingConnection<Connection>

Throws:

SQLException

prepareStatement

public PreparedStatement prepareStatement(String sql,
 String[] columnNames)
                                   throws SQLException

Specified by:

prepareStatement in interface Connection

Overrides:

prepareStatement in class DelegatingConnection<Connection>

Throws:

SQLException

isAccessToUnderlyingConnectionAllowed

public boolean isAccessToUnderlyingConnectionAllowed()

If false, getDelegate() and getInnermostDelegate() will return null.

Returns:

true if access is allowed to the underlying connection

See Also:

• ConnectionImpl

getDelegate

public Connection getDelegate()

Get the delegated connection, if allowed.

Overrides:

getDelegate in class DelegatingConnection<Connection>

Returns:

the internal connection, or null if access is not allowed.

See Also:

• isAccessToUnderlyingConnectionAllowed()

getInnermostDelegate

public Connection getInnermostDelegate()

Get the innermost connection, if allowed.

Overrides:

getInnermostDelegate in class DelegatingConnection<Connection>

Returns:

the innermost internal connection, or null if access is not allowed.

See Also:

• isAccessToUnderlyingConnectionAllowed()