Top Description Fields Constructors Methods
com.sun.org.apache.xerces.internal.util

public Class ErrorHandlerWrapper

extends Object
implements XMLErrorHandler
Class Inheritance
All Implemented Interfaces
com.sun.org.apache.xerces.internal.xni.parser.XMLErrorHandler
Known Direct Subclasses
com.sun.org.apache.xerces.internal.impl.xs.traversers.XSDHandler.SAX2XNIUtil
Imports
com.sun.org.apache.xerces.internal.xni.XMLLocator, .XNIException, com.sun.org.apache.xerces.internal.xni.parser.XMLErrorHandler, .XMLParseException, org.xml.sax.ErrorHandler, .SAXException, .SAXParseException

This class wraps a SAX error handler in an XNI error handler.
Author
Andy Clark, IBM
See Also
ErrorHandler

Field Summary

Modifier and TypeField and Description
protected ErrorHandler
fErrorHandler

The SAX error handler.

Constructor Summary

AccessConstructor and Description
public
ErrorHandlerWrapper()

Default constructor.

public
ErrorHandlerWrapper(ErrorHandler errorHandler)

Wraps the specified SAX error handler.

Method Summary

Modifier and TypeMethod and Description
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.

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
)

Implements com.sun.org.apache.xerces.internal.xni.parser.XMLErrorHandler.error.

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
)

Implements com.sun.org.apache.xerces.internal.xni.parser.XMLErrorHandler.fatalError.

Report a fatal error.

public ErrorHandler
getErrorHandler()

Returns the SAX error handler.

public void
setErrorHandler(ErrorHandler errorHandler)

Sets the SAX error handler.

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
)

Implements com.sun.org.apache.xerces.internal.xni.parser.XMLErrorHandler.warning.

Reports a warning.

Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Field Detail

fErrorHandlerback to summary
protected ErrorHandler fErrorHandler

The SAX error handler.

Constructor Detail

ErrorHandlerWrapperback to summary
public ErrorHandlerWrapper()

Default constructor.

ErrorHandlerWrapperback to summary
public ErrorHandlerWrapper(ErrorHandler errorHandler)

Wraps the specified SAX error handler.

Method Detail

createSAXParseExceptionback to summary
protected static SAXParseException createSAXParseException(XMLParseException exception)

Creates a SAXParseException from an XMLParseException.

createXMLParseExceptionback to summary
protected static XMLParseException createXMLParseException(SAXParseException exception)

Creates an XMLParseException from a SAXParseException.

createXNIExceptionback to summary
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!!!

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

Implements com.sun.org.apache.xerces.internal.xni.parser.XMLErrorHandler.error.

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

Implements com.sun.org.apache.xerces.internal.xni.parser.XMLErrorHandler.fatalError.

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.
getErrorHandlerback to summary
public ErrorHandler getErrorHandler()

Returns the SAX error handler.

setErrorHandlerback to summary
public void setErrorHandler(ErrorHandler errorHandler)

Sets the SAX error handler.

warningback to summary
public void warning(String domain, String key, XMLParseException exception) throws XNIException

Implements com.sun.org.apache.xerces.internal.xni.parser.XMLErrorHandler.warning.

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.