Class LocalTransactionException

All Implemented Interfaces:
Serializable

public class LocalTransactionException extends ResourceException
A LocalTransactionException represents various error conditions related to the local transaction management contract. The Jakarta™ Transactions specification specifies the javax.transaction.xa.XAException class for exceptions related to XAResource based transaction management contract.

The LocalTransactionException is used for the local transaction management contract to indicate the following common error conditions:

  • Invalid transaction context when a transaction operation is executed. For example, calling commit method on LocalTransaction object without an active local transaction is an error condition.
  • Transaction is rolled back instead of getting committed during a commit method call on the LocalTransaction object.
  • An attempt to start a local transaction from the same thread on a ManagedConnection that is already associated with an active local transaction.
  • Any resource adapter or resource manager specific error conditions related to local transaction management. Examples are violation of integrity of resources, deadlock detection, communication failure during transaction completion, retry required or any internal error in a resource manager.
See Also:
  • Constructor Details

    • LocalTransactionException

      public LocalTransactionException()
      Constructs a new instance with null as its detail message.
    • LocalTransactionException

      public LocalTransactionException(String message)
      Constructs a new instance with the specified detail message.
      Parameters:
      message - the detail message.
    • LocalTransactionException

      public LocalTransactionException(Throwable cause)
      Constructs a new throwable with the specified cause.
      Parameters:
      cause - a chained exception of type Throwable.
    • LocalTransactionException

      public LocalTransactionException(String message, Throwable cause)
      Constructs a new throwable with the specified detail message and cause.
      Parameters:
      message - the detail message.
      cause - a chained exception of type Throwable.
    • LocalTransactionException

      public LocalTransactionException(String message, String errorCode)
      Constructs a new throwable with the specified detail message and an error code.
      Parameters:
      message - a description of the exception.
      errorCode - a string specifying the vendor specific error code.