Package org.apache.xerces.util
Class ErrorHandlerWrapper
java.lang.Object
org.apache.xerces.util.ErrorHandlerWrapper
- All Implemented Interfaces:
org.apache.xerces.xni.parser.XMLErrorHandler
public class ErrorHandlerWrapper
extends Object
implements org.apache.xerces.xni.parser.XMLErrorHandler
This class wraps a SAX error handler in an XNI error handler.
- Version:
- $Id: ErrorHandlerWrapper.java 447241 2006-09-18 05:12:57Z mrglavas $
- Author:
- Andy Clark, IBM
- See Also:
-
Field Summary
Fields -
Constructor Summary
ConstructorsConstructorDescriptionDefault constructor.ErrorHandlerWrapper
(ErrorHandler errorHandler) Wraps the specified SAX error handler. -
Method Summary
Modifier and TypeMethodDescriptionprotected static SAXParseException
createSAXParseException
(org.apache.xerces.xni.parser.XMLParseException exception) Creates a SAXParseException from an XMLParseException.protected static org.apache.xerces.xni.parser.XMLParseException
createXMLParseException
(SAXParseException exception) Creates an XMLParseException from a SAXParseException.protected static org.apache.xerces.xni.XNIException
createXNIException
(SAXException exception) Creates an XNIException from a SAXException.void
Reports an error.void
fatalError
(String domain, String key, org.apache.xerces.xni.parser.XMLParseException exception) Report a fatal error.Returns the SAX error handler.void
setErrorHandler
(ErrorHandler errorHandler) Sets the SAX error handler.void
Reports a warning.
-
Field Details
-
fErrorHandler
The SAX error handler.
-
-
Constructor Details
-
ErrorHandlerWrapper
public ErrorHandlerWrapper()Default constructor. -
ErrorHandlerWrapper
Wraps the specified SAX error handler.
-
-
Method Details
-
setErrorHandler
Sets the SAX error handler. -
getErrorHandler
Returns the SAX error handler. -
warning
public void warning(String domain, String key, org.apache.xerces.xni.parser.XMLParseException exception) throws org.apache.xerces.xni.XNIException Reports a warning. Warnings are non-fatal and can be safely ignored by most applications.- Specified by:
warning
in interfaceorg.apache.xerces.xni.parser.XMLErrorHandler
- 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:
org.apache.xerces.xni.XNIException
- Thrown to signal that the parser should stop parsing the document.
-
error
public void error(String domain, String key, org.apache.xerces.xni.parser.XMLParseException exception) throws org.apache.xerces.xni.XNIException Reports an error. Errors are non-fatal and usually signify that the document is invalid with respect to its grammar(s).- Specified by:
error
in interfaceorg.apache.xerces.xni.parser.XMLErrorHandler
- 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:
org.apache.xerces.xni.XNIException
- Thrown to signal that the parser should stop parsing the document.
-
fatalError
public void fatalError(String domain, String key, org.apache.xerces.xni.parser.XMLParseException exception) throws org.apache.xerces.xni.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.- Specified by:
fatalError
in interfaceorg.apache.xerces.xni.parser.XMLErrorHandler
- 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:
org.apache.xerces.xni.XNIException
- Thrown to signal that the parser should stop parsing the document.
-
createSAXParseException
protected static SAXParseException createSAXParseException(org.apache.xerces.xni.parser.XMLParseException exception) Creates a SAXParseException from an XMLParseException. -
createXMLParseException
protected static org.apache.xerces.xni.parser.XMLParseException createXMLParseException(SAXParseException exception) Creates an XMLParseException from a SAXParseException. -
createXNIException
Creates an XNIException from a SAXException. NOTE: care should be taken *not* to call this with a SAXParseException; this will lose information!!!
-