Overview | Package | Class | Use | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## org.apache.torque.util
Interface TransactionManager

All Known Implementing Classes:
  TransactionManagerImpl

    public interface TransactionManager

Torque's interface to the transaction management system.

Version:
  $Id: TransactionManager.java 1448414 2013-02-20 21:06:35Z tfischer $

Method Summary
`Connection` | `begin()` Begin a transaction by retrieving a connection from the default database connection pool.
`Connection` | `begin(String dbName)` Begin a transaction by retrieving a connection from the named database connection pool.
`void` | `commit(Connection con)` Commit a transaction and close the connection.
`void` | `rollback(Connection con)` Roll back a transaction and release the connection.
`void` | `safeRollback(Connection con)` Roll back a transaction without throwing errors if they occur.

Method Detail

### begin

    Connection begin()
                     throws TorqueException

  Begin a transaction by retrieving a connection from the default database connection pool. WARNING: If the database does not support transaction or the pool has set autocommit to true on the connection, the database will commit after every statement, regardless of when a commit or rollback is issued.

  Returns:
    The Connection for the transaction.
  Throws:
    `TorqueException` - Any exceptions caught during processing will be rethrown wrapped into a TorqueException.

### begin

    Connection begin(String dbName)
                     throws TorqueException

  Begin a transaction by retrieving a connection from the named database connection pool. WARNING: If the database does not support transaction or the pool has set autocommit to true on the connection, the database will commit after every statement, regardless of when a commit or rollback is issued.

  Parameters:
    `dbName` - Name of database.
  Returns:
    The Connection for the transaction.
  Throws:
    `TorqueException` - If the connection cannot be retrieved.

### commit

    void commit(Connection con)
                throws TorqueException

  Commit a transaction and close the connection. If the connection is in autocommit mode or the database does not support transactions, only a connection close is performed

  Parameters:
    `con` - The Connection for the transaction.
  Throws:
    `TorqueException` - Any exceptions caught during processing will be rethrown wrapped into a TorqueException.

### rollback

    void rollback(Connection con)
                  throws TorqueException

  Roll back a transaction and release the connection. In databases that do not support transactions or if autocommit is true, no rollback will be performed, but the connection will be closed anyway.

  Parameters:
    `con` - The Connection for the transaction.
  Throws:
    `TorqueException` - Any exceptions caught during processing will be rethrown wrapped into a TorqueException.

### safeRollback

    void safeRollback(Connection con)

  Roll back a transaction without throwing errors if they occur. A null Connection argument is logged at the debug level and other errors are logged at warn level.

  Parameters:
    `con` - The Connection for the transaction.
  See Also:
    `TransactionManagerImpl.rollback(Connection)`

Overview | Package | Class | Use | Tree | Deprecated | Index | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

Copyright © 2000-2013 The Apache Software Foundation. All Rights Reserved.