public interface CharacterDataReader
XMLStreamReaderimplementations that support writing character data directly to a
All the requirements outlined in
org.apache.axiom.ext.stax apply to
this extension interface. In particular, to get a reference to the extension,
the consumer MUST call
PROPERTY as the property name.
|Modifier and Type||Field and Description|
The name of the property used to look up this extension interface from a
void writeTextTo(Writer writer) throws javax.xml.stream.XMLStreamException, IOException
reader.writeTextTo(writer)has the same effect as
writer.write(reader.getText()). However, the implementation MAY choose to split the character data differently. E.g. it MAY write the character data in multiple chunks or it MAY choose to process more character data in a single event than would be returned by
XMLStreamReader.getText(). Therefore, using this method together with
XMLStreamReader.getTextCharacters(int, char, int, int)is not supported and may lead to undefined results.
The implementation SHOULD avoid any unnecessary conversions between strings and character arrays.
Copyright © The Apache Software Foundation. All Rights Reserved.