com.sun.gjc.spi

Class ManagedConnectionImpl

java.lang.Object

com.sun.gjc.spi.ManagedConnectionImpl

All Implemented Interfaces:

javax.resource.spi.DissociatableManagedConnection, javax.resource.spi.LazyEnlistableManagedConnection, javax.resource.spi.ManagedConnection

public class ManagedConnectionImpl
extends Object
implements javax.resource.spi.ManagedConnection, javax.resource.spi.LazyEnlistableManagedConnection, javax.resource.spi.DissociatableManagedConnection

ManagedConnection implementation for Generic JDBC Connector.

Version:

1.0, 02/07/22

Author:

Evani Sai Surya Kiran

Field Summary

Fields

Modifier and Type	Field and Description
protected static Logger	_logger
protected Connection	actualConnection
protected javax.resource.spi.ConnectionEvent	ce
protected int	connectionCount
protected Hashtable	connectionHandles
protected int	connectionType
protected boolean	initSqlExecuted
static String	IS_SLOW_SQL_LOGGING_DISABLED
protected boolean	isClean
protected boolean	isDestroyed
static int	ISNOTAPOOLEDCONNECTION
static int	ISPOOLEDCONNECTION
protected boolean	isUsable
static int	ISXACONNECTION
protected int	lastTransactionIsolationLevel
protected StatementLeakDetector	leakDetector
protected javax.resource.spi.ConnectionEventListener	listener
protected static StringManager	localStrings
protected PrintWriter	logWriter
protected ConnectionHolder	myLogicalConnection
protected javax.resource.spi.security.PasswordCredential	passwdCredential
protected PooledConnection	pc
protected boolean	transactionInProgress
protected XAResource	xar

Constructor Summary

Constructors

Constructor and Description
ManagedConnectionImpl(PooledConnection pooledConn, Connection sqlConn, javax.resource.spi.security.PasswordCredential passwdCred, javax.resource.spi.ManagedConnectionFactory mcf, PoolInfo poolInfo, int statementCacheSize, String statementCacheType, SQLTraceDelegator delegator, long statementLeakTimeout, boolean statementLeakReclaim) Constructor for ManagedConnectionImpl.

Method Summary

Modifier and Type	Method and Description
void	addConnectionEventListener(javax.resource.spi.ConnectionEventListener listener) Adds a connection event listener to the ManagedConnectionImpl instance.
void	associateConnection(Object connection) Used by the container to change the association of an application-level connection handle with a ManagedConnectionImpl instance.
void	checkIfActive(ConnectionHolder ch) This method is called by a Connection Handle to check if it is the active Connection Handle.
void	cleanup() Application server calls this method to force any cleanup on the ManagedConnectionImpl instance.
void	connectionClosed(Exception e, ConnectionHolder connHolder30Object) This method is called by the ConnectionHolder30 when its close method is called.
void	decrementCount()
void	destroy() Destroys the physical connection to the underlying resource manager.
void	dissociateConnections()
DatabaseMetaData	getCachedDatabaseMetaData() Returns the cached DatabaseMetaData.
Object	getConnection(Subject sub, javax.resource.spi.ConnectionRequestInfo cxReqInfo) Creates a new connection handle for the underlying physical connection represented by the ManagedConnectionImpl instance.
protected int	getConnectionType(PooledConnection pooledConn) This method determines the type of the connection being held in this ManagedConnectionImpl.
boolean	getLastAutoCommitValue()
StatementLeakDetector	getLeakDetector()
javax.resource.spi.LocalTransaction	getLocalTransaction() Returns an LocalTransactionImpl instance.
PrintWriter	getLogWriter() Gets the log writer for this ManagedConnectionImpl instance.
ManagedConnectionFactoryImpl	getManagedConnectionFactory() Returns the ManagedConnectionFactory instance that created this ManagedConnection instance.
javax.resource.spi.ManagedConnectionFactory	getMcf()
javax.resource.spi.ManagedConnectionMetaData	getMetaData() Gets the metadata information for this connection's underlying EIS resource manager instance.
int	getStatementTimeout()
XAResource	getXAResource() Returns an XAResource instance.
void	incrementCount()
void	initializeConnectionType(int _connectionType) sets the connection type of this connection.
protected void	invalidateAllConnectionHandles() This method removes all the connection handles from the table of connection handles and invalidates all of them so that any operation on those connection handles throws an exception.
boolean	isAborted()
Boolean	isClientInfoSupported()
boolean	isTransactionInProgress() Checks if a this ManagedConnection is involved in a transaction or not.
void	markForRemoval(boolean flag)
CallableStatement	prepareCachedCallableStatement(ConnectionWrapper conWrapper, String sql, int resultSetType, int resultSetConcurrency)
CallableStatement	prepareCachedCallableStatement(ConnectionWrapper conWrapper, String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability)
PreparedStatement	prepareCachedStatement(ConnectionWrapper conWrapper, String sql, int autoGeneratedKeys)
PreparedStatement	prepareCachedStatement(ConnectionWrapper conWrapper, String sql, int[] columnIndexes)
PreparedStatement	prepareCachedStatement(ConnectionWrapper conWrapper, String sql, int resultSetType, int resultSetConcurrency)
PreparedStatement	prepareCachedStatement(ConnectionWrapper conWrapper, String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability)
PreparedStatement	prepareCachedStatement(ConnectionWrapper conWrapper, String sql, String[] columnNames)
void	purgeStatementFromCache(PreparedStatement preparedStatement)
void	removeConnectionEventListener(javax.resource.spi.ConnectionEventListener listener) Removes an already registered connection event listener from the ManagedConnectionImpl instance.
void	setAborted(boolean flag)
void	setClientInfoSupported(Boolean isClientInfoSupported)
void	setLastAutoCommitValue(boolean lastAutoCommitValue) To keep track of last auto commit value.
void	setLastTransactionIsolationLevel(int isolationLevel)
void	setLogWriter(PrintWriter out) Sets the log writer for this ManagedConnectionImpl instance.

