public interface LazyAssociatableConnectionManager

Version:

1.0

Author:

Ram Jeyaraman

• Method Summary

  All Methods

  Modifier and Type	Method and Description
  void	associateConnection (Object connection, ManagedConnectionFactory mcf, ConnectionRequestInfo cxReqInfo) This method is called by a resource adapter (that is capable of lazy connection association optimization) in order to lazily associate a connection object with a ManagedConnection instance.
  void	inactiveConnectionClosed (Object connection, ManagedConnectionFactory mcf) This method is called by the resource adapter (that is capable of lazy connection association optimization) in order to notify the application server that a disassociated connection handle is closed.

• Method Detail

  • associateConnection

    void associateConnection(Object connection,
     ManagedConnectionFactory mcf,
     ConnectionRequestInfo cxReqInfo)
     throws ResourceException 

    This method is called by a resource adapter (that is capable of lazy connection association optimization) in order to lazily associate a connection object with a ManagedConnection instance.

    Parameters:

    connection - the connection object that is to be associated.

    mcf - The ManagedConnectionFactory instance that was originally used to create the connection object.

    cxReqInfo - connection request information. This information must be the same as that used to originally create the connection object.

    Throws:

    ResourceException - Generic exception.

    ApplicationServerInternalException - Application server specific exception.

    SecurityException - Security related error.

    ResourceAllocationException - Failed to allocate system resources for connection request.

    ResourceAdapterInternalException - Resource adapter related error condition.

  • inactiveConnectionClosed

    void inactiveConnectionClosed(Object connection,
     ManagedConnectionFactory mcf)

    This method is called by the resource adapter (that is capable of lazy connection association optimization) in order to notify the application server that a disassociated connection handle is closed.

    The application server can then perform any cleanup operations related to the disassociated connection handle in its connection pool.

    Parameters:

    connection - the disassociated connection object handle that has been closed

    mcf - The ManagedConnectionFactory instance that was originally used to create the connection object.

    Since:

    1.6