DocumentHandler
interface describes an object that manages registration and unregistration of documents in a multi-document-environment.
@author Hanns Holger Rutz
@version 0.13, 02-Aug-05
DocumentHandler
@author Scott T. Weaver @version $Id: DocumentHandler.java 516448 2007-03-09 16:25:47Z ate $
Represents the start of an XML document ... serves up elements wrapped in handlers for a specified schema.
@author dzwiers www.refractions.net @source $URL$This was the main event-handling interface for SAX1; in SAX2, it has been replaced by {@link org.xml.sax.ContentHandler ContentHandler}, which provides Namespace support and reporting of skipped entities. This interface is included in SAX2 only to support legacy SAX1 applications.
The order of events in this interface is very important, and mirrors the order of information in the document itself. For example, all of an element's content (character data, processing instructions, and/or subelements) will appear, in order, between the startElement event and the corresponding endElement event.
Application writers who do not want to implement the entire interface can derive a class from HandlerBase, which implements the default functionality; parser writers can instantiate HandlerBase to obtain a default handler. The application can find the location of any document event using the Locator interface supplied by the Parser through the setDocumentLocator method.
@deprecated This interface has been replaced by the SAX2{@link org.xml.sax.ContentHandler ContentHandler}interface, which includes Namespace support. @since SAX 1.0 @author David Megginson @version 2.0.1 (sax2r2) @see org.xml.sax.Parser#setDocumentHandler @see org.xml.sax.Locator @see org.xml.sax.HandlerBase
|
|
|
|