Package org.apache.torque.util
Klasse Transaction
java.lang.Object
org.apache.torque.util.Transaction
Encapsulates transaction and connection handling within Torque.
If the underlying database does not support transaction or the database
pool returns autocommit connections, the commit and rollback methods
fallback to simple connection pool handling.
- Version:
- $Id: Transaction.java 1839284 2018-08-27 08:57:56Z tv $
- Autor:
- Stephen Haberman
-
Methodenübersicht
Modifizierer und TypMethodeBeschreibungstatic TorqueConnection
begin()
Begin a transaction by retrieving a connection from the default database connection pool.static TorqueConnection
Begin a transaction by retrieving a connection from the named database connection pool.static void
commit
(Connection con) Commit a transaction and close the connection.static TransactionManager
Returns the current transaction manager.static void
rollback
(Connection con) Roll back a transaction and release the connection.static void
safeRollback
(Connection con) Roll back a transaction without throwing errors if they occur.static void
setTransactionManager
(TransactionManager transactionManager) Sets the transaction manager to use.
-
Methodendetails
-
setTransactionManager
Sets the transaction manager to use.- Parameter:
transactionManager
- the transaction manager to use.
-
getTransactionManager
Returns the current transaction manager.- Gibt zurück:
- the current transaction manager.
-
begin
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.- Gibt zurück:
- The Connection for the transaction.
- Löst aus:
TorqueException
- Any exceptions caught during processing will be rethrown wrapped into a TorqueException.
-
begin
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.- Parameter:
dbName
- Name of database.- Gibt zurück:
- The Connection for the transaction.
- Löst aus:
TorqueException
- If the connection cannot be retrieved.
-
commit
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- Parameter:
con
- The Connection for the transaction.- Löst aus:
TorqueException
- Any exceptions caught during processing will be rethrown wrapped into a TorqueException.
-
rollback
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.- Parameter:
con
- The Connection for the transaction.- Löst aus:
TorqueException
- Any exceptions caught during processing will be rethrown wrapped into a TorqueException.
-
safeRollback
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.- Parameter:
con
- The Connection for the transaction.- Siehe auch:
-