| |||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
ObjectThrowable
Exception
RuntimeException
nu.xom.XMLException
The generic superclass for most runtime exceptions thrown in
nu.xom
. The general principle followed is that
anything that can normally 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 all problems may not be detected during testing.
Constructor Summary | |
XMLException(String message)
Creates a new XMLException with
the specified detail message. | |
XMLException(String message,
Throwable cause)
Creates a new XMLException
with the specified detail message
and an underlying root cause. |
Method Summary | |
Throwable | getCause()
Return the original cause that led to this exception, or null if there was no original exception. |
Throwable | initCause(Throwable cause)
Sets the root cause of this exception. |
Methods inherited from class Throwable |
fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString |
Methods inherited from class Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Constructor Detail |
public XMLException(String message,
Throwable cause)
Creates a new XMLException
with the specified detail message
and an underlying root cause.
message
- information about the cause of the exceptioncause
- the nested exception that caused this exception
public XMLException(String message)
Creates a new XMLException
with
the specified detail message.
message
- information about the cause of the exceptionMethod Detail |
public Throwable getCause()
Return the original cause that led to this exception, or null if there was no original exception.
public 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
XMLException
IllegalArgumentException
- if the cause is this exception
(An exception cannot be its own cause.)
IllegalStateException
- if this method is called twice
| |||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |