Class CMTTransactionHandler

java.lang.Object
org.jdbi.v3.core.transaction.CMTTransactionHandler
All Implemented Interfaces:
TransactionHandler

public class CMTTransactionHandler extends Object implements TransactionHandler
Handler designed to behave properly in a J2EE CMT environment. It will never explicitly begin or commit a transaction, and will throw a runtime exception when rollback is called to force rollback.
  • Constructor Details

    • CMTTransactionHandler

      public CMTTransactionHandler()
  • Method Details

    • begin

      public void begin(Handle handle)
      Called when a transaction is started
      Specified by:
      begin in interface TransactionHandler
      Parameters:
      handle - the handle the transaction is being started on
    • commit

      public void commit(Handle handle)
      Called when a transaction is committed
      Specified by:
      commit in interface TransactionHandler
      Parameters:
      handle - the handle the commit is being performed on
    • rollback

      public void rollback(Handle handle)
      Called when a transaction is rolled back Will throw a RuntimeException to force transactional rollback
      Specified by:
      rollback in interface TransactionHandler
      Parameters:
      handle - the handle the rollback is being performed on
    • rollbackToSavepoint

      public void rollbackToSavepoint(Handle handle, String name)
      Savepoints are not supported.
      Specified by:
      rollbackToSavepoint in interface TransactionHandler
      Parameters:
      handle - the handle the rollback is being performed on
      name - the name of the savepoint to rollback to
    • isInTransaction

      public boolean isInTransaction(Handle handle)
      Called to test if a handle is in a transaction
      Specified by:
      isInTransaction in interface TransactionHandler
      Parameters:
      handle - the handle to test
      Returns:
      whether the given handle is in a transaction
    • savepoint

      public void savepoint(Handle handle, String name)
      Savepoints are not supported.
      Specified by:
      savepoint in interface TransactionHandler
      Parameters:
      handle - the handle on which the transaction is being savepointed
      name - The name of the savepoint, used to rollback to or release later
    • releaseSavepoint

      public void releaseSavepoint(Handle handle, String savepointName)
      Savepoints are not supported.
      Specified by:
      releaseSavepoint in interface TransactionHandler
      Parameters:
      handle - the handle on which the savepoint is being released
      savepointName - the savepoint to release
    • inTransaction

      public <R,​ X extends Exception> R inTransaction(Handle handle, HandleCallback<R,​X> callback) throws X
      Description copied from interface: TransactionHandler
      Run a transaction.
      Specified by:
      inTransaction in interface TransactionHandler
      Type Parameters:
      R - the callback return type
      X - the exception type thrown by the callback, if any
      Parameters:
      handle - the handle to the database
      callback - a callback which will receive the open handle, in a transaction.
      Returns:
      the value returned by the callback.
      Throws:
      X - any exception thrown by the callback.
      See Also:
      Handle.inTransaction(HandleCallback)
    • inTransaction

      public <R,​ X extends Exception> R inTransaction(Handle handle, TransactionIsolationLevel level, HandleCallback<R,​X> callback) throws X
      Description copied from interface: TransactionHandler
      Run a transaction.
      Specified by:
      inTransaction in interface TransactionHandler
      Type Parameters:
      R - the callback return type
      X - the exception type thrown by the callback, if any
      Parameters:
      handle - the handle to the database
      level - the isolation level for the transaction
      callback - a callback which will receive the open handle, in a transaction.
      Returns:
      the value returned by the callback.
      Throws:
      X - any exception thrown by the callback.
      See Also:
      Handle.inTransaction(TransactionIsolationLevel, HandleCallback)