IBM WebSphere Application ServerTM
Release 7

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.

public interface ConnectionManager
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
 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.
 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

void associateConnection(javax.resource.spi.ManagedConnectionFactory mcf,
                         javax.security.auth.Subject subject,
                         javax.resource.spi.ConnectionRequestInfo cri,
                         java.lang.Object connection)
                         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

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.

IBM WebSphere Application ServerTM
Release 7