org.hibernate.transaction
Interface TransactionFactory

All Known Implementing Classes:

CMTTransactionFactory, JDBCTransactionFactory, JTATransactionFactory

public interface TransactionFactory

An abstract factory for Transaction instances. Concrete implementations are specified by hibernate.transaction.factory_class.

Implementors must be threadsafe and should declare a public default constructor.

Author:

Anton van Straaten, Gavin King

See Also:

Transaction

Nested Class Summary

static interface

TransactionFactory.Context

Method Summary

boolean	areCallbacksLocalToHibernateTransactions() Are all transaction callbacks local to Hibernate Transactions? Or can the callbacks originate from some other source (e.g.
void	configure(Properties props) Configure from the given properties.
Transaction	createTransaction(JDBCContext jdbcContext, TransactionFactory.Context context) Begin a transaction and return the associated Transaction instance.
ConnectionReleaseMode	getDefaultReleaseMode() Get the default connection release mode
boolean	isTransactionInProgress(JDBCContext jdbcContext, TransactionFactory.Context transactionContext, Transaction transaction) Determine whether an underlying transaction is in progress.
boolean	isTransactionManagerRequired() Do we require access to the JTA TransactionManager for this strategy?

Method Detail

createTransaction

Transaction createTransaction(JDBCContext jdbcContext,
                              TransactionFactory.Context context)
                              throws HibernateException

Begin a transaction and return the associated Transaction instance.

Parameters:

jdbcContext - The jdbc context to which the transaction belongs

context - The contract regarding the context in which this transaction will operate.

Returns:

Transaction

Throws:

HibernateException

configure

void configure(Properties props)
               throws HibernateException

Configure from the given properties.

Parameters:

props -

Throws:

HibernateException

getDefaultReleaseMode

ConnectionReleaseMode getDefaultReleaseMode()

Get the default connection release mode

isTransactionManagerRequired

boolean isTransactionManagerRequired()

Do we require access to the JTA TransactionManager for this strategy?

areCallbacksLocalToHibernateTransactions

boolean areCallbacksLocalToHibernateTransactions()

Are all transaction callbacks local to Hibernate Transactions? Or can the callbacks originate from some other source (e.g. a JTA Synchronization).

Returns:

true if callbacks only ever originate from the Hibernate Transaction; false otherwise.

isTransactionInProgress

boolean isTransactionInProgress(JDBCContext jdbcContext,
                                TransactionFactory.Context transactionContext,
                                Transaction transaction)

Determine whether an underlying transaction is in progress.

Mainly this is used in determining whether to register a synchronization as well as whether or not to circumvent auto flushing outside transactions.

Parameters:

jdbcContext -

transactionContext -

transaction -

Returns:

true if an underlying transaction is know to be in effect.