Methods inherited from class java.lang.Object

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

Field Detail

ISNOTAPOOLEDCONNECTION

public static final int ISNOTAPOOLEDCONNECTION

See Also:

Constant Field Values

ISPOOLEDCONNECTION

public static final int ISPOOLEDCONNECTION

See Also:

Constant Field Values

ISXACONNECTION

public static final int ISXACONNECTION

See Also:

Constant Field Values

isDestroyed

protected boolean isDestroyed

isUsable

protected boolean isUsable

initSqlExecuted

protected boolean initSqlExecuted

connectionCount

protected int connectionCount

IS_SLOW_SQL_LOGGING_DISABLED

public static final String IS_SLOW_SQL_LOGGING_DISABLED

See Also:

Constant Field Values

connectionType

protected int connectionType

pc

protected PooledConnection pc

actualConnection

protected Connection actualConnection

connectionHandles

protected Hashtable connectionHandles

logWriter

protected PrintWriter logWriter

passwdCredential

protected javax.resource.spi.security.PasswordCredential passwdCredential

xar

protected XAResource xar

myLogicalConnection

protected ConnectionHolder myLogicalConnection

lastTransactionIsolationLevel

protected int lastTransactionIsolationLevel

isClean

protected boolean isClean

transactionInProgress

protected boolean transactionInProgress

listener

protected javax.resource.spi.ConnectionEventListener listener

ce

protected javax.resource.spi.ConnectionEvent ce

leakDetector

protected StatementLeakDetector leakDetector

_logger

protected static final Logger _logger

localStrings

protected static final StringManager localStrings

Constructor Detail

ManagedConnectionImpl

public ManagedConnectionImpl(PooledConnection pooledConn,
                             Connection sqlConn,
                             javax.resource.spi.security.PasswordCredential passwdCred,
                             javax.resource.spi.ManagedConnectionFactory mcf,
                             PoolInfo poolInfo,
                             int statementCacheSize,
                             String statementCacheType,
                             SQLTraceDelegator delegator,
                             long statementLeakTimeout,
                             boolean statementLeakReclaim)
                      throws javax.resource.ResourceException

Constructor for ManagedConnectionImpl. The pooledConn parameter is expected to be null and sqlConn parameter is the actual connection in case where the actual connection is got from a non pooled datasource object. The pooledConn parameter is expected to be non null and sqlConn parameter is expected to be null in the case where the datasource object is a connection pool datasource or an xa datasource.

Parameters:

pooledConn - PooledConnection object in case the physical connection is to be obtained from a pooled DataSource; null otherwise

sqlConn - java.sql.Connection object in case the physical connection is to be obtained from a non pooled DataSource; null otherwise

passwdCred - object conatining the user and password for allocating the connection

Throws:

javax.resource.ResourceException - if the ManagedConnectionFactory object that created this ManagedConnectionImpl object is not the same as returned by PasswordCredential object passed

Method Detail

getLeakDetector

public StatementLeakDetector getLeakDetector()

addConnectionEventListener

public void addConnectionEventListener(javax.resource.spi.ConnectionEventListener listener)

Adds a connection event listener to the ManagedConnectionImpl instance.

Specified by:

addConnectionEventListener in interface javax.resource.spi.ManagedConnection

Parameters:

listener - ConnectionEventListener

See Also:

removeConnectionEventListener(javax.resource.spi.ConnectionEventListener)

associateConnection

public void associateConnection(Object connection)
                         throws javax.resource.ResourceException

Used by the container to change the association of an application-level connection handle with a ManagedConnectionImpl instance.

