src/org/xml/sax/helpers/XMLReaderAdapter.java

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


  51 
  52 
  53 /**
  54  * Adapt a SAX2 XMLReader as a SAX1 Parser.
  55  *
  56  * <blockquote>
  57  * <em>This module, both source code and documentation, is in the
  58  * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
  59  * See <a href='http://www.saxproject.org'>http://www.saxproject.org</a>
  60  * for further information.
  61  * </blockquote>
  62  *
  63  * <p>This class wraps a SAX2 {@link org.xml.sax.XMLReader XMLReader}
  64  * and makes it act as a SAX1 {@link org.xml.sax.Parser Parser}.  The XMLReader
  65  * must support a true value for the
  66  * http://xml.org/sax/features/namespace-prefixes property or parsing will fail
  67  * with a {@link org.xml.sax.SAXException SAXException}; if the XMLReader
  68  * supports a false value for the http://xml.org/sax/features/namespaces
  69  * property, that will also be used to improve efficiency.</p>
  70  *
  71  * @since SAX 2.0
  72  * @author David Megginson
  73  * @see org.xml.sax.Parser
  74  * @see org.xml.sax.XMLReader
  75  */
  76 public class XMLReaderAdapter implements Parser, ContentHandler
  77 {
  78 
  79 
  80     ////////////////////////////////////////////////////////////////////
  81     // Constructor.
  82     ////////////////////////////////////////////////////////////////////
  83 
  84 
  85     /**
  86      * Create a new adapter.
  87      *
  88      * <p>Use the "org.xml.sax.driver" property to locate the SAX2
  89      * driver to embed.</p>
  90      *
  91      * @exception org.xml.sax.SAXException If the embedded driver




  51 
  52 
  53 /**
  54  * Adapt a SAX2 XMLReader as a SAX1 Parser.
  55  *
  56  * <blockquote>
  57  * <em>This module, both source code and documentation, is in the
  58  * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
  59  * See <a href='http://www.saxproject.org'>http://www.saxproject.org</a>
  60  * for further information.
  61  * </blockquote>
  62  *
  63  * <p>This class wraps a SAX2 {@link org.xml.sax.XMLReader XMLReader}
  64  * and makes it act as a SAX1 {@link org.xml.sax.Parser Parser}.  The XMLReader
  65  * must support a true value for the
  66  * http://xml.org/sax/features/namespace-prefixes property or parsing will fail
  67  * with a {@link org.xml.sax.SAXException SAXException}; if the XMLReader
  68  * supports a false value for the http://xml.org/sax/features/namespaces
  69  * property, that will also be used to improve efficiency.</p>
  70  *
  71  * @since 1.4, SAX 2.0
  72  * @author David Megginson
  73  * @see org.xml.sax.Parser
  74  * @see org.xml.sax.XMLReader
  75  */
  76 public class XMLReaderAdapter implements Parser, ContentHandler
  77 {
  78 
  79 
  80     ////////////////////////////////////////////////////////////////////
  81     // Constructor.
  82     ////////////////////////////////////////////////////////////////////
  83 
  84 
  85     /**
  86      * Create a new adapter.
  87      *
  88      * <p>Use the "org.xml.sax.driver" property to locate the SAX2
  89      * driver to embed.</p>
  90      *
  91      * @exception org.xml.sax.SAXException If the embedded driver