public class

ErrorHandlerWrapper

extends Object
implements XMLErrorHandler
java.lang.Object
   ↳ org.apache.xerces.util.ErrorHandlerWrapper

Class Overview

This class wraps a SAX error handler in an XNI error handler.

See Also
  • ErrorHandler

Summary

Fields
protected ErrorHandler fErrorHandler The SAX error handler.
Public Constructors
ErrorHandlerWrapper()
Default constructor.
ErrorHandlerWrapper(ErrorHandler errorHandler)
Wraps the specified SAX error handler.
Public Methods
void error(String domain, String key, XMLParseException exception)
Reports an error.
void fatalError(String domain, String key, XMLParseException exception)
Report a fatal error.
ErrorHandler getErrorHandler()
Returns the SAX error handler.
void setErrorHandler(ErrorHandler errorHandler)
Sets the SAX error handler.
void warning(String domain, String key, XMLParseException exception)
Reports a warning.
Protected Methods
static SAXParseException createSAXParseException(XMLParseException exception)
Creates a SAXParseException from an XMLParseException.
static XMLParseException createXMLParseException(SAXParseException exception)
Creates an XMLParseException from a SAXParseException.
static XNIException createXNIException(SAXException exception)
Creates an XNIException from a SAXException.
[Expand]
Inherited Methods
From class java.lang.Object
From interface org.apache.xerces.xni.parser.XMLErrorHandler

Fields

protected ErrorHandler fErrorHandler

The SAX error handler.

Public Constructors

public ErrorHandlerWrapper ()

Default constructor.

public ErrorHandlerWrapper (ErrorHandler errorHandler)

Wraps the specified SAX error handler.

Public Methods

public void error (String domain, String key, XMLParseException exception)

Reports an error. Errors are non-fatal and usually signify that the document is invalid with respect to its grammar(s).

Parameters
domain The domain of the error. The domain can be any string but is suggested to be a valid URI. The domain can be used to conveniently specify a web site location of the relevent specification or document pertaining to this error.
key The error key. This key can be any string and is implementation dependent.
exception Exception.
Throws
XNIException Thrown to signal that the parser should stop parsing the document.

public void fatalError (String domain, String key, XMLParseException exception)

Report a fatal error. Fatal errors usually occur when the document is not well-formed and signifies that the parser cannot continue normal operation.

Note: The error handler should always throw an XNIException from this method. This exception can either be the same exception that is passed as a parameter to the method or a new XNI exception object. If the registered error handler fails to throw an exception, the continuing operation of the parser is undetermined.

Parameters
domain The domain of the fatal error. The domain can be any string but is suggested to be a valid URI. The domain can be used to conveniently specify a web site location of the relevent specification or document pertaining to this fatal error.
key The fatal error key. This key can be any string and is implementation dependent.
exception Exception.
Throws
XNIException Thrown to signal that the parser should stop parsing the document.

public ErrorHandler getErrorHandler ()

Returns the SAX error handler.

public void setErrorHandler (ErrorHandler errorHandler)

Sets the SAX error handler.

public void warning (String domain, String key, XMLParseException exception)

Reports a warning. Warnings are non-fatal and can be safely ignored by most applications.

Parameters
domain The domain of the warning. The domain can be any string but is suggested to be a valid URI. The domain can be used to conveniently specify a web site location of the relevent specification or document pertaining to this warning.
key The warning key. This key can be any string and is implementation dependent.
exception Exception.
Throws
XNIException Thrown to signal that the parser should stop parsing the document.

Protected Methods

protected static SAXParseException createSAXParseException (XMLParseException exception)

Creates a SAXParseException from an XMLParseException.

protected static XMLParseException createXMLParseException (SAXParseException exception)

Creates an XMLParseException from a SAXParseException.

protected static XNIException createXNIException (SAXException exception)

Creates an XNIException from a SAXException. NOTE: care should be taken *not* to call this with a SAXParseException; this will lose information!!!