org.apache.axiom.ext.stax

Interface CharacterDataReader

All Known Implementing Classes:

SwitchingWrapper, Woodstox4StreamReaderWrapper

public interface CharacterDataReader

Optional interface implemented by XMLStreamReader implementations that support writing character data directly to a Writer.

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 XMLStreamReader.getProperty(String) with PROPERTY as the property name.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	PROPERTY The name of the property used to look up this extension interface from a XMLStreamReader implementation.

Method Summary

Modifier and Type	Method and Description
void	writeTextTo(java.io.Writer writer) Output the character data for the current event to the given writer.

Field Detail

PROPERTY

static final java.lang.String PROPERTY

The name of the property used to look up this extension interface from a XMLStreamReader implementation.

Method Detail

writeTextTo

void writeTextTo(java.io.Writer writer)
          throws javax.xml.stream.XMLStreamException,
                 java.io.IOException

Output the character data for the current event to the given writer. In general, the implementation behaves such that 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.getText(), XMLStreamReader.getTextCharacters(), XMLStreamReader.getTextStart(), XMLStreamReader.getTextLength() or 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.

Parameters:

writer - the writer to write the character data to

Throws:

javax.xml.stream.XMLStreamException - if the underlying XML source is not well-formed

java.io.IOException - if an I/O error occurs when writing the character data

java.lang.IllegalStateException - if this state is not a valid text state.