LocalTransactionException (Java 2 Platform Ent. Ed. v1.4)

Overview

Package

Class

Tree

Deprecated

Index

Help

Java^TM 2 Platform
Ent. Ed. v1.4

PREV CLASS NEXT CLASS

FRAMES NO FRAMES All Classes

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

javax.resource.spi
Class LocalTransactionException

java.lang.Object
 extended byjava.lang.Throwable
 extended byjava.lang.Exception
 extended byjavax.resource.ResourceException
 extended byjavax.resource.spi.LocalTransactionException

All Implemented Interfaces:: Serializable

public class LocalTransactionException
extends ResourceException

A LocalTransactionException represents various error conditions related to the local transaction management contract. The Java Transaction API 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.

Version:: 1.0
Author:: Rahul Sharma, Ram Jeyaraman
See Also:: Serialized Form

Constructor Summary
`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.

Methods inherited from class javax.resource.ResourceException

getErrorCode, getLinkedException, getMessage, setErrorCode, setLinkedException

Methods inherited from class java.lang.Throwable

fillInStackTrace, getCause, getLocalizedMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

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 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.