Class XIncludeException
- Object
-
- Throwable
-
- Exception
-
- nu.xom.xinclude.XIncludeException
-
- All Implemented Interfaces:
Serializable
- Direct Known 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
- See Also:
- Serialized Form
-
-
Constructor Summary
Constructors Constructor Description XIncludeException(String message)
Constructs anXIncludeException
with the specified detail message.XIncludeException(String message, String uri)
Creates a newXIncludeException
with a detail message, line and column numbers, and the URI of the document that caused the exception.XIncludeException(String message, Throwable cause)
Constructs anXIncludeException
with the specified detail message and initial cause.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description Throwable
getCause()
When anIOException
,MalformedURLException
, or other generic exception is thrown while processing an XML document for XIncludes, it is customarily replaced by some form ofXIncludeException
.String
getURI()
Returns the URI of the document that caused this exception.Throwable
initCause(Throwable cause)
When anIOException
,MalformedURLException
, or other generic exception is thrown while processing an XML document for XIncludes, it is customarily replaced by some form ofXIncludeException
.
-
-
-
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 stringmessage
can later be retrieved by the
method of classThrowable.getMessage()
java.lang.Throwable
.- Parameters:
message
- a string indicating the specific problemcause
- 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 problemuri
- the URI of the document that caused this exception
-
-
Method Detail
-
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
-
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 ofXIncludeException
. This method allows you to retrieve the original exception. It returns null if no such exception caused thisXIncludeException
.- Overrides:
getCause
in classThrowable
- Returns:
- the underlying exception which caused this XIncludeException to be thrown
-
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 ofXIncludeException
. This method allows you to store the original exception.- Overrides:
initCause
in classThrowable
- 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
-
-