Package javax.resource.spi

Interface Summary

ActivationSpec	This interface serves as a marker.
BootstrapContext	This provides a mechanism to pass a bootstrap context to a resource adapter instance when it is bootstrapped.
ConnectionEventListener	The ConnectionEventListener interface provides an event callback mechanism to enable an application server to receive notifications from a ManagedConnection instance. An application server uses these event notifications to manage its connection pool, to clean up any invalid or terminated connections and to manage local transactions. An application server implements the ConnectionEventListener interface.
ConnectionManager	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.
ConnectionRequestInfo	The ConnectionRequestInfo interface enables a resource adapter to pass its own request specific data structure across the connection request flow.
DissociatableManagedConnection	This is a mix-in interface that may be optionally implemented by a ManagedConnection implementation.
LazyAssociatableConnectionManager	This is a mix-in interface that may be optionally implemented by a ConnectionManager implementation.
LazyEnlistableConnectionManager	This is a mix-in interface that may be optionally implemented by a ConnectionManager implementation.
LazyEnlistableManagedConnection	This is a mix-in interface that may be optionally implemented by a ManagedConnection implementation.
LocalTransaction	LocalTransaction interface provides support for transactions that are managed internal to an EIS resource manager, and do not require an external transaction manager. A resource adapter implements the javax.resource.spi.LocalTransaction interface to provide support for local transactions that are performed on the underlying resource manager. If a resource adapter supports the LocalTransaction interface, then the application server can choose to perform local transaction optimization (uses local transaction instead of a JTA transaction for a single resource manager case).
ManagedConnection	ManagedConnection instance represents a physical connection to the underlying EIS. A ManagedConnection instance provides access to a pair of interfaces: javax.transaction.xa.XAResource and javax.resource.spi.LocalTransaction. XAResource interface is used by the transaction manager to associate and dissociate a transaction with the underlying EIS resource manager instance and to perform two-phase commit protocol.
ManagedConnectionFactory	ManagedConnectionFactory instance is a factory of both ManagedConnection and EIS-specific connection factory instances.
ManagedConnectionMetaData	The ManagedConnectionMetData interface provides information about the underlying EIS instance associated with a ManagedConnection instance.
ResourceAdapter	This represents a resource adapter instance and contains operations for lifecycle management and message endpoint setup.
ResourceAdapterAssociation	This interface specifies the methods to associate a ResourceAdapter object with other objects that implement this interface like ManagedConnectionFactory and ActivationSpec.
ValidatingManagedConnectionFactory	This interface is implemented by a ManagedConnectionFactory instance that supports the ability to validate ManagedConnection objects. This may be used by the application server to prune invalid ManagedConnection objects from its connection pool.
XATerminator	The XATerminator interface is used for transaction completion and crash recovery flows.

Class Summary

ConnectionEvent

The ConnectionEvent class provides information about the source of a connection related event.A ConnectionEvent instance contains the following information: Type of the connection event ManagedConnection instance that generated the connection event.

Exception Summary

ApplicationServerInternalException	An ApplicationServerInternalException is thrown by an application server to indicate error conditions specific to an application server.
CommException	This indicates errors related to failed or interrupted communication with an EIS instance.
EISSystemException
IllegalStateException	An IllegalStateException is thrown from a method if the callee (resource adapter or application server for system contracts) is in an illegal or inappropriate state for the method invocation.
InvalidPropertyException	This exception is thrown to indicate invalid configuration property settings.
LocalTransactionException	A LocalTransactionException represents various error conditions related to the local transaction management contract.
ResourceAdapterInternalException	A ResourceAdapterInternalException indicates any system-level error conditions related to a resource adapter.
ResourceAllocationException	A ResourceAllocationException can be thrown by an application server or resource adapter to indicate any failure to allocate system resources (example: threads, physical connections).
SecurityException	A SecurityException indicates error conditions related to the security contract between an application server and resource adapter.
SharingViolationException	This is thrown to indicate a connection sharing violation. This may be thrown by a resource adapter when an application uses a shareable connection in an unshareable manner.
UnavailableException	This is thrown to indicate that a service is unavailable.