|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
java.lang.Objectorg.springframework.jca.cci.connection.ConnectionFactoryUtils
public abstract class ConnectionFactoryUtils
Helper class that provides static methods for obtaining CCI Connections
from a ConnectionFactory. Includes special
support for Spring-managed transactional Connections, e.g. managed
by CciLocalTransactionManager or
JtaTransactionManager.
Used internally by CciTemplate,
Spring's CCI operation objects and the CciLocalTransactionManager.
Can also be used directly in application code.
getConnection(javax.resource.cci.ConnectionFactory),
releaseConnection(javax.resource.cci.Connection, javax.resource.cci.ConnectionFactory),
CciLocalTransactionManager,
JtaTransactionManager,
TransactionSynchronizationManager| Constructor Summary | |
|---|---|
ConnectionFactoryUtils()
|
|
| Method Summary | |
|---|---|
static Connection |
doGetConnection(ConnectionFactory cf)
Actually obtain a CCI Connection from the given ConnectionFactory. |
static void |
doReleaseConnection(Connection con,
ConnectionFactory cf)
Actually close the given Connection, obtained from the given ConnectionFactory. |
static Connection |
getConnection(ConnectionFactory cf)
Obtain a Connection from the given ConnectionFactory. |
static Connection |
getConnection(ConnectionFactory cf,
ConnectionSpec spec)
Obtain a Connection from the given ConnectionFactory. |
static boolean |
isConnectionTransactional(Connection con,
ConnectionFactory cf)
Determine whether the given JCA CCI Connection is transactional, that is, bound to the current thread by Spring's transaction facilities. |
static void |
releaseConnection(Connection con,
ConnectionFactory cf)
Close the given Connection, obtained from the given ConnectionFactory, if it is not managed externally (that is, not bound to the thread). |
| Methods inherited from class java.lang.Object |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Constructor Detail |
|---|
public ConnectionFactoryUtils()
| Method Detail |
|---|
public static Connection getConnection(ConnectionFactory cf)
throws CannotGetCciConnectionException
Is aware of a corresponding Connection bound to the current thread, for example
when using CciLocalTransactionManager. Will bind a Connection to the thread
if transaction synchronization is active (e.g. if in a JTA transaction).
cf - the ConnectionFactory to obtain Connection from
CannotGetCciConnectionException - if the attempt to get a Connection failedreleaseConnection(javax.resource.cci.Connection, javax.resource.cci.ConnectionFactory)
public static Connection getConnection(ConnectionFactory cf,
ConnectionSpec spec)
throws CannotGetCciConnectionException
Is aware of a corresponding Connection bound to the current thread, for example
when using CciLocalTransactionManager. Will bind a Connection to the thread
if transaction synchronization is active (e.g. if in a JTA transaction).
cf - the ConnectionFactory to obtain Connection fromspec - the ConnectionSpec for the desired Connection (may be null).
Note: If this is specified, a new Connection will be obtained for every call,
without participating in a shared transactional Connection.
CannotGetCciConnectionException - if the attempt to get a Connection failedreleaseConnection(javax.resource.cci.Connection, javax.resource.cci.ConnectionFactory)
public static Connection doGetConnection(ConnectionFactory cf)
throws ResourceException
getConnection(javax.resource.cci.ConnectionFactory), but throwing the original ResourceException.
Is aware of a corresponding Connection bound to the current thread, for example
when using CciLocalTransactionManager. Will bind a Connection to the thread
if transaction synchronization is active (e.g. if in a JTA transaction).
Directly accessed by TransactionAwareConnectionFactoryProxy.
cf - the ConnectionFactory to obtain Connection from
ResourceException - if thrown by CCI API methodsdoReleaseConnection(javax.resource.cci.Connection, javax.resource.cci.ConnectionFactory)
public static boolean isConnectionTransactional(Connection con,
ConnectionFactory cf)
con - the Connection to checkcf - the ConnectionFactory that the Connection was obtained from
(may be null)
public static void releaseConnection(Connection con,
ConnectionFactory cf)
con - the Connection to close if necessary
(if this is null, the call will be ignored)cf - the ConnectionFactory that the Connection was obtained from
(can be null)getConnection(javax.resource.cci.ConnectionFactory)
public static void doReleaseConnection(Connection con,
ConnectionFactory cf)
throws ResourceException
releaseConnection(javax.resource.cci.Connection, javax.resource.cci.ConnectionFactory), but throwing the original ResourceException.
Directly accessed by TransactionAwareConnectionFactoryProxy.
con - the Connection to close if necessary
(if this is null, the call will be ignored)cf - the ConnectionFactory that the Connection was obtained from
(can be null)
ResourceException - if thrown by JCA CCI methodsdoGetConnection(javax.resource.cci.ConnectionFactory)
|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||