net.n3.nanoxml

Class XMLException

public class XMLException extends Exception

An XMLException is thrown when an exception occurred while processing the XML data.

Version: $Name: RELEASE_2_2_1 $, $Revision: 1.4 $

Author: Marc De Scheemaecker

Constructor Summary
XMLException(String msg)
Creates a new exception.
XMLException(Exception e)
Creates a new exception.
XMLException(String systemID, int lineNr, Exception e)
Creates a new exception.
XMLException(String systemID, int lineNr, String msg)
Creates a new exception.
XMLException(String systemID, int lineNr, Exception e, String msg, boolean reportParams)
Creates a new exception.
Method Summary
protected voidfinalize()
Cleans up the object when it's destroyed.
ExceptiongetException()
Returns the encapsulated exception, or null if no exception is encapsulated.
intgetLineNr()
Returns the line number in the XML data where the exception occurred.
StringgetSystemID()
Returns the system ID of the XML data where the exception occurred.
voidprintStackTrace(PrintWriter writer)
Dumps the exception stack to a print writer.
voidprintStackTrace(PrintStream stream)
Dumps the exception stack to an output stream.
voidprintStackTrace()
Dumps the exception stack to System.err.
StringtoString()
Returns a string representation of the exception.

Constructor Detail

XMLException

public XMLException(String msg)
Creates a new exception.

Parameters: msg the message of the exception.

XMLException

public XMLException(Exception e)
Creates a new exception.

Parameters: e the encapsulated exception.

XMLException

public XMLException(String systemID, int lineNr, Exception e)
Creates a new exception.

Parameters: systemID the system ID of the XML data where the exception occurred lineNr the line number in the XML data where the exception occurred. e the encapsulated exception.

XMLException

public XMLException(String systemID, int lineNr, String msg)
Creates a new exception.

Parameters: systemID the system ID of the XML data where the exception occurred lineNr the line number in the XML data where the exception occurred. msg the message of the exception.

XMLException

public XMLException(String systemID, int lineNr, Exception e, String msg, boolean reportParams)
Creates a new exception.

Parameters: systemID the system ID from where the data came lineNr the line number in the XML data where the exception occurred. e the encapsulated exception. msg the message of the exception. reportParams true if the systemID, lineNr and e params need to be appended to the message

Method Detail

finalize

protected void finalize()
Cleans up the object when it's destroyed.

getException

public Exception getException()
Returns the encapsulated exception, or null if no exception is encapsulated.

getLineNr

public int getLineNr()
Returns the line number in the XML data where the exception occurred. If there is no line number known, -1 is returned.

getSystemID

public String getSystemID()
Returns the system ID of the XML data where the exception occurred. If there is no system ID known, null is returned.

printStackTrace

public void printStackTrace(PrintWriter writer)
Dumps the exception stack to a print writer.

Parameters: writer the print writer

printStackTrace

public void printStackTrace(PrintStream stream)
Dumps the exception stack to an output stream.

Parameters: stream the output stream

printStackTrace

public void printStackTrace()
Dumps the exception stack to System.err.

toString

public String toString()
Returns a string representation of the exception.