LazyAssociatableConnectionManager (Java 2 Platform Ent. Ed. v1.4) - Java Platform, Enterprise Edition v1.4 API Specifications

Overview

Package

Class

Tree

Deprecated

Index

Help

Java^TM 2 Platform
Ent. Ed. v1.4

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

javax.resource.spi
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.

Version:: 1.0
Author:: Ram Jeyaraman

Method Summary

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.

Method Detail

associateConnection

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