Class DefaultErrorHandler
- All Implemented Interfaces:
ErrorListener
,ErrorHandler
-
Constructor Summary
ConstructorsConstructorDescriptionConstructor DefaultErrorHandlerDefaultErrorHandler
(boolean throwExceptionOnError) Constructor DefaultErrorHandlerConstructor DefaultErrorHandlerConstructor DefaultErrorHandler -
Method Summary
Modifier and TypeMethodDescriptionstatic void
ensureLocationSet
(TransformerException exception) void
error
(TransformerException exception) Receive notification of a recoverable error.void
error
(SAXParseException exception) Receive notification of a recoverable error.void
fatalError
(TransformerException exception) Receive notification of a non-recoverable error.void
fatalError
(SAXParseException exception) Receive notification of a non-recoverable error.Retrievejava.io.PrintWriter
to which errors are being directed.static void
printLocation
(PrintStream pw, TransformerException exception) static void
printLocation
(PrintStream pw, SAXParseException exception) static void
printLocation
(PrintWriter pw, Throwable exception) void
warning
(TransformerException exception) Receive notification of a warning.void
warning
(SAXParseException exception) Receive notification of a warning.
-
Constructor Details
-
DefaultErrorHandler
Constructor DefaultErrorHandler -
DefaultErrorHandler
Constructor DefaultErrorHandler -
DefaultErrorHandler
public DefaultErrorHandler()Constructor DefaultErrorHandler -
DefaultErrorHandler
public DefaultErrorHandler(boolean throwExceptionOnError) Constructor DefaultErrorHandler
-
-
Method Details
-
getErrorWriter
Retrievejava.io.PrintWriter
to which errors are being directed.- Returns:
- The
PrintWriter
installed via the constructor or the defaultPrintWriter
-
warning
Receive notification of a warning.SAX parsers will use this method to report conditions that are not errors or fatal errors as defined by the XML 1.0 recommendation. The default behaviour is to take no action.
The SAX parser 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.
- Specified by:
warning
in interfaceErrorHandler
- Parameters:
exception
- The warning information encapsulated in a SAX parse exception.- Throws:
SAXException
- Any SAX exception, possibly wrapping another exception.
-
error
Receive notification of a recoverable error.This corresponds to the definition of "error" in section 1.2 of the W3C XML 1.0 Recommendation. For example, a validating parser would use this callback to report the violation of a validity constraint. The default behaviour is to take no action.
The SAX parser 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. If the application cannot do so, then the parser should report a fatal error even if the XML 1.0 recommendation does not require it to do so.
- Specified by:
error
in interfaceErrorHandler
- Parameters:
exception
- The error information encapsulated in a SAX parse exception.- Throws:
SAXException
- Any SAX exception, possibly wrapping another exception.
-
fatalError
Receive notification of a non-recoverable error.This corresponds to the definition of "fatal error" in section 1.2 of the W3C XML 1.0 Recommendation. For example, a parser would use this callback to report the violation of a well-formedness constraint.
The application must assume that the document is unusable after the parser has invoked this method, and should continue (if at all) only for the sake of collecting addition error messages: in fact, SAX parsers are free to stop reporting any other events once this method has been invoked.
- Specified by:
fatalError
in interfaceErrorHandler
- Parameters:
exception
- The error information encapsulated in a SAX parse exception.- Throws:
SAXException
- Any SAX exception, possibly wrapping another exception.
-
warning
Receive notification of a warning.SAX parsers will use this method to report conditions that are not errors or fatal errors as defined by the XML 1.0 recommendation. The default behaviour is to take no action.
The SAX parser 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.
- Specified by:
warning
in interfaceErrorListener
- Parameters:
exception
- The warning information encapsulated in a SAX parse exception.- Throws:
TransformerException
- Any SAX exception, possibly wrapping another exception.- See Also:
-
error
Receive notification of a recoverable error.This corresponds to the definition of "error" in section 1.2 of the W3C XML 1.0 Recommendation. For example, a validating parser would use this callback to report the violation of a validity constraint. The default behaviour is to take no action.
The SAX parser 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. If the application cannot do so, then the parser should report a fatal error even if the XML 1.0 recommendation does not require it to do so.
- Specified by:
error
in interfaceErrorListener
- Parameters:
exception
- The error information encapsulated in a SAX parse exception.- Throws:
TransformerException
- Any SAX exception, possibly wrapping another exception.- See Also:
-
fatalError
Receive notification of a non-recoverable error.This corresponds to the definition of "fatal error" in section 1.2 of the W3C XML 1.0 Recommendation. For example, a parser would use this callback to report the violation of a well-formedness constraint.
The application must assume that the document is unusable after the parser has invoked this method, and should continue (if at all) only for the sake of collecting addition error messages: in fact, SAX parsers are free to stop reporting any other events once this method has been invoked.
- Specified by:
fatalError
in interfaceErrorListener
- Parameters:
exception
- The error information encapsulated in a SAX parse exception.- Throws:
TransformerException
- Any SAX exception, possibly wrapping another exception.- See Also:
-
ensureLocationSet
-
printLocation
-
printLocation
-
printLocation
-