Specified by:

associateConnection in interface javax.resource.spi.ManagedConnection

Parameters:

connection - ConnectionHolder30 to be associated with this ManagedConnectionImpl instance

Throws:

javax.resource.ResourceException - if the physical connection is no more valid or the connection handle passed is null

cleanup

public void cleanup()
             throws javax.resource.ResourceException

Application server calls this method to force any cleanup on the ManagedConnectionImpl instance. This method calls the invalidate method on all ConnectionHandles associated with this ManagedConnectionImpl.

Specified by:

cleanup in interface javax.resource.spi.ManagedConnection

Throws:

javax.resource.ResourceException - if the physical connection is no more valid

invalidateAllConnectionHandles

protected void invalidateAllConnectionHandles()
                                       throws javax.resource.ResourceException

This method removes all the connection handles from the table of connection handles and invalidates all of them so that any operation on those connection handles throws an exception.

Throws:

javax.resource.ResourceException - if there is a problem in retrieving the connection handles

destroy

public void destroy()
             throws javax.resource.ResourceException

Destroys the physical connection to the underlying resource manager.

Specified by:

destroy in interface javax.resource.spi.ManagedConnection

Throws:

javax.resource.ResourceException - if there is an error in closing the physical connection

getConnection

public Object getConnection(Subject sub,
                            javax.resource.spi.ConnectionRequestInfo cxReqInfo)
                     throws javax.resource.ResourceException

Creates a new connection handle for the underlying physical connection represented by the ManagedConnectionImpl instance.

Specified by:

getConnection in interface javax.resource.spi.ManagedConnection

Parameters:

sub - Subject parameter needed for authentication

cxReqInfo - ConnectionRequestInfo carries the user and password required for getting this connection.

Returns:

Connection the connection handle Object

Throws:

javax.resource.ResourceException - if there is an error in allocating the physical connection from the pooled connection

javax.resource.spi.SecurityException - if there is a mismatch between the password credentials or reauthentication is requested

getLocalTransaction

public javax.resource.spi.LocalTransaction getLocalTransaction()
                                                        throws javax.resource.ResourceException

Returns an LocalTransactionImpl instance. The LocalTransactionImpl interface is used by the container to manage local transactions for a RM instance.

Specified by:

getLocalTransaction in interface javax.resource.spi.ManagedConnection

Returns:

LocalTransactionImpl instance

Throws:

javax.resource.ResourceException - if the physical connection is not valid

getLogWriter

public PrintWriter getLogWriter()
                         throws javax.resource.ResourceException

Gets the log writer for this ManagedConnectionImpl instance.

Specified by:

getLogWriter in interface javax.resource.spi.ManagedConnection

Returns:

PrintWriter instance associated with this ManagedConnectionImpl instance

Throws:

javax.resource.ResourceException - if the physical connection is not valid

See Also:

setLogWriter

getMetaData

public javax.resource.spi.ManagedConnectionMetaData getMetaData()
                                                         throws javax.resource.ResourceException

Gets the metadata information for this connection's underlying EIS resource manager instance.

Specified by:

getMetaData in interface javax.resource.spi.ManagedConnection

Returns:

ManagedConnectionMetaData instance

Throws:

javax.resource.ResourceException - if the physical connection is not valid

getXAResource

public XAResource getXAResource()
                         throws javax.resource.ResourceException

Returns an XAResource instance.

Specified by:

getXAResource in interface javax.resource.spi.ManagedConnection

Returns:

XAResource instance

Throws:

javax.resource.ResourceException - if the physical connection is not valid or there is an error in allocating the XAResource instance

javax.resource.NotSupportedException - if underlying datasource is not an XADataSource

removeConnectionEventListener

public void removeConnectionEventListener(javax.resource.spi.ConnectionEventListener listener)

Removes an already registered connection event listener from the ManagedConnectionImpl instance.

Specified by:

removeConnectionEventListener in interface javax.resource.spi.ManagedConnection

Parameters:

listener - ConnectionEventListener to be removed

See Also:

addConnectionEventListener(javax.resource.spi.ConnectionEventListener)

isTransactionInProgress

public boolean isTransactionInProgress()

Checks if a this ManagedConnection is involved in a transaction or not.

setLogWriter

public void setLogWriter(PrintWriter out)
                  throws javax.resource.ResourceException

Sets the log writer for this ManagedConnectionImpl instance.

Specified by:

setLogWriter in interface javax.resource.spi.ManagedConnection

Parameters:

out - PrintWriter to be associated with this ManagedConnectionImpl instance

Throws:

javax.resource.ResourceException - if the physical connection is not valid

See Also:

getLogWriter

getConnectionType

protected int getConnectionType(PooledConnection pooledConn)

This method determines the type of the connection being held in this ManagedConnectionImpl.

