Class XIncludeException
- All Implemented Interfaces:
Serializable
- Direct Known Subclasses:
BadEncodingAttributeException
,BadHrefAttributeException
,BadHTTPHeaderException
,BadParseAttributeException
,InclusionLoopException
,MisplacedFallbackException
,NoIncludeLocationException
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:
-
Constructor Summary
ConstructorsConstructorDescriptionXIncludeException
(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
Modifier and TypeMethodDescriptiongetCause()
When anIOException
,MalformedURLException
, or other generic exception is thrown while processing an XML document for XIncludes, it is customarily replaced by some form ofXIncludeException
.getURI()
Returns the URI of the document that caused this exception.When anIOException
,MalformedURLException
, or other generic exception is thrown while processing an XML document for XIncludes, it is customarily replaced by some form ofXIncludeException
.Methods inherited from class java.lang.Throwable
addSuppressed, fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
-
Constructor Details
-
XIncludeException
Constructs an
XIncludeException
with the specified detail message.- Parameters:
message
- a string indicating the specific problem
-
XIncludeException
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
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 Details
-
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
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
. -
initCause
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
-