public final class StringValueHandler extends EmptySerializer
HTML_ATTREMPTY, HTML_ATTRURL, NO_BAD_CHARS
Constructor and Description |
---|
StringValueHandler() |
Modifier and Type | Method and Description |
---|---|
void |
characters(char[] ch,
int off,
int len)
Receive notification of character data.
|
void |
characters(java.lang.String characters)
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 qname)
This method is used to notify that an element has ended.
|
java.lang.String |
getValue() |
java.lang.String |
getValueOfPI()
The value of a PI must not contain the substring "?
|
boolean |
setEscaping(boolean bool)
Turns special character escaping on/off.
|
void |
startElement(java.lang.String qname)
This method is used to notify of the start of an element
|
addAttribute, addAttribute, addAttribute, addAttributes, addUniqueAttribute, addXSLAttribute, asContentHandler, asDOM3Serializer, asDOMSerializer, attributeDecl, characters, close, comment, comment, elementDecl, endCDATA, endDocument, endDTD, endElement, endEntity, endPrefixMapping, entityReference, error, externalEntityDecl, fatalError, flushPending, getDoctypePublic, getDoctypeSystem, getEncoding, getIndent, getIndentAmount, getMediaType, getNamespaceMappings, getNamespaceURI, getNamespaceURIFromPrefix, getOmitXMLDeclaration, getOutputFormat, getOutputProperty, getOutputPropertyDefault, getOutputStream, getPrefix, getStandalone, getTransformer, getVersion, getWriter, ignorableWhitespace, internalEntityDecl, namespaceAfterStartElement, notationDecl, processingInstruction, reset, serialize, setCdataSectionElements, setCdataSectionElements, setContentHandler, setDoctype, setDoctypePublic, setDoctypeSystem, setDocumentLocator, setDTDEntityExpansion, setEncoding, setIndent, setIndentAmount, setMediaType, setNamespaceMappings, setOmitXMLDeclaration, setOutputFormat, setOutputProperty, setOutputPropertyDefault, setOutputStream, setSourceLocator, setStandalone, setTransformer, setVersion, setWriter, skippedEntity, startCDATA, startDocument, startDTD, startElement, startElement, startEntity, startPrefixMapping, startPrefixMapping, unparsedEntityDecl, warning
public void characters(char[] ch, int off, int len) throws SAXException
ContentHandler
The Parser will call this method to report each chunk of character data. SAX parsers may return all contiguous character data in a single chunk, or they may split it into several chunks; however, all of the characters in any single event must come from the same external entity so that the Locator provides useful information.
The application must not attempt to read from the array outside of the specified range.
Individual characters may consist of more than one Java
char
value. There are two important cases where this
happens, because characters can't be represented in just sixteen bits.
In one case, characters are represented in a Surrogate Pair,
using two special Unicode values. Such characters are in the so-called
"Astral Planes", with a code point above U+FFFF. A second case involves
composite characters, such as a base character combining with one or
more accent characters.
Your code should not assume that algorithms using
char
-at-a-time idioms will be working in character
units; in some cases they will split characters. This is relevant
wherever XML permits arbitrary characters, such as attribute values,
processing instruction data, and comments as well as in data reported
from this method. It's also generally relevant whenever Java code
manipulates internationalized text; the issue isn't unique to XML.
Note that some parsers will report whitespace in element
content using the ignorableWhitespace
method rather than this one (validating parsers must
do so).
characters
in interface ContentHandler
characters
in class EmptySerializer
ch
- the characters from the XML documentoff
- the start position in the arraylen
- the number of characters to read from the arraySAXException
- any SAX exception, possibly
wrapping another exceptionContentHandler.characters(char[], int, int)
public java.lang.String getValue()
public void characters(java.lang.String characters) throws SAXException
ExtendedContentHandler
characters
in interface ExtendedContentHandler
characters
in class EmptySerializer
characters
- the character dataSAXException
ExtendedContentHandler.characters(java.lang.String)
public void startElement(java.lang.String qname) throws SAXException
ExtendedContentHandler
startElement
in interface ExtendedContentHandler
startElement
in class EmptySerializer
qname
- the fully qualified name of the elementSAXException
ExtendedContentHandler.startElement(java.lang.String)
public void endElement(java.lang.String qname) throws SAXException
ExtendedContentHandler
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.
endElement
in interface ExtendedContentHandler
endElement
in class EmptySerializer
qname
- the fully qualified element name.SAXException
ExtendedContentHandler.endElement(java.lang.String)
public boolean setEscaping(boolean bool)
SerializationHandler
setEscaping
in interface SerializationHandler
setEscaping
in class EmptySerializer
bool
- true if escaping is to be set on.SerializationHandler.setEscaping(boolean)
public java.lang.String getValueOfPI()
Copyright © 2014 Apache XML Project. All Rights Reserved.