nu.xom.xinclude

Class XIncludeException

public class XIncludeException extends Exception

The generic superclass for all checked exceptions that may be thrown as a result of a violation of XInclude's rules.

Version: 1.1b3

Author: Elliotte Rusty Harold

Constructor Summary
XIncludeException(String message)

Constructs an XIncludeException with the specified detail message.

XIncludeException(String message, Throwable cause)

Constructs an XIncludeException with the specified detail message and initial cause.

XIncludeException(String message, String uri)

Creates a new XIncludeException with a detail message, line and column numbers, and the URI of the document that caused the exception.

Method Summary
ThrowablegetCause()

When an IOException, MalformedURLException, or other generic exception is thrown while processing an XML document for XIncludes, it is customarily replaced by some form of XIncludeException.

StringgetURI()

Returns the URI of the document that caused this exception.

ThrowableinitCause(Throwable cause)

When an IOException, MalformedURLException, or other generic exception is thrown while processing an XML document for XIncludes, it is customarily replaced by some form of XIncludeException.

Constructor Detail

XIncludeException

public XIncludeException(String message)

Constructs an XIncludeException with the specified detail message.

Parameters: message a string indicating the specific problem

XIncludeException

public XIncludeException(String message, Throwable cause)

Constructs an XIncludeException with the specified detail message and initial cause. The error message string message can later be retrieved by the java.lang.Throwable#getMessage method of class java.lang.Throwable.

Parameters: message a string indicating the specific problem cause the initial cause of the exception

XIncludeException

public XIncludeException(String message, String uri)

Creates a new XIncludeException with a detail message, line and column numbers, and the URI of the document that caused the exception.

Parameters: message a string indicating the specific problem uri the URI of the document that caused this exception

Method Detail

getCause

public Throwable getCause()

When an IOException, MalformedURLException, or other generic exception is thrown while processing an XML document for XIncludes, it is customarily replaced by some form of XIncludeException. This method allows you to retrieve the original exception. It returns null if no such exception caused this XIncludeException.

Returns: the underlying exception which caused this XIncludeException to be thrown

getURI

public String getURI()

Returns the URI of the document that caused this exception. If the URI is not known, null is returned.

Returns: URI of the document where the exception occurred

initCause

public Throwable initCause(Throwable cause)

When an IOException, MalformedURLException, or other generic exception is thrown while processing an XML document for XIncludes, it is customarily replaced by some form of XIncludeException. This method allows you to store the original exception.

Parameters: cause the root cause of this exception

Returns: this XIncludeException

Throws: IllegalArgumentException if the cause is this exception (An exception cannot be its own cause.) IllegalStateException if this method is called twice

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