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)
    The specified exception is going to be suppressed in order to give priority to this exception (primary exception) and to be appended to the list of suppressed exceptions.
    Throwable
    fillInStackTrace()
    Record in the receiver a walkback from the point where this message was sent.
    Throwable
    getCause()
    Answers the cause of this Throwable, or null if there is no cause.
    String
    getLocalizedMessage()
    Answers the extra information message which was provided when the throwable was created.
    String
    getMessage()
    Answers the extra information message which was provided when the throwable was created.
    StackTraceElement[]
    getStackTrace()
    Answers an array of StackTraceElement.
    final Throwable[]
    getSuppressed()
    Returns an array of exceptions suppressed, typically by the automatically generated code from the try-with-resources statement, in order to give priority to this exception (primary exception).
    Throwable
    initCause(Throwable throwable)
    Initialize the cause of the receiver.
    void
    printStackTrace()
    Outputs a printable representation of the receiver's walkback on the System.err stream.
    void
    printStackTrace(PrintStream err)
    Outputs a printable representation of the receiver's walkback on the stream specified by the argument.
    void
    printStackTrace(PrintWriter err)
    Outputs a printable representation of the receiver's walkback on the writer specified by the argument.
    void
    setStackTrace(StackTraceElement[] trace)
    Sets the array of StackTraceElements.
    String
    toString()
    Answers a string containing a concise, human-readable description of the receiver.

    Methods declared in class Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
    Modifier and Type
    Method
    Description
    protected Object
    clone()
    Answers a new instance of the same class as the receiver, whose slots have been filled in with the values in the slots of the receiver.
    boolean
    equals(Object o)
    Compares the argument to the receiver, and answers true if they represent the same object using a class specific comparison.
    protected void
    finalize()
    Deprecated, for removal: This API element is subject to removal in a future version.
    May cause performance issues, deadlocks and hangs.
    final Class<? extends Object>
    getClass()
    Answers the unique instance of java.lang.Class which represents the class of the receiver.
    int
    hashCode()
    Answers an integer hash code for the receiver.
    final void
    notify()
    Causes one thread which is waiting on the receiver to be made ready to run.
    final void
    notifyAll()
    Causes all threads which are waiting on the receiver to be made ready to run.
    final void
    wait()
    Causes the thread which sent this message to be made not ready to run pending some change in the receiver (as indicated by notify or notifyAll).
    final void
    wait(long time)
    Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.
    final void
    wait(long time, int frac)
    Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.

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