Class XAException

java.lang.Object
java.lang.Throwable
java.lang.Exception
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

    Fields
    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

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