Interface LazyAssociatableConnectionManager


public interface LazyAssociatableConnectionManager
This is a mix-in interface that may be optionally implemented by a ConnectionManager implementation. An implementation of this interface must support the lazy connection association optimization.
  • Method Summary

    Modifier and Type
    Method
    Description
    void
    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
    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 Details

    • 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