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