This page is part of an archival collection and is no longer actively maintained.

It may contain outdated information and may not meet current or future WCAG accessibility standards. We provide this content, its subpages, and associated links for historical reference only. If you need assistance, please contact support@cs.washington.edu

com.dautelle.xml.sax
Interface ContentHandler

All Known Implementing Classes:

DefaultHandler

public interface ContentHandler

Receives notification of the logical content of a document. It is a more generic version of org.xml.sax.ContentHandler with the String type replaced by CharSequence.

Version:

4.5, May 26, 2003

Author:

David Megginson, Jean-Marie Dautelle

Method Summary

void	characters(char[] ch, int start, int length) Receives notification of character data.
void	endDocument() Receives notification of the end of a document.
void	endElement(java.lang.CharSequence uri, java.lang.CharSequence localName, java.lang.CharSequence qName) Receives notification of the end of an element.
void	endPrefixMapping(java.lang.CharSequence prefix) Ends the scope of a prefix-URI mapping.
void	ignorableWhitespace(char[] ch, int start, int length) Receives notification of ignorable whitespace in element content.
void	processingInstruction(java.lang.CharSequence target, java.lang.CharSequence data) Receives notification of a processing instruction.
void	setDocumentLocator(org.xml.sax.Locator locator) Receives an object for locating the origin of SAX document events.
void	skippedEntity(java.lang.CharSequence name) Receives notification of a skipped entity.
void	startDocument() Receives notification of the beginning of a document.
void	startElement(java.lang.CharSequence uri, java.lang.CharSequence localName, java.lang.CharSequence qName, Attributes atts) Receives notification of the beginning of an element.
void	startPrefixMapping(java.lang.CharSequence prefix, java.lang.CharSequence uri) Begins the scope of a prefix-URI Namespace mapping.

Method Detail

setDocumentLocator

public void setDocumentLocator(org.xml.sax.Locator locator)

Receives an object for locating the origin of SAX document events.

Parameters:

locator - the document locator.

startDocument

public void startDocument()
                   throws org.xml.sax.SAXException

Receives notification of the beginning of a document.

Throws:

org.xml.sax.SAXException - any SAX exception.

endDocument

public void endDocument()
                 throws org.xml.sax.SAXException

Receives notification of the end of a document.

Throws:

org.xml.sax.SAXException - any SAX exception.

startPrefixMapping

public void startPrefixMapping(java.lang.CharSequence prefix,
                               java.lang.CharSequence uri)
                        throws org.xml.sax.SAXException

Begins the scope of a prefix-URI Namespace mapping.

Parameters:

prefix - the Namespace prefix being declared.

uri - the namespace URI the prefix is mapped to.

Throws:

org.xml.sax.SAXException - any SAX exception.

endPrefixMapping

public void endPrefixMapping(java.lang.CharSequence prefix)
                      throws org.xml.sax.SAXException

Ends the scope of a prefix-URI mapping.

Parameters:

prefix - the prefix that was being mapping.

Throws:

org.xml.sax.SAXException - any SAX exception.

startElement

public void startElement(java.lang.CharSequence uri,
                         java.lang.CharSequence localName,
                         java.lang.CharSequence qName,
                         Attributes atts)
                  throws org.xml.sax.SAXException

Receives notification of the beginning of an element.

Parameters:

uri - the namespace URI, or an empty character sequence if the element has no Namespace URI or if namespace processing is not being performed.

localName - the local name (without prefix), or an empty character sequence if namespace processing is not being performed.

qName - the qualified name (with prefix), or an empty character sequence if qualified names are not available.

atts - the attributes attached to the element. If there are no attributes, it shall be an empty Attributes object.

Throws:

org.xml.sax.SAXException - any SAX exception.

endElement

public void endElement(java.lang.CharSequence uri,
                       java.lang.CharSequence localName,
                       java.lang.CharSequence qName)
                throws org.xml.sax.SAXException

Receives notification of the end of an element.

Parameters:

uri - the namespace URI, or an empty character sequence if the element has no Namespace URI or if namespace processing is not being performed.

localName - the local name (without prefix), or an empty character sequence if namespace processing is not being performed.

qName - the qualified XML 1.0 name (with prefix), or an empty character sequence if qualified names are not available.

Throws:

org.xml.sax.SAXException - any SAX exception.

characters

public void characters(char[] ch,
                       int start,
                       int length)
                throws org.xml.sax.SAXException

Receives notification of character data.

Parameters:

ch - the characters from the XML document.

start - the start position in the array.

length - the number of characters to read from the array.

Throws:

org.xml.sax.SAXException - any SAX exception.

ignorableWhitespace

public void ignorableWhitespace(char[] ch,
                                int start,
                                int length)
                         throws org.xml.sax.SAXException

Receives notification of ignorable whitespace in element content.

Parameters:

ch - the characters from the XML document.

start - the start position in the array.

length - the number of characters to read from the array.

Throws:

org.xml.sax.SAXException - any SAX exception.

processingInstruction

public void processingInstruction(java.lang.CharSequence target,
                                  java.lang.CharSequence data)
                           throws org.xml.sax.SAXException

Receives notification of a processing instruction.

Parameters:

target - the processing instruction target.

data - the processing instruction data, or null if none was supplied. The data does not include any whitespace separating it from the target.

Throws:

org.xml.sax.SAXException - any SAX exception.

skippedEntity

public void skippedEntity(java.lang.CharSequence name)
                   throws org.xml.sax.SAXException

Receives notification of a skipped entity.

Parameters:

name - the name of the skipped entity. If it is a parameter entity, the name will begin with '%', and if it is the external DTD subset, it will be the character sequence "[dtd]".

Throws:

org.xml.sax.SAXException - any SAX exception.