Class XAException

javax.transaction.xa.XAException

All Implemented Interfaces:: Serializable

public class XAException extends Exception

The XAException is thrown by the Resource Manager (RM) to inform the Transaction Manager of an error encountered by the involved transaction.

Since:

1.4

See Also:

Field Summary

Modifier and Type	Field	Description
`int`	`errorCode`	The error code with which to create the SystemException.
`static final int`	`XA_HEURCOM`	The transaction branch has been heuristically committed.
`static final int`	`XA_HEURHAZ`	The transaction branch may have been heuristically completed.
`static final int`	`XA_HEURMIX`	The transaction branch has been heuristically committed and rolled back.
`static final int`	`XA_HEURRB`	The transaction branch has been heuristically rolled back.
`static final int`	`XA_NOMIGRATE`	Resumption must occur where the suspension occurred.
`static final int`	`XA_RBBASE`	The inclusive lower bound of the rollback codes.
`static final int`	`XA_RBCOMMFAIL`	Indicates that the rollback was caused by a communication failure.
`static final int`	`XA_RBDEADLOCK`	A deadlock was detected.
`static final int`	`XA_RBEND`	The inclusive upper bound of the rollback error code.
`static final int`	`XA_RBINTEGRITY`	A condition that violates the integrity of the resource was detected.
`static final int`	`XA_RBOTHER`	The resource manager rolled back the transaction branch for a reason not on this list.
`static final int`	`XA_RBPROTO`	A protocol error occurred in the resource manager.
`static final int`	`XA_RBROLLBACK`	Indicates that the rollback was caused by an unspecified reason.
`static final int`	`XA_RBTIMEOUT`	A transaction branch took too long.
`static final int`	`XA_RBTRANSIENT`	May retry the transaction branch.
`static final int`	`XA_RDONLY`	The transaction branch was read-only and has been committed.
`static final int`	`XA_RETRY`	Routine returned with no effect and may be reissued.
`static final int`	`XAER_ASYNC`	There is an asynchronous operation already outstanding.
`static final int`	`XAER_DUPID`	The XID already exists.
`static final int`	`XAER_INVAL`	Invalid arguments were given.
`static final int`	`XAER_NOTA`	The XID is not valid.
`static final int`	`XAER_OUTSIDE`	The resource manager is doing work outside a global transaction.
`static final int`	`XAER_PROTO`	Routine was invoked in an improper context.
`static final int`	`XAER_RMERR`	A resource manager error has occurred in the transaction branch.
`static final int`	`XAER_RMFAIL`	Resource manager is unavailable.

Constructor Summary

Constructor	Description
`XAException()`	Create an XAException.
`XAException(int errcode)`	Create an XAException with a given error code.
`XAException(String s)`	Create an XAException with a given string.

Method Summary

Methods declared in class Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Modifier and Type	Method	Description
`final void`	`addSuppressed(Throwable exception)`	Appends the specified exception to the exceptions that were suppressed in order to deliver this exception.
`Throwable`	`fillInStackTrace()`	Fills in the execution stack trace.
`Throwable`	`getCause()`	Returns the cause of this throwable or `null` if the cause is nonexistent or unknown.
`String`	`getLocalizedMessage()`	Creates a localized description of this throwable.
`String`	`getMessage()`	Returns the detail message string of this throwable.
`StackTraceElement[]`	`getStackTrace()`	Provides programmatic access to the stack trace information printed by `Throwable.printStackTrace()`.
`final Throwable[]`	`getSuppressed()`	Returns an array containing all of the exceptions that were suppressed, typically by the `try`-with-resources statement, in order to deliver this exception.
`Throwable`	`initCause(Throwable cause)`	Initializes the cause of this throwable to the specified value.
`void`	`printStackTrace()`	Prints this throwable and its backtrace to the standard error stream.
`void`	`printStackTrace(PrintStream s)`	Prints this throwable and its backtrace to the specified print stream.
`void`	`printStackTrace(PrintWriter s)`	Prints this throwable and its backtrace to the specified print writer.
`void`	`setStackTrace(StackTraceElement[] stackTrace)`	Sets the stack trace elements that will be returned by `Throwable.getStackTrace()` and printed by `Throwable.printStackTrace()` and related methods.
`String`	`toString()`	Returns a short description of this throwable.

