TransactionFactory (Hibernate Core Aggregator 3.6.10.Final API)

All Known Implementing Classes:

CMTTransactionFactory, JDBCTransactionFactory, JoinableCMTTransactionFactory, JTATransactionFactory
```
public interface TransactionFactory
```
Contract for generating Hibernate Transaction instances.
The concrete implementation to be used is specified by the Environment.TRANSACTION_STRATEGY configuration setting.
Implementors must be threadsafe and should declare a public default constructor.

Author:

Anton van Straaten, Gavin King

See Also:
Transaction

Nested Class Summary

Nested Classes
Modifier and Type Interface and Description

static interface TransactionFactory.Context
Callback mechanism; a context is always a Session in the Hibernate usage.

Nested Classes
Modifier and Type	Interface and Description
`static interface`	`TransactionFactory.Context` Callback mechanism; a context is always a `Session` in the Hibernate usage.

Method Summary

Methods
Modifier and Type	Method and Description
`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 - Indicates a problem generating a transaction instance
  - configure
```
void configure(Properties props)
               throws HibernateException
```
    Configure from the given properties.
    
    Parameters:
    props - The configuration properties.
    
    Throws:
    
    HibernateException - Indicates a problem configuring this factory.
  - getDefaultReleaseMode
```
ConnectionReleaseMode getDefaultReleaseMode()
```
    Get the default connection release mode.
    
    Returns:
    The default release mode associated with this strategy
  - isTransactionManagerRequired
```
boolean isTransactionManagerRequired()
```
    Do we require access to the JTA TransactionManager for this strategy?
    
    Returns:
    True if this strategy requires access to the JTA TransactionManager; false otherwise.
  - 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 - The JDBC context
    transactionContext - The transaction context
    transaction - The Hibernate transaction
    
    Returns:
    true if an underlying transaction is know to be in effect.

Interface TransactionFactory

Nested Class Summary

Method Summary

Method Detail

createTransaction

configure

getDefaultReleaseMode

isTransactionManagerRequired

areCallbacksLocalToHibernateTransactions

isTransactionInProgress