File	Doc	Category	Size	Date	Package
ManagedConnectionFactory.java	API Doc	Glassfish v2 API	9314	Fri May 04 22:35:36 BST 2007	javax.resource.spi

ManagedConnectionFactory

Fields Summary

Constructors Summary

Methods Summary
public java.lang.Object	createConnectionFactory(ConnectionManager cxManager) Creates a Connection Factory instance. The Connection Factory instance gets initialized with the passed ConnectionManager. In the managed scenario, ConnectionManager is provided by the application server. param cxManager ConnectionManager to be associated with created EIS connection factory instance return EIS-specific Connection Factory instance or javax.resource.cci.ConnectionFactory instance throws ResourceException Generic exception throws ResourceAdapterInternalException Resource adapter related error condition
public java.lang.Object	createConnectionFactory() Creates a Connection Factory instance. The Connection Factory instance gets initialized with a default ConnectionManager provided by the resource adapter. return EIS-specific Connection Factory instance or javax.resource.cci.ConnectionFactory instance throws ResourceException Generic exception throws ResourceAdapterInternalException Resource adapter related error condition
public ManagedConnection	createManagedConnection(javax.security.auth.Subject subject, ConnectionRequestInfo cxRequestInfo) Creates a new physical connection to the underlying EIS resource manager. ManagedConnectionFactory uses the security information (passed as Subject) and additional ConnectionRequestInfo (which is specific to ResourceAdapter and opaque to application server) to create this new connection. param subject Caller's security information param cxRequestInfo Additional resource adapter specific connection request information throws ResourceException generic exception throws SecurityException security related error throws ResourceAllocationException failed to allocate system resources for connection request throws ResourceAdapterInternalException resource adapter related error condition throws EISSystemException internal error condition in EIS instance return ManagedConnection instance
public boolean	equals(java.lang.Object other) Check if this ManagedConnectionFactory is equal to another ManagedConnectionFactory. return true if two instances are equal
public java.io.PrintWriter	getLogWriter() Get the log writer for this ManagedConnectionFactory instance. The log writer is a character output stream to which all logging and tracing messages for this ManagedConnectionFactory instance will be printed ApplicationServer manages the association of output stream with the ManagedConnectionFactory. When a ManagedConnectionFactory object is created the log writer is initially null, in other words, logging is disabled. return PrintWriter throws ResourceException generic exception
public int	hashCode() Returns the hash code for the ManagedConnectionFactory return hash code for the ManagedConnectionFactory
public ManagedConnection	matchManagedConnections(java.util.Set connectionSet, javax.security.auth.Subject subject, ConnectionRequestInfo cxRequestInfo) Returns a matched connection from the candidate set of connections. ManagedConnectionFactory uses the security info (as in Subject) and information provided through ConnectionRequestInfo and additional Resource Adapter specific criteria to do matching. Note that criteria used for matching is specific to a resource adapter and is not prescribed by the Connector specification. This method returns a ManagedConnection instance that is the best match for handling the connection allocation request. param connectionSet candidate connection set param subject caller's security information param cxRequestInfo additional resource adapter specific connection request information throws ResourceException generic exception throws SecurityException security related error throws ResourceAdapterInternalException resource adapter related error condition throws NotSupportedException if operation is not supported return ManagedConnection if resource adapter finds an acceptable match otherwise null
public void	setLogWriter(java.io.PrintWriter out) Set the log writer for this ManagedConnectionFactory instance. The log writer is a character output stream to which all logging and tracing messages for this ManagedConnectionfactory instance will be printed. ApplicationServer manages the association of output stream with the ManagedConnectionFactory. When a ManagedConnectionFactory object is created the log writer is initially null, in other words, logging is disabled. Once a log writer is associated with a ManagedConnectionFactory, logging and tracing for ManagedConnectionFactory instance is enabled. The ManagedConnection instances created by ManagedConnectionFactory "inherits" the log writer, which can be overridden by ApplicationServer using ManagedConnection.setLogWriter to set ManagedConnection specific logging and tracing. param out PrintWriter - an out stream for error logging and tracing throws ResourceException generic exception throws ResourceAdapterInternalException resource adapter related error condition