|
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> |