public interface ManagedConnectionFactory extends Serializable
ManagedConnection
Modifier and Type | Method and Description |
---|---|
Object |
createConnectionFactory()
Creates a Connection Factory instance.
|
Object |
createConnectionFactory(ConnectionManager cxManager)
Creates a Connection Factory instance.
|
ManagedConnection |
createManagedConnection(Subject subject,
ConnectionRequestInfo cxRequestInfo)
Creates a new physical connection to the underlying EIS
resource manager.
|
boolean |
equals(Object other)
Check if this ManagedConnectionFactory is equal to another
ManagedConnectionFactory.
|
PrintWriter |
getLogWriter()
Get the log writer for this ManagedConnectionFactory instance.
|
int |
hashCode()
Returns the hash code for the ManagedConnectionFactory
|
ManagedConnection |
matchManagedConnections(Set connectionSet,
Subject subject,
ConnectionRequestInfo cxRequestInfo)
Returns a matched connection from the candidate set of connections.
|
void |
setLogWriter(PrintWriter out)
Set the log writer for this ManagedConnectionFactory instance.
|
Object createConnectionFactory(ConnectionManager cxManager) throws ResourceException
cxManager
- ConnectionManager to be associated with
created EIS connection factory instanceResourceException
- Generic exceptionResourceAdapterInternalException
- Resource adapter related error conditionObject createConnectionFactory() throws ResourceException
ResourceException
- Generic exceptionResourceAdapterInternalException
- Resource adapter related error conditionManagedConnection createManagedConnection(Subject subject, ConnectionRequestInfo cxRequestInfo) throws ResourceException
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.
subject
- Caller's security informationcxRequestInfo
- Additional resource adapter specific connection
request informationResourceException
- generic exceptionSecurityException
- security related errorResourceAllocationException
- failed to allocate system resources for
connection requestResourceAdapterInternalException
- resource adapter related error conditionEISSystemException
- internal error condition in EIS instanceManagedConnection matchManagedConnections(Set connectionSet, Subject subject, ConnectionRequestInfo cxRequestInfo) throws ResourceException
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.
connectionSet
- candidate connection setsubject
- caller's security informationcxRequestInfo
- additional resource adapter specific
connection request informationResourceException
- generic exceptionSecurityException
- security related errorResourceAdapterInternalException
- resource adapter related error conditionNotSupportedException
- if operation is not supportedvoid setLogWriter(PrintWriter out) throws ResourceException
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.
out
- PrintWriter - an out stream for
error logging and tracingResourceException
- generic exceptionResourceAdapterInternalException
- resource adapter related error conditionPrintWriter getLogWriter() throws ResourceException
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.
ResourceException
- generic exceptionint hashCode()
Copyright © 2012 JBoss by Red Hat. All Rights Reserved.