net.sf.saxon
Class StandardErrorListener
java.lang.Object
net.sf.saxon.StandardErrorListener
- ErrorListener, Serializable
public class StandardErrorListener
extends java.lang.Object
implements ErrorListener, Serializable
StandardErrorListener is the standard error handler for XSLT processing
errors, used if no other ErrorListener is nominated.
void | error(TransformerException exception) - Receive notification of a recoverable error.
|
void | fatalError(TransformerException exception) - Receive notification of a non-recoverable error.
|
PrintStream | getErrorOutput() - Get the error output stream
|
static String | getExpandedMessage(TransformerException err) - Get a string containing the message for this exception and all contained exceptions
|
static String | getLocationMessage(TransformerException err) - Get a string identifying the location of an error.
|
int | getRecoveryPolicy() - Get the recovery policy
|
StandardErrorListener | makeAnother(int hostLanguage) - Make a clean copy of this ErrorListener.
|
void | setErrorOutput(PrintStream writer) - Set output destination for error messages (default is System.err)
|
void | setRecoveryPolicy(int policy) - Set the recovery policy
|
void | warning(TransformerException exception) - Receive notification of a warning.
|
errorOutput
protected PrintStream errorOutput
StandardErrorListener
public StandardErrorListener()
Create a Standard Error Listener
error
public void error(TransformerException exception)
throws TransformerException
Receive notification of a recoverable error.
The transformer must continue to provide normal parsing events
after invoking this method. It should still be possible for the
application to process the document through to the end.
The action of the standard error listener depends on the
recovery policy that has been set, which may be one of RECOVER_SILENTLY,
RECOVER_WITH_WARNING, or DO_NOT_RECOVER
exception
- The error information encapsulated in a
transformer exception.
fatalError
public void fatalError(TransformerException exception)
throws TransformerException
Receive notification of a non-recoverable error.
The application must assume that the transformation cannot
continue after the Transformer has invoked this method,
and should continue (if at all) only to collect
addition error messages. In fact, Transformers are free
to stop reporting events once this method has been invoked.
exception
- The error information encapsulated in a
transformer exception.
getErrorOutput
public PrintStream getErrorOutput()
Get the error output stream
getExpandedMessage
public static String getExpandedMessage(TransformerException err)
Get a string containing the message for this exception and all contained exceptions
err
- the exception containing the required information
- a message that concatenates the message of this exception with its contained exceptions,
also including information about the error code and location.
getLocationMessage
public static String getLocationMessage(TransformerException err)
Get a string identifying the location of an error.
err
- the exception containing the location information
- a message string describing the location
getRecoveryPolicy
public int getRecoveryPolicy()
Get the recovery policy
makeAnother
public StandardErrorListener makeAnother(int hostLanguage)
Make a clean copy of this ErrorListener. This is necessary because the
standard error listener is stateful (it remembers how many errors there have been)
hostLanguage
- the host language (not used by this implementation)
- a copy of this error listener
setErrorOutput
public void setErrorOutput(PrintStream writer)
Set output destination for error messages (default is System.err)
writer
- The PrintStream to use for error messages
setRecoveryPolicy
public void setRecoveryPolicy(int policy)
Set the recovery policy
warning
public void warning(TransformerException exception)
throws TransformerException
Receive notification of a warning.
Transformers can use this method to report conditions that
are not errors or fatal errors. The default behaviour is to
take no action.
After invoking this method, the Transformer must continue with
the transformation. It should still be possible for the
application to process the document through to the end.
exception
- The warning information encapsulated in a
transformer exception.
javax.xml.transform.TransformerException