Top Description Methods
com.sun.org.apache.xerces.internal.xni.parser

public Interface XMLErrorHandler

Known Direct Implementers
com.sun.org.apache.xerces.internal.xpointer.XPointerErrorHandler, com.sun.org.apache.xerces.internal.jaxp.validation.ErrorHandlerAdaptor, com.sun.org.apache.xerces.internal.util.DefaultErrorHandler, com.sun.org.apache.xerces.internal.util.DOMErrorHandlerWrapper, com.sun.org.apache.xerces.internal.util.ErrorHandlerWrapper
Imports
com.sun.org.apache.xerces.internal.xni.XNIException

An interface for handling errors. If the application is interested in error notifications, then it can register an error handler object that implements this interface with the parser configuration.
Author
Andy Clark, IBM
See Also
XMLParserConfiguration

Method Summary

Modifier and TypeMethod and Description
public void
error(String
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.
domain
,
String
The error key. This key can be any string and is implementation dependent.
key
,
XMLParseException
Exception.
exception
)

Reports an error.

public void
fatalError(String
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.
domain
,
String
The fatal error key. This key can be any string and is implementation dependent.
key
,
XMLParseException
Exception.
exception
)

Report a fatal error.

public void
warning(String
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.
domain
,
String
The warning key. This key can be any string and is implementation dependent.
key
,
XMLParseException
Exception.
exception
)

Reports a warning.

Method Detail

errorback to summary
public void error(String domain, String key, XMLParseException exception) throws XNIException

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

Parameters
domain:String

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:String

The error key. This key can be any string and is implementation dependent.

exception:XMLParseException

Exception.

Exceptions
XNIException:
Thrown to signal that the parser should stop parsing the document.
fatalErrorback to summary
public void fatalError(String domain, String key, XMLParseException exception) throws XNIException

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:String

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:String

The fatal error key. This key can be any string and is implementation dependent.

exception:XMLParseException

Exception.

Exceptions
XNIException:
Thrown to signal that the parser should stop parsing the document.
warningback to summary
public void warning(String domain, String key, XMLParseException exception) throws XNIException

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

Parameters
domain:String

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:String

The warning key. This key can be any string and is implementation dependent.

exception:XMLParseException

Exception.

Exceptions
XNIException:
Thrown to signal that the parser should stop parsing the document.