lib/classpath/external/sax/org/xml/sax/ext/package.html

   1 <HTML><HEAD>
   2 <!-- $Id: package.html,v 1.1 2004/12/23 22:38:42 mark Exp $ -->
   3 </HEAD><BODY>
   4
   5 <p>
   6 This package contains interfaces to SAX2 facilities that
   7 conformant SAX drivers won't necessarily support.
   8
   9 <p>See <a href='http://www.saxproject.org'>http://www.saxproject.org</a>
  10 for more information about SAX.</p>
  11
  12 <p> This package is independent of the SAX2 core, though the functionality
  13 exposed generally needs to be implemented within a parser core.
  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 </li>
  20
  21 <li>You cannot assume that the class files will be present in every SAX2
  22 installation.</li>
  23
  24 <li>This package may be updated independently of SAX2 (i.e. new
  25 handlers and classes may be added without updating SAX2 itself).</li>
  26
  27 <li>The new handlers are not implemented by the SAX2
  28 <code>org.xml.sax.helpers.DefaultHandler</code> or
  29 <code>org.xml.sax.helpers.XMLFilterImpl</code> classes.
  30 You can subclass these if you need such behavior, or
  31 use the helper classes found here.</li>
  32
  33 <li>The handlers need to be registered differently than core SAX2
  34 handlers.</li>
  35
  36 </ul>
  37
  38 <p>This package, SAX2-ext, is a standardized extension to SAX2.  It is
  39 designed both to allow SAX parsers to pass certain types of information
  40 to applications, and to serve as a simple model for other SAX2 parser
  41 extension packages.  Not all such extension packages should need to
  42 be recognized directly by parsers, however.
  43 As an example, most validation systems can be cleanly layered on top
  44 of parsers supporting the standardized SAX2 interfaces.  </p>
  45
  46 </BODY></HTML>