- java.lang.Object
-
- java.lang.Throwable
-
- java.lang.Exception
-
- jakarta.resource.ResourceException
-
- jakarta.resource.spi.LocalTransactionException
-
- All Implemented Interfaces:
Serializable
public class LocalTransactionException extends ResourceException
ALocalTransactionException
represents various error conditions related to the local transaction management contract. The Jakarta™ Transactions specification specifies thejavax.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 onLocalTransaction
object without an active local transaction is an error condition. - Transaction is rolled back instead of getting committed during a
commit
method call on theLocalTransaction
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.
- Version:
- 1.0
- Author:
- Rahul Sharma, Ram Jeyaraman
- See Also:
- Serialized Form
-
-
Constructor Summary
Constructors Constructor Description LocalTransactionException()
Constructs a new instance with null as its detail message.LocalTransactionException(String message)
Constructs a new instance with the specified detail message.LocalTransactionException(String message, String errorCode)
Constructs a new throwable with the specified detail message and an error code.LocalTransactionException(String message, Throwable cause)
Constructs a new throwable with the specified detail message and cause.LocalTransactionException(Throwable cause)
Constructs a new throwable with the specified cause.
-
Method Summary
-
Methods inherited from class jakarta.resource.ResourceException
getErrorCode, getLinkedException, getMessage, setErrorCode, setLinkedException
-
Methods inherited from class java.lang.Throwable
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
-
-
-
-
Constructor Detail
-
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 typeThrowable
.
-
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 typeThrowable
.
-
-