nu.xom.xinclude

Class XIncludeException

Known Direct Subclasses:
BadEncodingAttributeException, BadHrefAttributeException, BadHTTPHeaderException, BadParseAttributeException, InclusionLoopException, MisplacedFallbackException, NoIncludeLocationException

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, String uri)
Creates a new XIncludeException with a detail message, line and column numbers, and the URI of the document that caused the exception.
XIncludeException(String message, Throwable cause)
Constructs an XIncludeException with the specified detail message and initial cause.

Method Summary

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.
String
getURI()
Returns the URI of the document that caused this exception.
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.

Constructor Details

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,
                         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

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

Method Details

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

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