jaxp/src/share/classes/org/xml/sax/ext/package.html
author ohair
Mon, 14 Apr 2008 14:52:27 -0700
changeset 311 3c14f21bf3f7
parent 6 7f561c08de6b
permissions -rw-r--r--
6484686: The next directory looks like it is no longer part of the build (deploy makefiles) Summary: Getting rid of the _OUTPUTDIR settings. Using BUILD_PARENT_DIRECTORY instead. This solves problems with the "/build/windows-i586*" paths getting mangled on Windows builds (fastdebug builds in particular). Reviewed-by: tbell
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
6
7f561c08de6b Initial load
duke
parents:
diff changeset
     1
<HTML><HEAD>
7f561c08de6b Initial load
duke
parents:
diff changeset
     2
<!-- $Id: package.html,v 1.2 2004/11/03 22:49:09 jsuttor Exp $ -->
7f561c08de6b Initial load
duke
parents:
diff changeset
     3
</HEAD><BODY>
7f561c08de6b Initial load
duke
parents:
diff changeset
     4
7f561c08de6b Initial load
duke
parents:
diff changeset
     5
<p>
7f561c08de6b Initial load
duke
parents:
diff changeset
     6
This package contains interfaces to SAX2 facilities that
7f561c08de6b Initial load
duke
parents:
diff changeset
     7
conformant SAX drivers won't necessarily support.
7f561c08de6b Initial load
duke
parents:
diff changeset
     8
7f561c08de6b Initial load
duke
parents:
diff changeset
     9
<p>See <a href='http://www.saxproject.org'>http://www.saxproject.org</a>
7f561c08de6b Initial load
duke
parents:
diff changeset
    10
for more information about SAX.</p>
7f561c08de6b Initial load
duke
parents:
diff changeset
    11
7f561c08de6b Initial load
duke
parents:
diff changeset
    12
<p> This package is independent of the SAX2 core, though the functionality
7f561c08de6b Initial load
duke
parents:
diff changeset
    13
exposed generally needs to be implemented within a parser core.
7f561c08de6b Initial load
duke
parents:
diff changeset
    14
That independence has several consequences:</p>
7f561c08de6b Initial load
duke
parents:
diff changeset
    15
7f561c08de6b Initial load
duke
parents:
diff changeset
    16
<ul>
7f561c08de6b Initial load
duke
parents:
diff changeset
    17
7f561c08de6b Initial load
duke
parents:
diff changeset
    18
<li>SAX2 drivers are <em>not</em> required to recognize these handlers.
7f561c08de6b Initial load
duke
parents:
diff changeset
    19
</li>
7f561c08de6b Initial load
duke
parents:
diff changeset
    20
7f561c08de6b Initial load
duke
parents:
diff changeset
    21
<li>You cannot assume that the class files will be present in every SAX2
7f561c08de6b Initial load
duke
parents:
diff changeset
    22
installation.</li>
7f561c08de6b Initial load
duke
parents:
diff changeset
    23
7f561c08de6b Initial load
duke
parents:
diff changeset
    24
<li>This package may be updated independently of SAX2 (i.e. new
7f561c08de6b Initial load
duke
parents:
diff changeset
    25
handlers and classes may be added without updating SAX2 itself).</li>
7f561c08de6b Initial load
duke
parents:
diff changeset
    26
7f561c08de6b Initial load
duke
parents:
diff changeset
    27
<li>The new handlers are not implemented by the SAX2
7f561c08de6b Initial load
duke
parents:
diff changeset
    28
<code>org.xml.sax.helpers.DefaultHandler</code> or
7f561c08de6b Initial load
duke
parents:
diff changeset
    29
<code>org.xml.sax.helpers.XMLFilterImpl</code> classes.
7f561c08de6b Initial load
duke
parents:
diff changeset
    30
You can subclass these if you need such behavior, or
7f561c08de6b Initial load
duke
parents:
diff changeset
    31
use the helper classes found here.</li>
7f561c08de6b Initial load
duke
parents:
diff changeset
    32
7f561c08de6b Initial load
duke
parents:
diff changeset
    33
<li>The handlers need to be registered differently than core SAX2
7f561c08de6b Initial load
duke
parents:
diff changeset
    34
handlers.</li>
7f561c08de6b Initial load
duke
parents:
diff changeset
    35
7f561c08de6b Initial load
duke
parents:
diff changeset
    36
</ul>
7f561c08de6b Initial load
duke
parents:
diff changeset
    37
7f561c08de6b Initial load
duke
parents:
diff changeset
    38
<p>This package, SAX2-ext, is a standardized extension to SAX2.  It is
7f561c08de6b Initial load
duke
parents:
diff changeset
    39
designed both to allow SAX parsers to pass certain types of information
7f561c08de6b Initial load
duke
parents:
diff changeset
    40
to applications, and to serve as a simple model for other SAX2 parser
7f561c08de6b Initial load
duke
parents:
diff changeset
    41
extension packages.  Not all such extension packages should need to
7f561c08de6b Initial load
duke
parents:
diff changeset
    42
be recognized directly by parsers, however.
7f561c08de6b Initial load
duke
parents:
diff changeset
    43
As an example, most validation systems can be cleanly layered on top
7f561c08de6b Initial load
duke
parents:
diff changeset
    44
of parsers supporting the standardized SAX2 interfaces.  </p>
7f561c08de6b Initial load
duke
parents:
diff changeset
    45
7f561c08de6b Initial load
duke
parents:
diff changeset
    46
</BODY></HTML>