Methods declared in class Object

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

Modifier and Type	Method	Description
`protected Object`	`clone()`	Creates and returns a copy of this object.
`boolean`	`equals(Object obj)`	Indicates whether some other object is "equal to" this one.
`protected void`	`finalize()`	Deprecated, for removal: This API element is subject to removal in a future version. Finalization is deprecated and subject to removal in a future release.
`final Class<?>`	`getClass()`	Returns the runtime class of this `Object`.
`int`	`hashCode()`	Returns a hash code value for this object.
`final void`	`notify()`	Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()`	Wakes up all threads that are waiting on this object's monitor.
`final void`	`wait()`	Causes the current thread to wait until it is awakened, typically by being notified or interrupted.
`final void`	`wait(long timeoutMillis)`	Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait(long timeoutMillis, int nanos)`	Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.

Field Details

errorCode

public int errorCode

The error code with which to create the SystemException.

XA_RBBASE

public static final int XA_RBBASE

The inclusive lower bound of the rollback codes.

See Also:

XA_RBROLLBACK

public static final int XA_RBROLLBACK

Indicates that the rollback was caused by an unspecified reason.

See Also:

XA_RBCOMMFAIL

public static final int XA_RBCOMMFAIL

Indicates that the rollback was caused by a communication failure.

See Also:

XA_RBDEADLOCK

public static final int XA_RBDEADLOCK

A deadlock was detected.

See Also:

XA_RBINTEGRITY

public static final int XA_RBINTEGRITY

A condition that violates the integrity of the resource was detected.

See Also:

XA_RBOTHER

public static final int XA_RBOTHER

The resource manager rolled back the transaction branch for a reason not on this list.

See Also:

XA_RBPROTO

public static final int XA_RBPROTO

A protocol error occurred in the resource manager.

See Also:

XA_RBTIMEOUT

public static final int XA_RBTIMEOUT

A transaction branch took too long.

See Also:

XA_RBTRANSIENT

public static final int XA_RBTRANSIENT

May retry the transaction branch.

See Also:

XA_RBEND

public static final int XA_RBEND

The inclusive upper bound of the rollback error code.

See Also:

XA_NOMIGRATE

public static final int XA_NOMIGRATE

Resumption must occur where the suspension occurred.

See Also:

XA_HEURHAZ

public static final int XA_HEURHAZ

The transaction branch may have been heuristically completed.

See Also:

XA_HEURCOM

public static final int XA_HEURCOM

The transaction branch has been heuristically committed.

See Also:

XA_HEURRB

public static final int XA_HEURRB

The transaction branch has been heuristically rolled back.

See Also:

XA_HEURMIX

public static final int XA_HEURMIX

The transaction branch has been heuristically committed and rolled back.

See Also:

XA_RETRY

public static final int XA_RETRY

Routine returned with no effect and may be reissued.

See Also:

XA_RDONLY

public static final int XA_RDONLY

The transaction branch was read-only and has been committed.

See Also:

XAER_ASYNC

public static final int XAER_ASYNC

There is an asynchronous operation already outstanding.

See Also:

XAER_RMERR

public static final int XAER_RMERR

A resource manager error has occurred in the transaction branch.

See Also:

XAER_NOTA

public static final int XAER_NOTA

The XID is not valid.

See Also:

XAER_INVAL

public static final int XAER_INVAL

Invalid arguments were given.

See Also:

XAER_PROTO

public static final int XAER_PROTO

Routine was invoked in an improper context.

See Also:

XAER_RMFAIL

public static final int XAER_RMFAIL

Resource manager is unavailable.

See Also:

XAER_DUPID

public static final int XAER_DUPID

The XID already exists.

See Also:

XAER_OUTSIDE

public static final int XAER_OUTSIDE

The resource manager is doing work outside a global transaction.

See Also:

Constructor Details

XAException

public XAException()

Create an XAException.

XAException

public XAException(String s)

Create an XAException with a given string.

Parameters:: s - The String object containing the exception message.

XAException

public XAException(int errcode)

Create an XAException with a given error code.

Parameters:: errcode - The error code identifying the exception.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.