libjava/org/xml/sax/ext/package.html

   1 <HTML><HEAD>
   2
   3 </HEAD><BODY>
   4
   5 <p>
   6 This package contains interfaces to optional SAX2 handlers.
   7
   8 <p>See <a href='http://www.saxproject.org'>http://www.saxproject.org</a>
   9 for more information about SAX.</p>
  10
  11 <p>
  12 The package is independent of the SAX2 core, though the functionality
  13 exposed generally needs to be implemented within a parser.
  14 That independence has several consequences:</p>
  15
  16 <ul>
  17
  18 <li>SAX2 drivers are <em>not</em> required to recognize these handlers,
  19 and you cannot assume that the class files will be present in every SAX2
  20 installation.</li>
  21
  22 <li>This package may be updated independently of SAX2 (i.e. new
  23 handlers may be added without updating SAX2 itself).</li>
  24
  25 <li>The handlers are not implemented by the SAX2
  26 <code>org.xml.sax.helpers.DefaultHandler</code> or
  27 <code>org.xml.sax.helpers.XMLFilterImpl</code> classes.
  28 You can subclass these if you need such behaviour.</li>
  29
  30 <li>The handlers need to be registered differently than regular SAX2
  31 handlers.</li>
  32
  33 </ul>
  34
  35 <p>This package, SAX2-ext, is a standardized extension to SAX2.  It is
  36 designed both to allow SAX parsers to pass certain types of information
  37 to applications, and to serve as a simple model for other SAX2 parser
  38 extension packages.  Not all such extension packages should need to
  39 be recognized directly by parsers, however.
  40 As an example, most schema systems can be cleanly layered on top
  41 of parsers supporting the standardized SAX2 interfaces.  </p>
  42
  43 <p><strong>NOTE:</strong> this package alone does add any
  44 functionality; it simply provides optional interfaces for SAX2 drivers
  45 to use.  You must use a SAX2 driver that recognizes these interfaces if
  46 you actually want to have access to lexical and declaration
  47 information.</p>
  48
  49 </BODY></HTML>