Class XMLException

All Implemented Interfaces:
Serializable

public class XMLException extends RuntimeException
This class encapsulates a general XML error or warning.

This class can contain basic error or warning information from either the parser or the application.

If the application needs to pass through other types of exceptions, it must wrap those exceptions in a XMLException.

Version:
$Id: XMLException.java 1733416 2016-03-03 07:07:13Z gadams $
See Also:
  • Field Details

  • Constructor Details

    • XMLException

      public XMLException(String message)
      Creates a new XMLException.
      Parameters:
      message - The error or warning message.
    • XMLException

      public XMLException(Exception e)
      Creates a new XMLException wrapping an existing exception.

      The existing exception will be embedded in the new one, and its message will become the default message for the XMLException.

      Parameters:
      e - The exception to be wrapped in a XMLException.
    • XMLException

      public XMLException(String message, Exception e)
      Creates a new XMLException from an existing exception.

      The existing exception will be embedded in the new one, but the new exception will have its own message.

      Parameters:
      message - The detail message.
      e - The exception to be wrapped in a SAXException.
  • Method Details

    • getMessage

      public String getMessage()
      Return a detail message for this exception.

      If there is a embedded exception, and if the XMLException has no detail message of its own, this method will return the detail message from the embedded exception.

      Overrides:
      getMessage in class Throwable
      Returns:
      The error or warning message.
    • getException

      public Exception getException()
      Return the embedded exception, if any.
      Returns:
      The embedded exception, or null if there is none.
    • printStackTrace

      public void printStackTrace()
      Prints this Exception and its backtrace to the standard error stream.
      Overrides:
      printStackTrace in class Throwable
    • printStackTrace

      public void printStackTrace(PrintStream s)
      Prints this Exception and its backtrace to the specified print stream.
      Overrides:
      printStackTrace in class Throwable
      Parameters:
      s - PrintStream to use for output
    • printStackTrace

      public void printStackTrace(PrintWriter s)
      Prints this Exception and its backtrace to the specified print writer.
      Overrides:
      printStackTrace in class Throwable
      Parameters:
      s - PrintWriter to use for output