com.ibm.websphere.j2c

Interface ConnectionManager

All Superinterfaces:
javax.resource.spi.ConnectionManager, java.io.Serializable

Deprecated. As of WAS 6.0, the functionality of this interface is replaced by J2EE Connector Architecture 1.5. Please reference javax.resource.spi.LazyAssociatableConnectionManager.
  1. public interface ConnectionManager
  2. extends javax.resource.spi.ConnectionManager
This ConnectionManager interface provides support for inactive connection handles ("Smart Handles"). SmartHandles reduce the overhead incurred when the Application Server manages the Connection Handles, by allowing the ResourceAdapter to determine when a ConnectionHandle should be associated with a ManagedConnection. The ResourceAdapter will have to manage the state of the Connection (active or inactive).
See Also:
JCAPaper

Method Summary

Modifier and Type Method and Description
  1. void
associateConnection(javax.resource.spi.ManagedConnectionFactory mcf,javax.security.auth.Subject subject,javax.resource.spi.ConnectionRequestInfo cri,java.lang.Object connection)
Deprecated. AssociateConnection should be called by the ResourceAdapter before any work is done on an inactive Connection.
  1. void
inactiveConnectionClosed(java.lang.Object connection)
Deprecated. Method inactiveConnectionClosed is called by the ResourceAdapter when an inactiveConnection is closed.
Methods inherited from interface javax.resource.spi.ConnectionManager
allocateConnection

Method Detail

associateConnection

  1. void associateConnection(javax.resource.spi.ManagedConnectionFactory mcf,
  2. javax.security.auth.Subject subject,
  3. javax.resource.spi.ConnectionRequestInfo cri,
  4. java.lang.Object connection)
  5. throws javax.resource.ResourceException
Deprecated.
AssociateConnection should be called by the ResourceAdapter before any work is done on an inactive Connection.
Parameters:
mcf - The ManagedConnectionFactory that may be used to create a new ManagedConnection (usually one will be found in the pool).
subject - The Subject for this connection.
cri - The connection request specific info (this may include UserName & Password).
connection - The Connection handle that should be associated with a valid ManagedConnection.
Throws:
javax.resource.ResourceException

inactiveConnectionClosed

  1. void inactiveConnectionClosed(java.lang.Object connection)
Deprecated.
Method inactiveConnectionClosed is called by the ResourceAdapter when an inactiveConnection is closed. This is necessary because no ManagedConnection instance is associated with an inactive handle, so you cannot call the ConnectionClosed event on the associated ConnectionEventListener.
Parameters:
connection - The Connection handle that was closed.