src/org/xml/sax/SAXParseException.java

Print this page
rev 602 : 8047723: @since tag cleanup in jaxp
Reviewed-by:


  35  *
  36  * <blockquote>
  37  * <em>This module, both source code and documentation, is in the
  38  * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
  39  * See <a href='http://www.saxproject.org'>http://www.saxproject.org</a>
  40  * for further information.
  41  * </blockquote>
  42  *
  43  * <p>This exception may include information for locating the error
  44  * in the original XML document, as if it came from a {@link Locator}
  45  * object.  Note that although the application
  46  * will receive a SAXParseException as the argument to the handlers
  47  * in the {@link org.xml.sax.ErrorHandler ErrorHandler} interface,
  48  * the application is not actually required to throw the exception;
  49  * instead, it can simply read the information in it and take a
  50  * different action.</p>
  51  *
  52  * <p>Since this exception is a subclass of {@link org.xml.sax.SAXException
  53  * SAXException}, it inherits the ability to wrap another exception.</p>
  54  *
  55  * @since SAX 1.0
  56  * @author David Megginson
  57  * @version 2.0.1 (sax2r2)
  58  * @see org.xml.sax.SAXException
  59  * @see org.xml.sax.Locator
  60  * @see org.xml.sax.ErrorHandler
  61  */
  62 public class SAXParseException extends SAXException {
  63 
  64 
  65     //////////////////////////////////////////////////////////////////////
  66     // Constructors.
  67     //////////////////////////////////////////////////////////////////////
  68 
  69 
  70     /**
  71      * Create a new SAXParseException from a message and a Locator.
  72      *
  73      * <p>This constructor is especially useful when an application is
  74      * creating its own exception from within a {@link org.xml.sax.ContentHandler
  75      * ContentHandler} callback.</p>




  35  *
  36  * <blockquote>
  37  * <em>This module, both source code and documentation, is in the
  38  * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
  39  * See <a href='http://www.saxproject.org'>http://www.saxproject.org</a>
  40  * for further information.
  41  * </blockquote>
  42  *
  43  * <p>This exception may include information for locating the error
  44  * in the original XML document, as if it came from a {@link Locator}
  45  * object.  Note that although the application
  46  * will receive a SAXParseException as the argument to the handlers
  47  * in the {@link org.xml.sax.ErrorHandler ErrorHandler} interface,
  48  * the application is not actually required to throw the exception;
  49  * instead, it can simply read the information in it and take a
  50  * different action.</p>
  51  *
  52  * <p>Since this exception is a subclass of {@link org.xml.sax.SAXException
  53  * SAXException}, it inherits the ability to wrap another exception.</p>
  54  *
  55  * @since 1.4, SAX 1.0
  56  * @author David Megginson
  57  * @version 2.0.1 (sax2r2)
  58  * @see org.xml.sax.SAXException
  59  * @see org.xml.sax.Locator
  60  * @see org.xml.sax.ErrorHandler
  61  */
  62 public class SAXParseException extends SAXException {
  63 
  64 
  65     //////////////////////////////////////////////////////////////////////
  66     // Constructors.
  67     //////////////////////////////////////////////////////////////////////
  68 
  69 
  70     /**
  71      * Create a new SAXParseException from a message and a Locator.
  72      *
  73      * <p>This constructor is especially useful when an application is
  74      * creating its own exception from within a {@link org.xml.sax.ContentHandler
  75      * ContentHandler} callback.</p>