286N/A<HTML><HEAD>
286N/A<!-- $Id: package.html,v 1.3 2007/10/02 19:32:24 ndw Exp $ -->
286N/A</HEAD><BODY>
286N/A
286N/A<p>
286N/AThis package contains interfaces to SAX2 facilities that
286N/Aconformant SAX drivers won't necessarily support.
286N/A
286N/A<p>See <a target='_top' href='http://www.saxproject.org'>http://www.saxproject.org</a>
286N/Afor more information about SAX.</p>
286N/A
286N/A<p> This package is independent of the SAX2 core, though the functionality
286N/Aexposed generally needs to be implemented within a parser core.
286N/AThat independence has several consequences:</p>
286N/A
286N/A<ul>
286N/A
286N/A<li>SAX2 drivers are <em>not</em> required to recognize these handlers.
286N/A</li>
286N/A
286N/A<li>You cannot assume that the class files will be present in every SAX2
286N/Ainstallation.</li>
286N/A
286N/A<li>This package may be updated independently of SAX2 (i.e. new
286N/Ahandlers and classes may be added without updating SAX2 itself).</li>
286N/A
286N/A<li>The new handlers are not implemented by the SAX2
286N/A<code>org.xml.sax.helpers.DefaultHandler</code> or
286N/A<code>org.xml.sax.helpers.XMLFilterImpl</code> classes.
286N/AYou can subclass these if you need such behavior, or
286N/Ause the helper classes found here.</li>
286N/A
286N/A<li>The handlers need to be registered differently than core SAX2
286N/Ahandlers.</li>
286N/A
286N/A</ul>
286N/A
286N/A<p>This package, SAX2-ext, is a standardized extension to SAX2. It is
286N/Adesigned both to allow SAX parsers to pass certain types of information
286N/Ato applications, and to serve as a simple model for other SAX2 parser
286N/Aextension packages. Not all such extension packages should need to
286N/Abe recognized directly by parsers, however.
286N/AAs an example, most validation systems can be cleanly layered on top
286N/Aof parsers supporting the standardized SAX2 interfaces. </p>
286N/A
286N/A</BODY></HTML>