org.apache.batik.xml

Class XMLException

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.

Field Summary
protected Exceptionexception
Constructor Summary
XMLException(String message)
Creates a new XMLException.
XMLException(Exception e)
Creates a new XMLException wrapping an existing exception.
XMLException(String message, Exception e)
Creates a new XMLException from an existing exception.
Method Summary
ExceptiongetException()
Return the embedded exception, if any.
StringgetMessage()
Return a detail message for this exception.
voidprintStackTrace()
Prints this Exception and its backtrace to the standard error stream.
voidprintStackTrace(PrintStream s)
Prints this Exception and its backtrace to the specified print stream.
voidprintStackTrace(PrintWriter s)
Prints this Exception and its backtrace to the specified print writer.

Field Detail

exception

protected Exception exception

Serial: The embedded exception if tunnelling, or null.

Constructor Detail

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 Detail

getException

public Exception getException()
Return the embedded exception, if any.

Returns: The embedded exception, or null if there is none.

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.

Returns: The error or warning message.

printStackTrace

public void printStackTrace()
Prints this Exception and its backtrace to the standard error stream.

printStackTrace

public void printStackTrace(PrintStream s)
Prints this Exception and its backtrace to the specified print stream.

Parameters: s PrintStream to use for output

printStackTrace

public void printStackTrace(PrintWriter s)
Prints this Exception and its backtrace to the specified print writer.

Parameters: s PrintWriter to use for output

Copyright B) 2008 Apache Software Foundation. All Rights Reserved.