org.jboss.tm
Class JBossXAException

java.lang.Object
  extended byjava.lang.Throwable
      extended byjava.lang.Exception
          extended byjavax.transaction.xa.XAException (src) 
              extended byorg.jboss.tm.JBossXAException
All Implemented Interfaces:
NestedThrowable (src) , java.io.Serializable

public class JBossXAException
extends XAException (src)
implements NestedThrowable (src)

Thrown to indicate a problem with a xaresource related operation.

Properly displays linked exception (ie. nested exception) when printing the stack trace.

See Also:
Serialized Form

Nested Class Summary
 
Nested classes inherited from class org.jboss.util.NestedThrowable (src)
NestedThrowable.Util (src)
 
Field Summary
 
Fields inherited from class javax.transaction.xa.XAException (src)
errorCode, XA_HEURCOM, XA_HEURHAZ, XA_HEURMIX, XA_HEURRB, XA_NOMIGRATE, XA_RBBASE, XA_RBCOMMFAIL, XA_RBDEADLOCK, XA_RBEND, XA_RBINTEGRITY, XA_RBOTHER, XA_RBPROTO, XA_RBROLLBACK, XA_RBTIMEOUT, XA_RBTRANSIENT, XA_RDONLY, XA_RETRY, XAER_ASYNC, XAER_DUPID, XAER_INVAL, XAER_NOTA, XAER_OUTSIDE, XAER_PROTO, XAER_RMERR, XAER_RMFAIL
 
Fields inherited from interface org.jboss.util.NestedThrowable (src)
DETECT_DUPLICATE_NESTING, NESTED_TRACE_ENABLED, PARENT_TRACE_ENABLED
 
Constructor Summary
JBossXAException(int code)
          Construct a JBossXAException with the specified detail message and error code.
JBossXAException(java.lang.String msg)
          Construct a JBossXAException with the specified detail message.
JBossXAException(java.lang.String msg, java.lang.Throwable linked)
          Construct a JBossXAException with the specified detail message and linked Exception.
JBossXAException(java.lang.Throwable linked)
          Construct a JBossXAException with the specified linked Exception.
 
Method Summary
 java.lang.Throwable getCause()
          Return the nested Throwable.
 java.lang.String getMessage()
          Returns the composite throwable message.
 java.lang.Throwable getNested()
          Return the nested Throwable.
 void printStackTrace()
          Prints the composite message and the embedded stack trace to System.err.
 void printStackTrace(java.io.PrintStream stream)
          Prints the composite message and the embedded stack trace to the specified print stream.
 void printStackTrace(java.io.PrintWriter writer)
          Prints the composite message and the embedded stack trace to the specified print writer.
static void rethrowAsXAException(java.lang.String message, java.lang.Throwable t)
          Rethrow as an xa exception if it is not already
 
Methods inherited from class java.lang.Throwable
fillInStackTrace, getLocalizedMessage, getStackTrace, initCause, setStackTrace, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

JBossXAException

public JBossXAException(java.lang.String msg)
Construct a JBossXAException with the specified detail message.

Parameters:
msg - Detail message.

JBossXAException

public JBossXAException(int code)
Construct a JBossXAException with the specified detail message and error code.

Parameters:
code - Error code.

JBossXAException

public JBossXAException(java.lang.String msg,
                        java.lang.Throwable linked)
Construct a JBossXAException with the specified detail message and linked Exception.

Parameters:
msg - Detail message.
linked - Linked Exception.

JBossXAException

public JBossXAException(java.lang.Throwable linked)
Construct a JBossXAException with the specified linked Exception.

Parameters:
linked - Linked Exception.
Method Detail

rethrowAsXAException

public static void rethrowAsXAException(java.lang.String message,
                                        java.lang.Throwable t)
                                 throws XAException (src) 
Rethrow as an xa exception if it is not already

Parameters:
message - the message
t - the original exception
Throws:
XAException (src) - the xa exception

getNested

public java.lang.Throwable getNested()
Return the nested Throwable.

Specified by:
getNested in interface NestedThrowable (src)
Returns:
Nested Throwable.

getCause

public java.lang.Throwable getCause()
Return the nested Throwable.

For JDK 1.4 compatibility.

Specified by:
getCause in interface NestedThrowable (src)
Returns:
Nested Throwable.

getMessage

public java.lang.String getMessage()
Returns the composite throwable message.

Returns:
The composite throwable message.

printStackTrace

public void printStackTrace(java.io.PrintStream stream)
Prints the composite message and the embedded stack trace to the specified print stream.

Parameters:
stream - Stream to print to.

printStackTrace

public void printStackTrace(java.io.PrintWriter writer)
Prints the composite message and the embedded stack trace to the specified print writer.

Parameters:
writer - Writer to print to.

printStackTrace

public void printStackTrace()
Prints the composite message and the embedded stack trace to System.err.