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.