| 1 |
768 |
jeremybenn |
<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>
|
