Overview  Package   Class  Use  Deprecated  Index
Home >> All >> javax >> xml >> [ bind overview ]	PREV CLASS  NEXT CLASS
SUMMARY:  JAVADOC |  SOURCE |  DOWNLOAD | NESTED | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

---

javax.xml.bind
Class JAXBException  

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          javax.xml.bind.JAXBException

All Implemented Interfaces:

java.io.Serializable

Direct Known Subclasses:

MarshalException, PropertyException, UnmarshalException, ValidationException

---

public class JAXBException

extends java.lang.Exception

This is the main exception class of JAXB. All other exception classes (except the TypeConstraintException, which is a java.lang.RuntimeException are derived from the JAXBException.

Since:

JAXB1.0

---

Nested Class Summary

 

Nested classes inherited from class java.lang.Throwable

 

Field Summary
private  java.lang.String	errorCode
private  java.lang.Throwable	linkedException

 

Fields inherited from class java.lang.Exception

 

Fields inherited from class java.lang.Throwable

 

Constructor Summary

JAXBException(java.lang.String pMessage)           Creates a new JAXBException with the specified detail message.

JAXBException(java.lang.String pMessage, java.lang.String pErrorCode)           Creates a new JAXBException with the specified detail message and vendor specific error code.

JAXBException(java.lang.String pMessage, java.lang.String pErrorCode, java.lang.Throwable pLinkedException)           Creates a new JAXBException with the specified detail message, error code, and linked exception.

JAXBException(java.lang.String pMessage, java.lang.Throwable pLinkedException)           Creates a new JAXBException with the specified detail message and linked exception.

JAXBException(java.lang.Throwable pLinkedException)           Creates a new JAXBException with the specified linked exception.

 

Method Summary
private static java.lang.String	formatMessage(java.lang.String pErrorCode, java.lang.String pMessage, java.lang.Throwable pThr)
java.lang.String	getErrorCode()           Returns the vendor specific error code, if any, or null.
java.lang.Throwable	getLinkedException()           Returns the linked exception, if any, or null.
void	printStackTrace()           Print a stack trace to the standard error stream.
void	printStackTrace(java.io.PrintStream pStream)           Print a stack trace to the specified PrintStream.
void	printStackTrace(java.io.PrintWriter pWriter)           Prints the exception, the detailed message and the stack trace associated with this Throwable to the given PrintWriter.
void	setLinkedException(java.lang.Throwable pLinkedException)           Sets the linked exception.
java.lang.String	toString()           Converts the linked exception into a String.

 

Methods inherited from class java.lang.Throwable

fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, setStackTrace

 

Methods inherited from class java.lang.Object

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

 

Field Detail

errorCode

private java.lang.String errorCode

---

linkedException

private java.lang.Throwable linkedException

Constructor Detail

JAXBException

public JAXBException(java.lang.String pMessage)

Creates a new JAXBException with the specified detail message.

---

JAXBException

public JAXBException(java.lang.String pMessage,
                     java.lang.String pErrorCode)

Creates a new JAXBException with the specified detail message and vendor specific error code.

---

JAXBException

public JAXBException(java.lang.Throwable pLinkedException)

Creates a new JAXBException with the specified linked exception.

---

JAXBException

public JAXBException(java.lang.String pMessage,
                     java.lang.Throwable pLinkedException)

Creates a new JAXBException with the specified detail message and linked exception.

---

JAXBException

public JAXBException(java.lang.String pMessage,
                     java.lang.String pErrorCode,
                     java.lang.Throwable pLinkedException)

Creates a new JAXBException with the specified detail message, error code, and linked exception.

Method Detail

formatMessage

private static java.lang.String formatMessage(java.lang.String pErrorCode,
                                              java.lang.String pMessage,
                                              java.lang.Throwable pThr)

---

getErrorCode

public java.lang.String getErrorCode()

Returns the vendor specific error code, if any, or null.

---

getLinkedException

public java.lang.Throwable getLinkedException()

Returns the linked exception, if any, or null.

---

setLinkedException

public void setLinkedException(java.lang.Throwable pLinkedException)

Sets the linked exception.

---

toString

public java.lang.String toString()

Converts the linked exception into a String. Overridden, because the returned string should contain the vendor specific error code, if any.

---

printStackTrace

public void printStackTrace()

Description copied from class: java.lang.Throwable

Print a stack trace to the standard error stream. This stream is the current contents of System.err. The first line of output is the result of Throwable.toString()>Throwable.toString() 55 , and the remaining lines represent the data created by Throwable.fillInStackTrace()>Throwable.fillInStackTrace() 55 . While the format is unspecified, this implementation uses the suggested format, demonstrated by this example:

 public class Junk
 {
   public static void main(String args[])
   {
     try
       {
         a();
       }
     catch(HighLevelException e)
       {
         e.printStackTrace();
       }
   }
   static void a() throws HighLevelException
   {
     try
       {
         b();
       }
     catch(MidLevelException e)
       {
         throw new HighLevelException(e);
       }
   }
   static void b() throws MidLevelException
   {
     c();
   }
   static void c() throws MidLevelException
   {
     try
       {
         d();
       }
     catch(LowLevelException e)
       {
         throw new MidLevelException(e);
       }
   }
   static void d() throws LowLevelException
   {
     e();
   }
   static void e() throws LowLevelException
   {
     throw new LowLevelException();
   }
 }
 class HighLevelException extends Exception
 {
   HighLevelException(Throwable cause) { super(cause); }
 }
 class MidLevelException extends Exception
 {
   MidLevelException(Throwable cause)  { super(cause); }
 }
 class LowLevelException extends Exception
 {
 }
 

  HighLevelException: MidLevelException: LowLevelException
          at Junk.a(Junk.java:13)
          at Junk.main(Junk.java:4)
  Caused by: MidLevelException: LowLevelException
          at Junk.c(Junk.java:23)
          at Junk.b(Junk.java:17)
          at Junk.a(Junk.java:11)
          ... 1 more
  Caused by: LowLevelException
          at Junk.e(Junk.java:30)
          at Junk.d(Junk.java:27)
          at Junk.c(Junk.java:21)
          ... 3 more
 

---

printStackTrace

public void printStackTrace(java.io.PrintStream pStream)

Description copied from class: java.lang.Throwable

Print a stack trace to the specified PrintStream. See Throwable.printStackTrace()>Throwable.printStackTrace() 55 for the sample format.

---

printStackTrace

public void printStackTrace(java.io.PrintWriter pWriter)

Description copied from class: java.lang.Throwable

Prints the exception, the detailed message and the stack trace associated with this Throwable to the given PrintWriter. The actual output written is implemention specific. Use the result of getStackTrace() when more precise information is needed.

This implementation first prints a line with the result of this object's toString() method.
Then for all elements given by getStackTrace it prints a line containing three spaces, the string "at " and the result of calling the toString() method on the StackTraceElement object. If getStackTrace() returns an empty array it prints a line containing three spaces and the string "<<No stacktrace available>>".
Then if getCause() doesn't return null it adds a line starting with "Caused by: " and the result of calling toString() on the cause.
Then for every cause (of a cause, etc) the stacktrace is printed the same as for the top level Throwable except that as soon as all the remaining stack frames of the cause are the same as the the last stack frames of the throwable that the cause is wrapped in then a line starting with three spaces and the string "... X more" is printed, where X is the number of remaining stackframes.

---

Overview  Package   Class  Use  Deprecated  Index
Home >> All >> javax >> xml >> [ bind overview ]	PREV CLASS  NEXT CLASS
SUMMARY:  JAVADOC |  SOURCE |  DOWNLOAD | NESTED | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

---