+++ /dev/null
-// SAX error handler.\r
-// No warranty; no copyright -- use this as you will.\r
-// $Id: ErrorHandler.java,v 1.1 2000/10/02 02:43:17 sboag Exp $\r
-\r
-package org.xml.sax;\r
-\r
-\r
-/**\r
- * Basic interface for SAX error handlers.\r
- *\r
- * <blockquote>\r
- * <em>This module, both source code and documentation, is in the\r
- * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>\r
- * </blockquote>\r
- *\r
- * <p>If a SAX application needs to implement customized error\r
- * handling, it must implement this interface and then register an\r
- * instance with the XML reader using the\r
- * {@link org.xml.sax.XMLReader#setErrorHandler setErrorHandler}\r
- * method. The parser will then report all errors and warnings\r
- * through this interface.</p>\r
- *\r
- * <p><strong>WARNING:</strong> If an application does <em>not</em>\r
- * register an ErrorHandler, XML parsing errors will go unreported\r
- * and bizarre behaviour may result.</p>\r
- *\r
- * <p>For XML processing errors, a SAX driver must use this interface \r
- * instead of throwing an exception: it is up to the application \r
- * to decide whether to throw an exception for different types of \r
- * errors and warnings. Note, however, that there is no requirement that \r
- * the parser continue to provide useful information after a call to \r
- * {@link #fatalError fatalError} (in other words, a SAX driver class \r
- * could catch an exception and report a fatalError).</p>\r
- *\r
- * @since SAX 1.0\r
- * @author David Megginson, \r
- * <a href="mailto:sax@megginson.com">sax@megginson.com</a>\r
- * @version 2.0\r
- * @see org.xml.sax.Parser#setErrorHandler\r
- * @see org.xml.sax.SAXParseException \r
- */\r
-public interface ErrorHandler {\r
- \r
- \r
- /**\r
- * Receive notification of a warning.\r
- *\r
- * <p>SAX parsers will use this method to report conditions that\r
- * are not errors or fatal errors as defined by the XML 1.0\r
- * recommendation. The default behaviour is to take no action.</p>\r
- *\r
- * <p>The SAX parser must continue to provide normal parsing events\r
- * after invoking this method: it should still be possible for the\r
- * application to process the document through to the end.</p>\r
- *\r
- * <p>Filters may use this method to report other, non-XML warnings\r
- * as well.</p>\r
- *\r
- * @param exception The warning information encapsulated in a\r
- * SAX parse exception.\r
- * @exception org.xml.sax.SAXException Any SAX exception, possibly\r
- * wrapping another exception.\r
- * @see org.xml.sax.SAXParseException \r
- */\r
- public abstract void warning (SAXParseException exception)\r
- throws SAXException;\r
- \r
- \r
- /**\r
- * Receive notification of a recoverable error.\r
- *\r
- * <p>This corresponds to the definition of "error" in section 1.2\r
- * of the W3C XML 1.0 Recommendation. For example, a validating\r
- * parser would use this callback to report the violation of a\r
- * validity constraint. The default behaviour is to take no\r
- * action.</p>\r
- *\r
- * <p>The SAX parser must continue to provide normal parsing events\r
- * after invoking this method: it should still be possible for the\r
- * application to process the document through to the end. If the\r
- * application cannot do so, then the parser should report a fatal\r
- * error even if the XML 1.0 recommendation does not require it to\r
- * do so.</p>\r
- *\r
- * <p>Filters may use this method to report other, non-XML errors\r
- * as well.</p>\r
- *\r
- * @param exception The error information encapsulated in a\r
- * SAX parse exception.\r
- * @exception org.xml.sax.SAXException Any SAX exception, possibly\r
- * wrapping another exception.\r
- * @see org.xml.sax.SAXParseException \r
- */\r
- public abstract void error (SAXParseException exception)\r
- throws SAXException;\r
- \r
- \r
- /**\r
- * Receive notification of a non-recoverable error.\r
- *\r
- * <p>This corresponds to the definition of "fatal error" in\r
- * section 1.2 of the W3C XML 1.0 Recommendation. For example, a\r
- * parser would use this callback to report the violation of a\r
- * well-formedness constraint.</p>\r
- *\r
- * <p>The application must assume that the document is unusable\r
- * after the parser has invoked this method, and should continue\r
- * (if at all) only for the sake of collecting addition error\r
- * messages: in fact, SAX parsers are free to stop reporting any\r
- * other events once this method has been invoked.</p>\r
- *\r
- * @param exception The error information encapsulated in a\r
- * SAX parse exception. \r
- * @exception org.xml.sax.SAXException Any SAX exception, possibly\r
- * wrapping another exception.\r
- * @see org.xml.sax.SAXParseException\r
- */\r
- public abstract void fatalError (SAXParseException exception)\r
- throws SAXException;\r
- \r
-}\r
-\r
-// end of ErrorHandler.java\r