+++ /dev/null
-// SAX exception class.\r
-// No warranty; no copyright -- use this as you will.\r
-// $Id: SAXParseException.java,v 1.1 2000/10/02 02:43:17 sboag Exp $\r
-\r
-package org.xml.sax;\r
-\r
-/**\r
- * Encapsulate an XML parse error or warning.\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>This exception will include information for locating the error\r
- * in the original XML document. Note that although the application\r
- * will receive a SAXParseException as the argument to the handlers\r
- * in the {@link org.xml.sax.ErrorHandler ErrorHandler} interface, \r
- * the application is not actually required to throw the exception; \r
- * instead, it can simply read the information in it and take a \r
- * different action.</p>\r
- *\r
- * <p>Since this exception is a subclass of {@link org.xml.sax.SAXException \r
- * SAXException}, it inherits the ability to wrap another exception.</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.SAXException\r
- * @see org.xml.sax.Locator\r
- * @see org.xml.sax.ErrorHandler\r
- */\r
-public class SAXParseException extends SAXException {\r
- \r
- \f\r
- //////////////////////////////////////////////////////////////////////\r
- // Constructors.\r
- //////////////////////////////////////////////////////////////////////\r
-\r
-\r
- /**\r
- * Create a new SAXParseException from a message and a Locator.\r
- *\r
- * <p>This constructor is especially useful when an application is\r
- * creating its own exception from within a {@link org.xml.sax.ContentHandler\r
- * ContentHandler} callback.</p>\r
- *\r
- * @param message The error or warning message.\r
- * @param locator The locator object for the error or warning (may be\r
- * null).\r
- * @see org.xml.sax.Locator\r
- * @see org.xml.sax.Parser#setLocale \r
- */\r
- public SAXParseException (String message, Locator locator) {\r
- super(message);\r
- if (locator != null) {\r
- init(locator.getPublicId(), locator.getSystemId(),\r
- locator.getLineNumber(), locator.getColumnNumber());\r
- } else {\r
- init(null, null, -1, -1);\r
- }\r
- }\r
- \r
- \r
- /**\r
- * Wrap an existing exception in a SAXParseException.\r
- *\r
- * <p>This constructor is especially useful when an application is\r
- * creating its own exception from within a {@link org.xml.sax.ContentHandler\r
- * ContentHandler} callback, and needs to wrap an existing exception that is not a\r
- * subclass of {@link org.xml.sax.SAXException SAXException}.</p>\r
- *\r
- * @param message The error or warning message, or null to\r
- * use the message from the embedded exception.\r
- * @param locator The locator object for the error or warning (may be\r
- * null).\r
- * @param e Any exception.\r
- * @see org.xml.sax.Locator\r
- * @see org.xml.sax.Parser#setLocale\r
- */\r
- public SAXParseException (String message, Locator locator,\r
- Exception e) {\r
- super(message, e);\r
- if (locator != null) {\r
- init(locator.getPublicId(), locator.getSystemId(),\r
- locator.getLineNumber(), locator.getColumnNumber());\r
- } else {\r
- init(null, null, -1, -1);\r
- }\r
- }\r
- \r
- \r
- /**\r
- * Create a new SAXParseException.\r
- *\r
- * <p>This constructor is most useful for parser writers.</p>\r
- *\r
- * <p>If the system identifier is a URL, the parser must resolve it\r
- * fully before creating the exception.</p>\r
- *\r
- * @param message The error or warning message.\r
- * @param publicId The public identifier of the entity that generated\r
- * the error or warning.\r
- * @param systemId The system identifier of the entity that generated\r
- * the error or warning.\r
- * @param lineNumber The line number of the end of the text that\r
- * caused the error or warning.\r
- * @param columnNumber The column number of the end of the text that\r
- * cause the error or warning.\r
- * @see org.xml.sax.Parser#setLocale\r
- */\r
- public SAXParseException (String message, String publicId, String systemId,\r
- int lineNumber, int columnNumber)\r
- {\r
- super(message);\r
- init(publicId, systemId, lineNumber, columnNumber);\r
- }\r
- \r
- \r
- /**\r
- * Create a new SAXParseException with an embedded exception.\r
- *\r
- * <p>This constructor is most useful for parser writers who\r
- * need to wrap an exception that is not a subclass of\r
- * {@link org.xml.sax.SAXException SAXException}.</p>\r
- *\r
- * <p>If the system identifier is a URL, the parser must resolve it\r
- * fully before creating the exception.</p>\r
- *\r
- * @param message The error or warning message, or null to use\r
- * the message from the embedded exception.\r
- * @param publicId The public identifier of the entity that generated\r
- * the error or warning.\r
- * @param systemId The system identifier of the entity that generated\r
- * the error or warning.\r
- * @param lineNumber The line number of the end of the text that\r
- * caused the error or warning.\r
- * @param columnNumber The column number of the end of the text that\r
- * cause the error or warning.\r
- * @param e Another exception to embed in this one.\r
- * @see org.xml.sax.Parser#setLocale\r
- */\r
- public SAXParseException (String message, String publicId, String systemId,\r
- int lineNumber, int columnNumber, Exception e)\r
- {\r
- super(message, e);\r
- init(publicId, systemId, lineNumber, columnNumber);\r
- }\r
-\r
-\r
- /**\r
- * Internal initialization method.\r
- *\r
- * @param publicId The public identifier of the entity which generated the exception,\r
- * or null.\r
- * @param systemId The system identifier of the entity which generated the exception,\r
- * or null.\r
- * @param lineNumber The line number of the error, or -1.\r
- * @param columnNumber The column number of the error, or -1.\r
- */\r
- private void init (String publicId, String systemId,\r
- int lineNumber, int columnNumber)\r
- {\r
- this.publicId = publicId;\r
- this.systemId = systemId;\r
- this.lineNumber = lineNumber;\r
- this.columnNumber = columnNumber;\r
- }\r
- \r
- \r
- /**\r
- * Get the public identifier of the entity where the exception occurred.\r
- *\r
- * @return A string containing the public identifier, or null\r
- * if none is available.\r
- * @see org.xml.sax.Locator#getPublicId\r
- */\r
- public String getPublicId ()\r
- {\r
- return this.publicId;\r
- }\r
- \r
- \r
- /**\r
- * Get the system identifier of the entity where the exception occurred.\r
- *\r
- * <p>If the system identifier is a URL, it will be resolved\r
- * fully.</p>\r
- *\r
- * @return A string containing the system identifier, or null\r
- * if none is available.\r
- * @see org.xml.sax.Locator#getSystemId\r
- */\r
- public String getSystemId ()\r
- {\r
- return this.systemId;\r
- }\r
- \r
- \r
- /**\r
- * The line number of the end of the text where the exception occurred.\r
- *\r
- * @return An integer representing the line number, or -1\r
- * if none is available.\r
- * @see org.xml.sax.Locator#getLineNumber\r
- */\r
- public int getLineNumber ()\r
- {\r
- return this.lineNumber;\r
- }\r
- \r
- \r
- /**\r
- * The column number of the end of the text where the exception occurred.\r
- *\r
- * <p>The first column in a line is position 1.</p>\r
- *\r
- * @return An integer representing the column number, or -1\r
- * if none is available.\r
- * @see org.xml.sax.Locator#getColumnNumber\r
- */\r
- public int getColumnNumber ()\r
- {\r
- return this.columnNumber;\r
- }\r
- \r
- \r
- \f\r
- //////////////////////////////////////////////////////////////////////\r
- // Internal state.\r
- //////////////////////////////////////////////////////////////////////\r
-\r
-\r
- /**\r
- * @serial The public identifier, or null.\r
- * @see #getPublicId\r
- */ \r
- private String publicId;\r
-\r
-\r
- /**\r
- * @serial The system identifier, or null.\r
- * @see #getSystemId\r
- */\r
- private String systemId;\r
-\r
-\r
- /**\r
- * @serial The line number, or -1.\r
- * @see #getLineNumber\r
- */\r
- private int lineNumber;\r
-\r
-\r
- /**\r
- * @serial The column number, or -1.\r
- * @see #getColumnNumber\r
- */\r
- private int columnNumber;\r
- \r
-}\r
-\r
-// end of SAXParseException.java\r