org.hibernate
Interface Transaction

All Known Implementing Classes:

CMTTransaction, JDBCTransaction, JTATransaction

public interface Transaction

Allows the application to define units of work, while maintaining abstraction from the underlying transaction implementation (eg. JTA, JDBC).

A transaction is associated with a Session and is usually instantiated by a call to Session.beginTransaction(). A single session might span multiple transactions since the notion of a session (a conversation between the application and the datastore) is of coarser granularity than the notion of a transaction. However, it is intended that there be at most one uncommitted Transaction associated with a particular Session at any time.

Implementors are not intended to be threadsafe.

Author:

Anton van Straaten

See Also:

Session.beginTransaction(), TransactionFactory

Method Summary

void	begin() Begin a new transaction.
void	commit() Flush the associated Session and end the unit of work.
boolean	isActive() Is this transaction still active?
void	registerSynchronization(Synchronization synchronization) Register a user synchronization callback for this transaction
void	rollback() Force the underlying transaction to roll back.
void	setTimeout(int seconds) Set the transaction timeout for any transaction started by a subsequent call to begin() on this instance.
boolean	wasCommitted() Check if this transaction was successfully committed.
boolean	wasRolledBack() Was this transaction rolled back or set to rollback only?

Method Detail

begin

public void begin()
           throws HibernateException

Begin a new transaction.

Throws:

HibernateException

commit

public void commit()
            throws HibernateException

Flush the associated Session and end the unit of work. This method will commit the underlying transaction if and only if the transaction was initiated by this object.

Throws:

HibernateException

rollback

public void rollback()
              throws HibernateException

Force the underlying transaction to roll back.

Throws:

HibernateException

wasRolledBack

public boolean wasRolledBack()
                      throws HibernateException

Was this transaction rolled back or set to rollback only?

Returns:

boolean

Throws:

HibernateException

wasCommitted

public boolean wasCommitted()
                     throws HibernateException

Check if this transaction was successfully committed. This method could return false even after successful invocation of commit().

Returns:

boolean

Throws:

HibernateException

isActive

public boolean isActive()
                 throws HibernateException

Is this transaction still active?

Returns:

boolean

Throws:

HibernateException

registerSynchronization

public void registerSynchronization(Synchronization synchronization)
                             throws HibernateException

Register a user synchronization callback for this transaction

Throws:

HibernateException

setTimeout

public void setTimeout(int seconds)

Set the transaction timeout for any transaction started by a subsequent call to begin() on this instance.