Package org.ow2.joram.jakarta.connector

Class DefaultConnectionManager

java.lang.Object

org.ow2.joram.jakarta.connector.DefaultConnectionManager

All Implemented Interfaces:

jakarta.resource.spi.ConnectionManager, Serializable

public class DefaultConnectionManager
extends Object
implements jakarta.resource.spi.ConnectionManager, Serializable

The DefaultConnectionManager class is the default connection manager provided with JORAM resource adapter, which intercepts connections requests coming from non managed client applications. 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 ConnectionManagerinterface. 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 ConnectionManagerimplementation 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.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
private static boolean	DEBUG
private static Logger	logger
private static DefaultConnectionManager	ref	Static reference to the local DefaultConnectionManager instance.
private static long	serialVersionUID	Define serialVersionUID for interoperability.

Constructor Summary

Constructors

Constructor	Description
DefaultConnectionManager()	Creates a DefaultConnectionManager instance.

Method Summary

Modifier and Type	Method	Description
Object	allocateConnection(jakarta.resource.spi.ManagedConnectionFactory mcf, jakarta.resource.spi.ConnectionRequestInfo cxRequest)	Returns a Connection connection instance for a non managed application.
(package private) static DefaultConnectionManager	getRef()	Returns the reference to the DefaultConnectionManager instance, creates it if needed.
private void	setFactoryParameters(AbstractConnectionFactory factory, ManagedConnectionFactoryImpl mcf)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

serialVersionUID

private static final long serialVersionUID

Define serialVersionUID for interoperability.

See Also:

Constant Field Values

logger

private static final Logger logger

DEBUG

private static final boolean DEBUG

ref

private static DefaultConnectionManager ref

Static reference to the local DefaultConnectionManager instance.

Constructor Detail

DefaultConnectionManager

public DefaultConnectionManager()

Creates a DefaultConnectionManager instance.

Method Detail

setFactoryParameters

private void setFactoryParameters(AbstractConnectionFactory factory,
                                  ManagedConnectionFactoryImpl mcf)

getRef

static DefaultConnectionManager getRef()

Returns the reference to the DefaultConnectionManager instance, creates it if needed.

allocateConnection

public Object allocateConnection(jakarta.resource.spi.ManagedConnectionFactory mcf,
                                 jakarta.resource.spi.ConnectionRequestInfo cxRequest)
                          throws jakarta.resource.ResourceException

Returns a Connection connection instance for a non managed application.

Specified by:

allocateConnection in interface jakarta.resource.spi.ConnectionManager

Throws:

jakarta.resource.spi.CommException - If connecting fails.

jakarta.resource.spi.SecurityException - If connecting is not authorized.

jakarta.resource.ResourceException - Generic exception.