6
|
1 |
<HTML><HEAD>
|
|
2 |
<!-- $Id: package.html,v 1.2 2004/11/03 22:49:09 jsuttor 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>
|