Package org.synchronoss.cpo.core

Interface CpoAdapterFactory

public interface CpoAdapterFactory

Creates CpoAdapter instances (plain, transactional, or XA) for a single named data source configuration.

Implementations are obtained from CpoAdapterFactoryManager by config name; each factory is bound to one dataConfig entry from cpoConfig.xml.

Author:

dberry

Method Summary

Modifier and Type	Method	Description
CpoAdapter	getCpoAdapter()	Gets a CpoAdapter that manages its own connections per call (no explicit transaction control).
CpoTrxAdapter	getCpoTrxAdapter()	Gets a CpoTrxAdapter pinned to a single connection/session for explicit transaction control (commit/rollback/close).
CpoXaResource	getCpoXaAdapter()	Gets a CpoXaResource that participates in a JTA-managed distributed transaction.

Method Details

getCpoAdapter

CpoAdapter getCpoAdapter()
                  throws CpoException

Gets a CpoAdapter that manages its own connections per call (no explicit transaction control).

Returns:

a usable CpoAdapter

Throws:

CpoException - if the adapter cannot be created

getCpoTrxAdapter

CpoTrxAdapter getCpoTrxAdapter()
                        throws CpoException

Gets a CpoTrxAdapter pinned to a single connection/session for explicit transaction control (commit/rollback/close).

Returns:

a usable CpoTrxAdapter

Throws:

CpoException - if the adapter cannot be created

getCpoXaAdapter

CpoXaResource getCpoXaAdapter()
                       throws CpoException

Gets a CpoXaResource that participates in a JTA-managed distributed transaction.

Returns:

a usable CpoXaResource

Throws:

CpoException - if the resource cannot be created