This appendix is a quick reference to the major Java and XML APIs, SAX and DOM. It also includes a complete API reference for JDOM, covered in Chapter 8, and the rest of the book. It is broken down into sections based on the API being documented.
SAX 2.0 provides a sequential look into an
XML document. Detailed in Chapter 3, and Chapter 5, SAX defines a set of interfaces that can be
implemented and will be invoked as callbacks during the XML parsing
process. The SAX packages are detailed here, with the classes and
interfaces listed alphabetically. In the
org.xml.sax.helpers package, a large percentage of
the available methods in the helper classes are implementations of
interfaces already defined in the core SAX package
org.xml.sax). For the sake of brevity, these
duplicate method definitions will be omitted in the helper classes,
and instead a comment will be included noting that an
interface’s methods are implemented.
This package contains the core
interfaces and classes for SAX 2.0. Most of the interfaces defined
are intended to be implemented by you, the Java developer, with the
exception of the actual
Attributes implementation. These interfaces should
be implemented by your vendor’s XML parsing software. In
addition, several exceptions that SAX methods are allowed to throw
are defined. Several of the interfaces defined here are part of the
SAX 1.0 and 2.0 alpha distributions, and are now deprecated.