|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
This interface describes extensions to the SAX ContentHandler interface. It is intended to be used by a serializer. The methods on this interface will implement SAX- like behavior. This allows the gradual collection of information rather than having it all up front. For example the call
startElement(namespaceURI,localName,qName,atts)could be replaced with the calls
startElement(namespaceURI,localName,qName) addAttributes(atts)If there are no attributes the second call can be dropped. If attributes are to be added one at a time with calls to
addAttribute(namespaceURI, localName, qName, type, value)
Field Summary | |
static int |
HTML_ATTREMPTY
|
static int |
HTML_ATTRURL
|
static int |
NO_BAD_CHARS
|
Method Summary | |
void |
addAttribute(java.lang.String qName,
java.lang.String value)
Add an attribute to the current element. |
void |
addAttribute(java.lang.String uri,
java.lang.String localName,
java.lang.String rawName,
java.lang.String type,
java.lang.String value)
Add at attribute to the current element, not from an xsl:attribute element. |
void |
addAttribute(java.lang.String uri,
java.lang.String localName,
java.lang.String rawName,
java.lang.String type,
java.lang.String value,
boolean XSLAttribute)
Add at attribute to the current element |
void |
addAttributes(Attributes atts)
Add attributes to the current element |
void |
addUniqueAttribute(java.lang.String qName,
java.lang.String value,
int flags)
Add a unique attribute to the current element. |
void |
addXSLAttribute(java.lang.String qName,
java.lang.String value,
java.lang.String uri)
Add an attribute from an xsl:attribute element. |
void |
characters(Node node)
This method is used to notify of a character event, but passing the data as a DOM Node rather than the standard character array. |
void |
characters(java.lang.String chars)
This method is used to notify of a character event, but passing the data as a character String rather than the standard character array. |
void |
endElement(java.lang.String elemName)
This method is used to notify that an element has ended. |
void |
entityReference(java.lang.String entityName)
Notify of an entity reference. |
NamespaceMappings |
getNamespaceMappings()
This method returns an object that has the current namespace mappings in effect. |
java.lang.String |
getNamespaceURI(java.lang.String name,
boolean isElement)
This method gets the prefix associated with a current element or attribute name. |
java.lang.String |
getNamespaceURIFromPrefix(java.lang.String prefix)
This method returns the namespace URI currently associated with the prefix. |
java.lang.String |
getPrefix(java.lang.String uri)
This method returns the prefix that currently maps to the given namespace URI. |
void |
namespaceAfterStartElement(java.lang.String uri,
java.lang.String prefix)
This method is used to notify that a prefix mapping is to start, but after an element is started. |
void |
setSourceLocator(SourceLocator locator)
This method is used to set the source locator, which might be used to generated an error message. |
void |
startElement(java.lang.String qName)
This method is used to notify of the start of an element |
void |
startElement(java.lang.String uri,
java.lang.String localName,
java.lang.String qName)
This method is used to notify that an element is starting. |
boolean |
startPrefixMapping(java.lang.String prefix,
java.lang.String uri,
boolean shouldFlush)
This method is used to notify that a prefix maping is to start, which can be for the current element, or for the one to come. |
Methods inherited from interface org.xml.sax.ContentHandler |
characters,
endDocument,
endElement,
endPrefixMapping,
ignorableWhitespace,
processingInstruction,
setDocumentLocator,
skippedEntity,
startDocument,
startElement,
startPrefixMapping |
Field Detail |
public static final int NO_BAD_CHARS
public static final int HTML_ATTREMPTY
public static final int HTML_ATTRURL
Method Detail |
public void addAttribute(java.lang.String uri, java.lang.String localName, java.lang.String rawName, java.lang.String type, java.lang.String value, boolean XSLAttribute) throws SAXException
uri
- the namespace URI of the attribute namelocalName
- the local name of the attribute (without prefix)rawName
- the qualified name of the attributetype
- the attribute type typically character data (CDATA)value
- the value of the attributeXSLAttribute
- true if the added attribute is coming from an xsl:attribute elementpublic void addAttributes(Attributes atts) throws SAXException
atts
- the attributes to add.public void addAttribute(java.lang.String qName, java.lang.String value)
qName
- value
- public void characters(java.lang.String chars) throws SAXException
chars
- the character datapublic void characters(Node node) throws SAXException
node
- a DOM Node containing text.public void endElement(java.lang.String elemName) throws SAXException
endElement(namespaceURI,localName,qName)only the last parameter is passed. If needed the serializer can derive the localName from the qualified name and derive the namespaceURI from its implementation.
elemName
- the fully qualified element name.public void startElement(java.lang.String uri, java.lang.String localName, java.lang.String qName) throws SAXException
startElement(uri,localName,qname,atts)but without the attributes.
uri
- the namespace URI of the elementlocalName
- the local name (without prefix) of the elementqName
- the qualified name of the elementpublic void startElement(java.lang.String qName) throws SAXException
qName
- the fully qualified name of the elementpublic void namespaceAfterStartElement(java.lang.String uri, java.lang.String prefix) throws SAXException
startPrefixMapping(prefix,uri)is used just before an element starts and applies to the element to come, not to the current element. This method applies to the current element. For example one could make the calls in this order:
startElement("prfx8:elem9") namespaceAfterStartElement("http://namespace8","prfx8")
uri
- the namespace URI being declaredprefix
- the prefix that maps to the given namespacepublic boolean startPrefixMapping(java.lang.String prefix, java.lang.String uri, boolean shouldFlush) throws SAXException
prefix
- the prefix that maps to the given URIuri
- the namespace URI of the given prefixshouldFlush
- if true this call is like the SAX
startPrefixMapping(prefix,uri) call and the mapping applies to the
element to come. If false the mapping applies to the current element.public void entityReference(java.lang.String entityName) throws SAXException
entityName
- the name of the entitypublic NamespaceMappings getNamespaceMappings()
public java.lang.String getPrefix(java.lang.String uri)
uri
- the namespace URIpublic java.lang.String getNamespaceURI(java.lang.String name, boolean isElement)
name
- the qualified name of an element, or attributeisElement
- true if it is an element name, false if it is an
atttribute namepublic java.lang.String getNamespaceURIFromPrefix(java.lang.String prefix)
prefix
- a prefix of an element or attribute.public void setSourceLocator(SourceLocator locator)
locator
- the source locatorpublic void addUniqueAttribute(java.lang.String qName, java.lang.String value, int flags) throws SAXException
qName
- the fully qualified attribute name.value
- the attribute valueflags
- a bitwise flagpublic void addXSLAttribute(java.lang.String qName, java.lang.String value, java.lang.String uri)
qName
- the qualified attribute name (prefix:localName)value
- the attributes valueuri
- the uri that the prefix of the qName is mapped to.public void addAttribute(java.lang.String uri, java.lang.String localName, java.lang.String rawName, java.lang.String type, java.lang.String value) throws SAXException
uri
- the namespace URI of the attribute namelocalName
- the local name of the attribute (without prefix)rawName
- the qualified name of the attributetype
- the attribute type typically character data (CDATA)value
- the value of the attribute
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |