nu.xom
Class ParsingException
public class ParsingException
extends Exception
The generic superclass for all the
checked exceptions thrown in XOM. The general
principle followed is that anything that could
plausibly be detected by testing such as
using spaces in an element name is a runtime exception.
Exceptions that depend on environmental conditions,
such as might occur when parsing an external file,
are checked exceptions, because these depend on variable input,
and thus problems may not all be detected during testing.
ParsingException(String message) -
Creates a new
ParsingException with a detail message.
|
ParsingException(String message, String uri, Throwable cause) -
Creates a new
ParsingException with a detail message
and an underlying root cause.
|
ParsingException(String message, String uri, int lineNumber, int columnNumber) -
Creates a new
ParsingException with a detail message
and line and column numbers.
|
ParsingException(String message, String uri, int lineNumber, int columnNumber, Throwable cause) -
Creates a new
ParsingException with a detail
message, line and column numbers, and an underlying exception.
|
ParsingException(String message, Throwable cause) -
Creates a new
ParsingException with a detail message
and an underlying root cause.
|
ParsingException(String message, int lineNumber, int columnNumber) -
Creates a new
ParsingException with a detail message
and line and column numbers.
|
ParsingException(String message, int lineNumber, int columnNumber, Throwable cause) -
Creates a new
ParsingException with a detail
message, line and column numbers, and an underlying exception.
|
Throwable | getCause() -
Returns the underlying exception that caused this exception.
|
int | getColumnNumber() -
Returns the approximate column number of the construct that
caused this exception.
|
int | getLineNumber() -
Returns the approximate row number of the construct that
caused this exception.
|
String | getURI() -
Returns the system ID (generally a URL) of the document that
caused this exception.
|
Throwable | initCause(Throwable cause) -
Sets the root cause of this exception.
|
String | toString() -
Returns a string suitable for display to the developer
summarizing what went wrong where.
|
ParsingException
public ParsingException(String message)
Creates a new ParsingException
with a detail message.
message
- a string indicating the specific problem
ParsingException
public ParsingException(String message,
String uri,
Throwable cause)
Creates a new ParsingException
with a detail message
and an underlying root cause.
message
- a string indicating the specific problemuri
- the URI of the document that caused this exceptioncause
- the original cause of this exception
ParsingException
public ParsingException(String message,
String uri,
int lineNumber,
int columnNumber)
Creates a new ParsingException
with a detail message
and line and column numbers.
message
- a string indicating the specific problemuri
- the URI of the document that caused this exceptionlineNumber
- the approximate line number
where the problem occurscolumnNumber
- the approximate column number
where the problem occurs
ParsingException
public ParsingException(String message,
String uri,
int lineNumber,
int columnNumber,
Throwable cause)
Creates a new ParsingException
with a detail
message, line and column numbers, and an underlying exception.
message
- a string indicating the specific problemuri
- the URI of the document that caused this exceptionlineNumber
- the approximate line number
where the problem occurscolumnNumber
- the approximate column number
where the problem occurscause
- the original cause of this exception
ParsingException
public ParsingException(String message,
Throwable cause)
Creates a new ParsingException
with a detail message
and an underlying root cause.
message
- a string indicating the specific problemcause
- the original cause of this exception
ParsingException
public ParsingException(String message,
int lineNumber,
int columnNumber)
Creates a new ParsingException
with a detail message
and line and column numbers.
message
- a string indicating the specific problemlineNumber
- the approximate line number
where the problem occurscolumnNumber
- the approximate column number
where the problem occurs
ParsingException
public ParsingException(String message,
int lineNumber,
int columnNumber,
Throwable cause)
Creates a new ParsingException
with a detail
message, line and column numbers, and an underlying exception.
message
- a string indicating the specific problemlineNumber
- the approximate line number
where the problem occurscolumnNumber
- the approximate column number
where the problem occurscause
- the original cause of this exception
getCause
public Throwable getCause()
Returns the underlying exception that caused this exception.
- the root exception that caused this exception
to be thrown
getColumnNumber
public int getColumnNumber()
Returns the approximate column number of the construct that
caused this exception. If the column number is not known,
-1 is returned.
- column number where the exception occurred
getLineNumber
public int getLineNumber()
Returns the approximate row number of the construct that
caused this exception. If the row number is not known,
-1 is returned.
- row number where the exception occurred
getURI
public String getURI()
Returns the system ID (generally a URL) of the document that
caused this exception. If this is not known, for instance
because the document was parsed from a raw input stream or from
a string, it returns null.
- the URI of the document that caused this exception
initCause
public final Throwable initCause(Throwable cause)
Sets the root cause of this exception. This may
only be called once. Subsequent calls throw an
IllegalStateException
.
This method is unnecessary in Java 1.4 where it could easily be
inherited from the superclass. However, including it here
allows this method to be used in Java 1.3 and earlier.
cause
- the root cause of this exception
toString
public String toString()
Returns a string suitable for display to the developer
summarizing what went wrong where.
- an exception message suitable for display to a developer
Copyright 2002-2005 Elliotte Rusty Harold
elharo@metalab.unc.edu