nu.xom

Class XMLException

Known Direct Subclasses:
NoSuchAttributeException, NoSuchChildException, UnavailableCharacterException, WellformednessException

public class XMLException
extends RuntimeException

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.
Version:
1.1b3
Author:
Elliotte Rusty Harold

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.

Constructor Details

XMLException

public XMLException(String message)
Creates a new XMLException with the specified detail message.
Parameters:
message - information about the cause of the exception

XMLException

public XMLException(String message,
                    Throwable cause)
Creates a new XMLException with the specified detail message and an underlying root cause.
Parameters:
message - information about the cause of the exception
cause - the nested exception that caused this exception

Method Details

getCause

public Throwable getCause()
Return the original cause that led to this exception, or null if there was no original exception.
Returns:
the root cause of 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.

Parameters:
cause - the root cause of this exception
Returns:
this XMLException

Copyright 2002-2009 Elliotte Rusty Harold
elharo@metalab.unc.edu