Module org.htmlunit.cyberneko
Package org.htmlunit.cyberneko.xerces.util

Class ErrorHandlerWrapper

java.lang.Object
org.htmlunit.cyberneko.xerces.util.ErrorHandlerWrapper
All Implemented Interfaces:
XMLErrorHandler
public class ErrorHandlerWrapper extends Object implements XMLErrorHandler
Wraps a SAX error handler in an XNI error handler.
Author:
Andy Clark, IBM, Ronald Brill
See Also:

  • Constructor Details

    • ErrorHandlerWrapper

      public ErrorHandlerWrapper(ErrorHandler errorHandler)
      Constructs a wrapper for the specified SAX error handler.
      Parameters:
      errorHandler - the SAX error handler to wrap

  • Method Details

    • setErrorHandler

      public void setErrorHandler(ErrorHandler errorHandler)
      Sets the SAX error handler.
      Parameters:
      errorHandler - the new SAX error handler

    • getErrorHandler

      public ErrorHandler getErrorHandler()
      Returns the registered SAX error handler.
      Returns:
      the SAX error handler, or null if none is set

    • warning

      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.
      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 website location of the relevant specification or document pertaining to this warning.
      key - the warning key. This key can be any string and is implementation dependent.
      exception - the XML parse exception containing location details
      Throws:
      XNIException - thrown to signal that the parser should stop parsing the document

    • error

      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).
      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 website location of the relevant specification or document pertaining to this error.
      key - the error key. This key can be any string and is implementation dependent.
      exception - the XML parse exception containing location details
      Throws:
      XNIException - thrown to signal that the parser should stop parsing the document

    • fatalError

      public void fatalError(String domain, String key, XMLParseException exception) throws XNIException
      Reports a fatal error. Fatal errors usually occur when the document is not well-formed and signify 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 website location of the relevant specification or document pertaining to this fatal error.
      key - the fatal error key. This key can be any string and is implementation dependent.
      exception - the XML parse exception containing location details
      Throws:
      XNIException - thrown to signal that the parser should stop parsing the document

    • createSAXParseException

      protected static SAXParseException createSAXParseException(XMLParseException exception)
      Creates a SAXParseException from an XMLParseException.
      Parameters:
      exception - the XML parse exception
      Returns:
      the corresponding SAX parse exception

    • createXMLParseException

      protected static XMLParseException createXMLParseException(SAXParseException exception)
      Creates an XMLParseException from a SAXParseException.
      Parameters:
      exception - the SAX parse exception
      Returns:
      the corresponding XML parse exception

    • createXNIException

      protected static XNIException createXNIException(SAXException exception)
      Creates an XNIException from a SAXException.

      Note: Care should be taken not to call this with a SAXParseException; doing so will lose location information.

      Parameters:
      exception - the SAX exception
      Returns:
      the corresponding XNI exception