Class ErrorHandlerWrapper

  • All Implemented Interfaces:
    XMLErrorHandler

    public class ErrorHandlerWrapper
    extends java.lang.Object
    implements XMLErrorHandler
    This class wraps a SAX error handler in an XNI error handler.
    See Also:
    ErrorHandler
    • Field Detail

      • fErrorHandler_

        private org.xml.sax.ErrorHandler fErrorHandler_
        The SAX error handler.
    • Constructor Detail

      • ErrorHandlerWrapper

        public ErrorHandlerWrapper​(org.xml.sax.ErrorHandler errorHandler)
    • Method Detail

      • setErrorHandler

        public void setErrorHandler​(org.xml.sax.ErrorHandler errorHandler)
      • getErrorHandler

        public org.xml.sax.ErrorHandler getErrorHandler()
        Returns:
        the SAX error handler.
      • warning

        public void warning​(java.lang.String domain,
                            java.lang.String key,
                            XMLParseException exception)
                     throws XNIException
        Reports a warning. Warnings are non-fatal and can be safely ignored by most applications.
        Specified by:
        warning in interface 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:
        XNIException - Thrown to signal that the parser should stop parsing the document.
      • error

        public void error​(java.lang.String domain,
                          java.lang.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).
        Specified by:
        error in interface 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:
        XNIException - Thrown to signal that the parser should stop parsing the document.
      • fatalError

        public void fatalError​(java.lang.String domain,
                               java.lang.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.

        Specified by:
        fatalError in interface 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:
        XNIException - Thrown to signal that the parser should stop parsing the document.
      • createSAXParseException

        protected static org.xml.sax.SAXParseException createSAXParseException​(XMLParseException exception)
      • createXMLParseException

        protected static XMLParseException createXMLParseException​(org.xml.sax.SAXParseException exception)
      • createXNIException

        protected static XNIException createXNIException​(org.xml.sax.SAXException exception)