Package net.sf.saxon.trans
Class XmlProcessingException
java.lang.Object
net.sf.saxon.trans.XmlProcessingException
- All Implemented Interfaces:
XmlProcessingError
The XmlProcessingException class is a concrete implementation of the
XmlProcessingError
interface that wraps an XPathException
object.-
Constructor Summary
ConstructorsConstructorDescriptionXmlProcessingException
(XPathException exception) Create an XmlProcessingException wrapping an XPathException -
Method Summary
Modifier and TypeMethodDescriptionReturn an XmlProcessingError containing the same information, but to be treated as a warning conditiongetCause()
Return an underlying exception.Get the error code, as a QName.Get the Expression that failed, if knownGet the location information associated with the errorGet the error message associated with this errorgetPath()
Get the absolute XPath expression that identifies the node within its document where the error occurred, if availableAsk whether this error is to be treated as fatal, and if so, return the relevant messsageGet the wrapped exceptionboolean
Ask whether this static error has already been reportedboolean
Ask whether this is a static error, defined as an error that can be detected during static analysis of a stylesheet, query, schema, or XPath expression.boolean
Ask whether this is a type error.boolean
Ask whether this error is being reported as a warning condition.void
setAlreadyReported
(boolean reported) Say whether this error has already been reportedvoid
setTerminationMessage
(String message) Indicate that this error is to be treated as fatal; that is, execution will be abandoned after reporting this error.void
setWarning
(boolean warning) Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Methods inherited from interface net.sf.saxon.s9api.XmlProcessingError
getModuleUri
-
Constructor Details
-
XmlProcessingException
Create an XmlProcessingException wrapping an XPathException- Parameters:
exception
- the wrapped exception
-
-
Method Details
-
getXPathException
Get the wrapped exception- Returns:
- the wrapped exception
-
getHostLanguage
- Specified by:
getHostLanguage
in interfaceXmlProcessingError
-
isStaticError
public boolean isStaticError()Description copied from interface:XmlProcessingError
Ask whether this is a static error, defined as an error that can be detected during static analysis of a stylesheet, query, schema, or XPath expression.- Specified by:
isStaticError
in interfaceXmlProcessingError
- Returns:
- true if this is a static error
-
isTypeError
public boolean isTypeError()Description copied from interface:XmlProcessingError
Ask whether this is a type error. Saxon reports type errors statically if it can establish that a supplied value will never satisfy the required type- Specified by:
isTypeError
in interfaceXmlProcessingError
- Returns:
- true if this is a type error
-
getErrorCode
Description copied from interface:XmlProcessingError
Get the error code, as a QName. This may be null if no error code has been assigned- Specified by:
getErrorCode
in interfaceXmlProcessingError
- Returns:
- QName
-
getMessage
Description copied from interface:XmlProcessingError
Get the error message associated with this error- Specified by:
getMessage
in interfaceXmlProcessingError
- Returns:
- String the error message
-
getLocation
Description copied from interface:XmlProcessingError
Get the location information associated with the error- Specified by:
getLocation
in interfaceXmlProcessingError
- Returns:
- the location of the error. The result is never null, though it may be a location with little useful information.
-
isWarning
public boolean isWarning()Description copied from interface:XmlProcessingError
Ask whether this error is being reported as a warning condition. If so, applications may ignore the condition, though the results may not be as intended.- Specified by:
isWarning
in interfaceXmlProcessingError
- Returns:
- true if a condition is detected that is not an error according to the language specification, but which may indicate that the query or stylesheet might behave in unexpected ways
-
getPath
Description copied from interface:XmlProcessingError
Get the absolute XPath expression that identifies the node within its document where the error occurred, if available- Specified by:
getPath
in interfaceXmlProcessingError
- Returns:
- a path expression identifying the location of the error within an XML document, or null if the information is not available
-
getCause
Description copied from interface:XmlProcessingError
Return an underlying exception. For example, if the static error was caused by failure to retrieve another stylesheet or query module, this may contain the IO exception that was reported; or if the XML parser was unable to parse a stylesheet module, it may contain a SAXException reported by the parser.- Specified by:
getCause
in interfaceXmlProcessingError
- Returns:
- the underlying exception if there was one, or null otherwise
-
getFailingExpression
Description copied from interface:XmlProcessingError
Get the Expression that failed, if known- Specified by:
getFailingExpression
in interfaceXmlProcessingError
- Returns:
- the failing expression, or null
-
setWarning
public void setWarning(boolean warning) -
asWarning
Description copied from interface:XmlProcessingError
Return an XmlProcessingError containing the same information, but to be treated as a warning condition- Specified by:
asWarning
in interfaceXmlProcessingError
- Returns:
- an XmlProcessingError to be treated as a warning
-
setTerminationMessage
Indicate that this error is to be treated as fatal; that is, execution will be abandoned after reporting this error. This method may be called by anErrorReporter
, for example if the error is considered so severe that further processing is not worthwhile, or if too many errors have been signalled. There is no absolute guarantee that setting this property will cause execution to be abandoned. If a dynamic error is marked as fatal, it will generally not be caught by any try/catch mechanism within the stylesheet or query.- Specified by:
setTerminationMessage
in interfaceXmlProcessingError
- Parameters:
message
- an error message giving the reason for the fatal error
-
getTerminationMessage
Ask whether this error is to be treated as fatal, and if so, return the relevant messsage- Specified by:
getTerminationMessage
in interfaceXmlProcessingError
- Returns:
- a non-null message if the error has been marked as a fatal error.
-
isAlreadyReported
public boolean isAlreadyReported()Ask whether this static error has already been reported- Specified by:
isAlreadyReported
in interfaceXmlProcessingError
- Returns:
- true if the error has already been reported
-
setAlreadyReported
public void setAlreadyReported(boolean reported) Say whether this error has already been reported- Specified by:
setAlreadyReported
in interfaceXmlProcessingError
- Parameters:
reported
- true if the error has been reported
-