ConnectionManager (Java EE 5 SDK)

Java

Java EE 5 SDK

深圳电信培训中心.徐海蛟老师.


javax.resource.spi Interface ConnectionManager

所有父接口:
Serializable

public interface ConnectionManager
extends Serializable

ConnectionManager interface provides a hook for the resource adapter to pass a connection request to the application server.

An application server provides implementation of the ConnectionManager interface. This implementation is not specific to any particular type of the resource adapter or connection factory interface.

The ConnectionManager implementation delegates to the application server to enable latter to provide quality of services (QoS) - security, connection pool management, transaction management and error logging/tracing.

An application server implements these services in a generic manner, independent of any resource adapter and EIS specific mechanisms. The connector architecture does not specify how an application server implements these services; the implementation is specific to an application server.

After an application server hooks-in its services, the connection request gets delegated to a ManagedConnectionFactory instance either for the creation of a new physical connection or for the matching of an already existing physical connection.

An implementation class for ConnectionManager interface is required to implement the java.io.Serializable interface.

In the non-managed application scenario, the ConnectionManager implementation class can be provided either by a resource adapter (as a default ConnectionManager implementation) or by application developers. In both cases, QOS can be provided as components by third party vendors.

从以下版本开始:
0.6
作者:
Rahul Sharma
另请参见:
ManagedConnectionFactory

方法摘要
 Object allocateConnection(ManagedConnectionFactory mcf, ConnectionRequestInfo cxRequestInfo)
          The method allocateConnection gets called by the resource adapter's connection factory instance.
 

方法详细信息

allocateConnection

Object allocateConnection(ManagedConnectionFactory mcf,
                          ConnectionRequestInfo cxRequestInfo)
                          throws ResourceException

The method allocateConnection gets called by the resource adapter's connection factory instance. This lets connection factory instance (provided by the resource adapter) pass a connection request to the ConnectionManager instance.

The connectionRequestInfo parameter represents information specific to the resource adapter for handling of the connection request.

参数:
mcf - used by application server to delegate connection matching/creation
cxRequestInfo - connection request Information
返回:
connection handle with an EIS specific connection interface.
抛出异常:
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

Java EE 5 SDK

深圳电信培训中心.徐海蛟老师.


提交错误或意见

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。深圳电信培训中心.徐海蛟老师教学参考.