Package net.sf.saxon.trans
Class XPathException
java.lang.Object
java.lang.Throwable
java.lang.Exception
javax.xml.transform.TransformerException
net.sf.saxon.trans.XPathException
- All Implemented Interfaces:
Serializable
- Direct Known Subclasses:
CopyNamespaceSensitiveException
,Error.UserDefinedXPathException
,NoDynamicContextException
,NoOpenStartTagException
,QuitParsingException
,SchemaException
,TerminationException
,ValidationException
,XPathException.Circularity
,XPathException.StackOverflow
XPathException is used to indicate an error (static or dynamic) in an XPath expression,
or in a query or stylesheet.
- See Also:
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionstatic class
Subclass of XPathException used to report circularitiesstatic class
Subclass of XPathException used to report stack overflow -
Constructor Summary
ConstructorsConstructorDescriptionXPathException
(String message) Create an XPathException with an error messageXPathException
(String message, String errorCode) Create an XPathException that supplies an error message and an error codeXPathException
(String message, String errorCode, XPathContext context) Create an XPathException that supplies an error message and an error code and provides the dynamic contextXPathException
(String message, String errorCode, Location loc) Create an XPathException that supplies an error message and supplies location informationXPathException
(String message, Throwable err) Create an XPathException that supplies an error message and wraps an underlying exceptionXPathException
(Throwable err) Create an XPathException that wraps another exception -
Method Summary
Modifier and TypeMethodDescriptionMark this exception to indicate that it represents a type errorasTypeErrorIf
(boolean condition) static XPathException
Get the error code as a QNameGet the error object associated with this error.Get the host language codeMethod getLocator retrieves an instance of a SourceLocator object that specifies where an error occured.Get the dynamic context at the time the exception occurredboolean
Ask whether this error is marked to indicate that it has already been reported to the error listener, and should not be reported againboolean
hasErrorCode
(String... codes) Ask whether the error code is a specific system error codeboolean
Ask whether this exception originated while evaluating a global variable reference, and is therefore to be reported regardless of the try/catch context surrounding the variable referenceboolean
Tests whether this is a dynamic error that may be reported statically if it is detected staticallyboolean
Ask whether this exception represents a static errorboolean
Ask whether this exception represents a syntax errorboolean
Ask whether this exception represents a type errorstatic XPathException
Create an XPathException from an exception of another kind.void
maybeSetContext
(XPathContext context) Set the context of a message, only if it is not already setvoid
maybeSetErrorCode
(String code) Set the error code, provided it has not already been set.void
maybeSetLocation
(Location here) Set the location of a message, only if it is not already setmaybeWithContext
(XPathContext context) maybeWithErrorCode
(String code) maybeWithFailingExpression
(Expression failingExpression) maybeWithLocation
(Location here) replacingErrorCode
(String oldCode, String newCode) void
setErrorCode
(String code) Set the error code.void
Set the error code.void
setErrorObject
(Sequence value) Set the error object associated with this error.void
setHasBeenReported
(boolean reported) Mark this error to indicate that it has already been reported to the error listener, and should not be reported againvoid
setHostLanguage
(String language) Set the host language codevoid
setHostLanguage
(HostLanguage language) Set the host language codevoid
setIsGlobalError
(boolean is) Mark this exception to indicate that it originated while evaluating a global variable reference, and is therefore to be reported regardless of the try/catch context surrounding the variable referencevoid
setIsStaticError
(boolean is) Mark this exception to indicate that it represents (or does not represent) a static errorvoid
setIsSyntaxError
(boolean is) Mark this exception to indicate that it represents (or does not represent) a syntax errorvoid
setIsTypeError
(boolean is) Mark this exception to indicate that it represents (or does not represent) a type errorvoid
setLocation
(Location loc) void
setXPathContext
(XPathContext context) Set dynamic context information in the exception objectwithErrorCode
(String code) Set the error code.withErrorCode
(StructuredQName code) withFailingExpression
(Expression failingExpression) withLocation
(Location loc) Set location information in the exception objectwithMessage
(String message) Construct an exception that differs from a supplied exception only by changing the error messagewithXPathContext
(XPathContext context) Set dynamic context information in the exception objectMethods inherited from class javax.xml.transform.TransformerException
getCause, getException, getLocationAsString, getMessageAndLocation, initCause, printStackTrace, printStackTrace, printStackTrace, setLocator
Methods inherited from class java.lang.Throwable
addSuppressed, fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, setStackTrace, toString
-
Constructor Details
-
XPathException
Create an XPathException with an error message- Parameters:
message
- the message explaining what is wrong. This should not include location information.
-
XPathException
Create an XPathException that wraps another exception- Parameters:
err
- the wrapped error or exception
-
XPathException
Create an XPathException that supplies an error message and wraps an underlying exception- Parameters:
message
- the error message (which should generally explain what Saxon was doing when the underlying exception occurred)err
- the underlying exception (the cause of this exception)
-
XPathException
Create an XPathException that supplies an error message and supplies location information- Parameters:
message
- the error messageloc
- indicates where in the user-written query or stylesheet (or sometimes in a source document) the error occurred
-
XPathException
Create an XPathException that supplies an error message and an error code- Parameters:
message
- the error messageerrorCode
- the error code - an eight-character code, which is taken to be in the standard system error code namespace
-
XPathException
Create an XPathException that supplies an error message and an error code and provides the dynamic context- Parameters:
message
- the error messageerrorCode
- the error code - an eight-character code, which is taken to be in the standard system error code namespacecontext
- the dynamic evaluation context
-
-
Method Details
-
makeXPathException
Create an XPathException from an exception of another kind. If the supplied Exception is an XPathException; if its cause is an XPathException, that XPathException is returned unchanged; otherwise the supplied Exception is wrapped.- Parameters:
err
- the supplied Exception- Returns:
- an XPathException obtained from the supplied TransformerException
-
fromXmlProcessingError
-
withMessage
Construct an exception that differs from a supplied exception only by changing the error message- Parameters:
message
- the new message- Returns:
- a new exception, copying all the properties of this exception except for the message
-
setXPathContext
Set dynamic context information in the exception object- Parameters:
context
- the dynamic context at the time the exception occurred
-
withXPathContext
Set dynamic context information in the exception object- Parameters:
context
- the dynamic context at the time the exception occurred- Returns:
- this XPathException object in a modified state
-
setLocation
-
withLocation
Set location information in the exception object- Parameters:
loc
- indicating where the exception occurred- Returns:
- this XPathException object in a modified state
-
getFailingExpression
-
withFailingExpression
-
maybeWithFailingExpression
-
getLocator
Method getLocator retrieves an instance of a SourceLocator object that specifies where an error occured.- Overrides:
getLocator
in classTransformerException
- Returns:
- A SourceLocator object, or null if none was specified.
-
getXPathContext
Get the dynamic context at the time the exception occurred- Returns:
- the dynamic context if known; otherwise null
-
setIsStaticError
public void setIsStaticError(boolean is) Mark this exception to indicate that it represents (or does not represent) a static error- Parameters:
is
- true if this exception is a static error
-
asStaticError
-
isStaticError
public boolean isStaticError()Ask whether this exception represents a static error- Returns:
- true if this exception is a static error
-
setIsSyntaxError
public void setIsSyntaxError(boolean is) Mark this exception to indicate that it represents (or does not represent) a syntax error- Parameters:
is
- true if this exception is a syntax error
-
isSyntaxError
public boolean isSyntaxError()Ask whether this exception represents a syntax error- Returns:
- true if this exception is a syntax error
-
setIsTypeError
public void setIsTypeError(boolean is) Mark this exception to indicate that it represents (or does not represent) a type error- Parameters:
is
- true if this exception is a type error
-
asTypeError
Mark this exception to indicate that it represents a type error- Returns:
- this XPathException in a modified state
-
asTypeErrorIf
-
isTypeError
public boolean isTypeError()Ask whether this exception represents a type error- Returns:
- true if this exception is a type error
-
setIsGlobalError
public void setIsGlobalError(boolean is) Mark this exception to indicate that it originated while evaluating a global variable reference, and is therefore to be reported regardless of the try/catch context surrounding the variable reference- Parameters:
is
- true if this exception is a global variable error
-
isGlobalError
public boolean isGlobalError()Ask whether this exception originated while evaluating a global variable reference, and is therefore to be reported regardless of the try/catch context surrounding the variable reference- Returns:
- true if this exception is a global variable error
-
setHostLanguage
Set the host language code- Parameters:
language
- a value such as "XPath", "XQuery", "XSLT Pattern"
-
setHostLanguage
Set the host language code- Parameters:
language
- a value such as "XPath", "XQuery", "XSLT Pattern"
-
getHostLanguage
Get the host language code- Returns:
- a value such as "XPath", "XQuery", "XSLT Pattern", or null
-
setErrorCode
Set the error code. The error code is a QName; this method sets the local part of the name, setting the namespace of the error code to the standard system namespaceNamespaceConstant.ERR
- Parameters:
code
- The local part of the name of the error code
-
withErrorCode
Set the error code. The error code is a QName; this method sets the local part of the name, setting the namespace of the error code to the standard system namespaceNamespaceConstant.ERR
- Parameters:
code
- The local part of the name of the error code- Returns:
- this XPathException object in a modified state
-
withErrorCode
-
replacingErrorCode
-
maybeSetErrorCode
Set the error code, provided it has not already been set. The error code is a QName; this method sets the local part of the name, setting the namespace of the error code to the standard system namespaceNamespaceConstant.ERR
- Parameters:
code
- The local part of the name of the error code
-
maybeWithErrorCode
-
setErrorCodeQName
Set the error code. The error code is a QName; this method sets both parts of the name.- Parameters:
code
- The error code as a QName
-
getErrorCodeQName
Get the error code as a QName- Returns:
- the error code as a QName
-
showErrorCode
-
hasErrorCode
Ask whether the error code is a specific system error code- Parameters:
codes
- the local part of the error(s) expected- Returns:
- true if the error code matches one of the required codes, treated as local names in the standard error namespace
-
setErrorObject
Set the error object associated with this error. This is used by the standard XPath fn:error() function- Parameters:
value
- the error object, as supplied to the fn:error() function
-
getErrorObject
Get the error object associated with this error. This is used by the standard XPath fn:error() function- Returns:
- the error object, as supplied to the fn:error() function
-
setHasBeenReported
public void setHasBeenReported(boolean reported) Mark this error to indicate that it has already been reported to the error listener, and should not be reported again- Parameters:
reported
- true if the error has been reported to the error listener
-
hasBeenReported
public boolean hasBeenReported()Ask whether this error is marked to indicate that it has already been reported to the error listener, and should not be reported again- Returns:
- true if this error has already been reported
-
maybeSetLocation
Set the location of a message, only if it is not already set- Parameters:
here
- the current location (or null)
-
maybeWithLocation
-
maybeSetContext
Set the context of a message, only if it is not already set- Parameters:
context
- the current XPath context (or null)
-
maybeWithContext
-
isReportableStatically
public boolean isReportableStatically()Tests whether this is a dynamic error that may be reported statically if it is detected statically- Returns:
- true if the error can be reported statically
-