Parameters:

pooledConn - PooledConnection

Returns:

connection type

getManagedConnectionFactory

public ManagedConnectionFactoryImpl getManagedConnectionFactory()

Returns the ManagedConnectionFactory instance that created this ManagedConnection instance.

Returns:

ManagedConnectionFactory instance that created this ManagedConnection instance

connectionClosed

public void connectionClosed(Exception e,
                             ConnectionHolder connHolder30Object)
                      throws SQLException

This method is called by the ConnectionHolder30 when its close method is called. This ManagedConnection instance invalidates the connection handle and sends a CONNECTION_CLOSED event to all the registered event listeners.

Parameters:

e - Exception that may have occured while closing the connection handle

connHolder30Object - ConnectionHolder30 that has been closed

Throws:

SQLException - in case closing the sql connection got out of getConnection on the underlying PooledConnection throws an exception

checkIfActive

public void checkIfActive(ConnectionHolder ch)
                   throws SQLException

This method is called by a Connection Handle to check if it is the active Connection Handle. If it is not the active Connection Handle, this method throws an SQLException. Else, it returns setting the active Connection Handle to the calling Connection Handle object to this object if the active Connection Handle is null.

Parameters:

ch - ConnectionHolder30 that requests this ManagedConnection instance whether it can be active or not

Throws:

SQLException - in case the physical is not valid or there is already an active connection handle

initializeConnectionType

public void initializeConnectionType(int _connectionType)

sets the connection type of this connection. This method is called by the MCF while creating this ManagedConnection. Saves us a costly instanceof operation in the getConnectionType

incrementCount

public void incrementCount()

decrementCount

public void decrementCount()

dissociateConnections

public void dissociateConnections()

Specified by:

dissociateConnections in interface javax.resource.spi.DissociatableManagedConnection

getLastAutoCommitValue

public boolean getLastAutoCommitValue()

setLastAutoCommitValue

public void setLastAutoCommitValue(boolean lastAutoCommitValue)

To keep track of last auto commit value. Helps to reset the auto-commit-value while giving new connection-handle.

Parameters:

lastAutoCommitValue -

markForRemoval

public void markForRemoval(boolean flag)

getMcf

public javax.resource.spi.ManagedConnectionFactory getMcf()

getStatementTimeout

public int getStatementTimeout()

setLastTransactionIsolationLevel

public void setLastTransactionIsolationLevel(int isolationLevel)

getCachedDatabaseMetaData

public DatabaseMetaData getCachedDatabaseMetaData()
                                           throws javax.resource.ResourceException

Returns the cached DatabaseMetaData.

Returns:

DatabaseMetaData

Throws:

javax.resource.ResourceException

isClientInfoSupported

public Boolean isClientInfoSupported()

setClientInfoSupported

public void setClientInfoSupported(Boolean isClientInfoSupported)

prepareCachedStatement

public PreparedStatement prepareCachedStatement(ConnectionWrapper conWrapper,
                                                String sql,
                                                int resultSetType,
                                                int resultSetConcurrency)
                                         throws SQLException

Throws:

SQLException

prepareCachedStatement

public PreparedStatement prepareCachedStatement(ConnectionWrapper conWrapper,
                                                String sql,
                                                int resultSetType,
                                                int resultSetConcurrency,
                                                int resultSetHoldability)
                                         throws SQLException

Throws:

SQLException

prepareCachedStatement

public PreparedStatement prepareCachedStatement(ConnectionWrapper conWrapper,
                                                String sql,
                                                String[] columnNames)
                                         throws SQLException

Throws:

SQLException

prepareCachedStatement

public PreparedStatement prepareCachedStatement(ConnectionWrapper conWrapper,
                                                String sql,
                                                int[] columnIndexes)
                                         throws SQLException

Throws:

SQLException

prepareCachedStatement

public PreparedStatement prepareCachedStatement(ConnectionWrapper conWrapper,
                                                String sql,
                                                int autoGeneratedKeys)
                                         throws SQLException

Throws:

SQLException

prepareCachedCallableStatement

public CallableStatement prepareCachedCallableStatement(ConnectionWrapper conWrapper,
                                                        String sql,
                                                        int resultSetType,
                                                        int resultSetConcurrency)
                                                 throws SQLException

Throws:

SQLException

prepareCachedCallableStatement

public CallableStatement prepareCachedCallableStatement(ConnectionWrapper conWrapper,
                                                        String sql,
                                                        int resultSetType,
                                                        int resultSetConcurrency,
                                                        int resultSetHoldability)
                                                 throws SQLException

Throws:

SQLException

setAborted

public void setAborted(boolean flag)

isAborted

public boolean isAborted()

purgeStatementFromCache

public void purgeStatementFromCache(PreparedStatement preparedStatement)