javax.resource.spi.ManagedConnection
| Modifier and Type | Method and Description |
|---|---|
| public Object | Returns: EIS-specific Connection Factory instance or javax.resource.cci.ConnectionFactory instanceConnectionManager to be associated with
created EIS connection factory instance cxManager)Creates a Connection Factory instance. |
| public Object | Returns: EIS-specific Connection Factory instance or javax.resource.cci.ConnectionFactory instanceCreates a Connection Factory instance. |
| public ManagedConnection | Returns: ManagedConnection instanceCaller's security information subject, ConnectionRequestInfo Additional resource adapter specific connection
request information cxRequestInfo)Creates a new physical connection to the underlying EIS resource manager. |
| public boolean | |
| public PrintWriter | |
| public int | Returns: hash code for the ManagedConnectionFactoryReturns the hash code for the ManagedConnectionFactory |
| public ManagedConnection | Returns: ManagedConnection if resource adapter finds an acceptable match otherwise nullcandidate connection set connectionSet, Subject caller's security information subject, ConnectionRequestInfo additional resource adapter specific
connection request information cxRequestInfo)Returns a matched connection from the candidate set of connections. |
| public void | setLogWriter(PrintWriter
PrintWriter - an out stream for
error logging and tracing out)Set the log writer for this ManagedConnectionFactory instance. |
| createConnectionFactory | back to summary |
|---|---|
| public Object createConnectionFactory(ConnectionManager cxManager) throws ResourceException 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.
| |
| createConnectionFactory | back to summary |
|---|---|
| public Object createConnectionFactory() throws ResourceException Creates a Connection Factory instance. The Connection Factory instance gets initialized with a default ConnectionManager provided by the resource adapter.
| |
| createManagedConnection | back to summary |
|---|---|
| public ManagedConnection createManagedConnection(Subject subject, ConnectionRequestInfo cxRequestInfo) throws ResourceException 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.
| |
| equals | back to summary |
|---|---|
| public boolean equals(Object other) Check if this ManagedConnectionFactory is equal to another ManagedConnectionFactory.
| |
| getLogWriter | back to summary |
|---|---|
| public PrintWriter getLogWriter() throws ResourceException 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.
| |
| hashCode | back to summary |
|---|---|
| public int hashCode() Returns the hash code for the ManagedConnectionFactory
| |
| matchManagedConnections | back to summary |
|---|---|
| public ManagedConnection matchManagedConnections(Set<E> connectionSet, Subject subject, ConnectionRequestInfo cxRequestInfo) throws ResourceException 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.
| |
| setLogWriter | back to summary |
|---|---|
| public void setLogWriter(PrintWriter out) throws ResourceException 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.
| |