Package org.datanucleus.store.connection

Package defining the connection to the datastore.

See: Description

Interface Summary

Interface	Description
ConnectionFactory	Factory for connections to the datastore.
ConnectionManager	Manager of connections for a StoreManager, allowing ManagedConnection pooling, enlistment in transaction.
ManagedConnection	Wrapper for a connection to the datastore, allowing management.
ManagedConnectionResourceListener	Listener for the relation between a ManagedConnection and a resource using that ManagedConnection.

Class Summary

Class	Description
AbstractConnectionFactory	Abstract implementation of a ConnectionFactory for a DataNucleus-supported datastore.
AbstractEmulatedXAResource	Abstract base for any emulated XAResource implementations for the store plugins.
AbstractManagedConnection	Abstract implementation of a managed connection.
ConnectionManagerImpl	Manager of connections for a datastore, allowing caching of ManagedConnections, enlistment in transaction.

Enum Summary

Enum	Description
ConnectionResourceType	Resource type of the connection.

Package org.datanucleus.store.connection Description

Package defining the connection to the datastore.

ConnectionManager

This is the entry point into the connection management process. You use it to get a connection to the datastore (ManagedConnection). This manages a "primary" ConnectionFactory and an optional "secondary" ConnectionFactory. Some datastores only support a single factory. The ConnectionManager manages 2 caches of the currently allocated ManagedConnection objects, keyed by the ExecutionContext they are for; an ExecutionContext can only have 1 ManagedConnection per ConnectionFactory.

ConnectionFactory

This is responsible for generating the actual connections to the datastore. Each datastore plugin has to implement this for their own datastore. There is a provided AbstractConnectionFactory that must be extended to provide this implementation.

ManagedConnection

This represents the actual connection to the datastore, wrapping the real connection. Each datastore plugin has to implement this for their own datastore. There is a provided AbstractManagedConnection that must be extended to provide this implementation.