org.apache.axiom.om.ds

Class WrappedTextNodeOMDataSourceFromReader

java.lang.Object

org.apache.axiom.om.ds.AbstractOMDataSource

org.apache.axiom.om.ds.AbstractPullOMDataSource

org.apache.axiom.om.ds.WrappedTextNodeOMDataSource

org.apache.axiom.om.ds.WrappedTextNodeOMDataSourceFromReader

All Implemented Interfaces:

OMDataSource, OMDataSourceExt, QNameAwareOMDataSource

public class WrappedTextNodeOMDataSourceFromReader
extends WrappedTextNodeOMDataSource

WrappedTextNodeOMDataSource that pulls text data from a Reader object. Since the stream can only be read once, this data source is destructive. The getObject() method returns the Reader object if it has not been accessed yet.

Field Summary

Fields

Modifier and Type	Field and Description
private boolean	isAccessed
private java.io.Reader	reader

Fields inherited from class org.apache.axiom.om.ds.WrappedTextNodeOMDataSource

wrapperElementName

Fields inherited from interface org.apache.axiom.om.OMDataSourceExt

LOSSY_PREFIX

Constructor Summary

Constructors

Constructor and Description
WrappedTextNodeOMDataSourceFromReader(javax.xml.namespace.QName wrapperElementName, java.io.Reader reader)

Method Summary

Modifier and Type	Method and Description
void	close() Close the DataSource and free its resources.
java.lang.Object	getObject() Get the object that backs this data source.
javax.xml.stream.XMLStreamReader	getReader() Get parser for element data.
boolean	isDestructiveRead() Returns true if reading the backing object is destructive.

Methods inherited from class org.apache.axiom.om.ds.WrappedTextNodeOMDataSource

getLocalName, getNamespaceURI, getPrefix

Methods inherited from class org.apache.axiom.om.ds.AbstractPullOMDataSource

isDestructiveWrite, serialize

Methods inherited from class org.apache.axiom.om.ds.AbstractOMDataSource

copy, getProperty, getXMLBytes, getXMLInputStream, hasProperty, serialize, serialize, setProperty

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.apache.axiom.om.OMDataSource

serialize, serialize, serialize

Field Detail

reader

private final java.io.Reader reader

isAccessed

private boolean isAccessed

Constructor Detail

WrappedTextNodeOMDataSourceFromReader

public WrappedTextNodeOMDataSourceFromReader(javax.xml.namespace.QName wrapperElementName,
                                             java.io.Reader reader)

Method Detail

getReader

public javax.xml.stream.XMLStreamReader getReader()
                                           throws javax.xml.stream.XMLStreamException

Description copied from interface: OMDataSource

Get parser for element data. In the general case this may require the data source to serialize data as XML text and then parse that text.

It is assumed that this method consumed the content (i.e. destroys the backing object) unless the data source also implements OMDataSourceExt and OMDataSourceExt.isDestructiveRead() returns false.

Returns:

element parser

Throws:

javax.xml.stream.XMLStreamException

getObject

public java.lang.Object getObject()

Description copied from interface: OMDataSourceExt

Get the object that backs this data source. Application code should in general not call this method directly, but use OMSourcedElement.getObject(Class) instead.

Data sources that support non destructive read/write should return the object from which the XML is produced. Data sources with destructive read/write should return a non null value only if the backing object has not been consumed yet (even partially).

Specified by:

getObject in interface OMDataSourceExt

Overrides:

getObject in class AbstractOMDataSource

Returns:

the backing object, or null if the data source has no backing object or if the backing object can't be accessed in a safe way

isDestructiveRead

public boolean isDestructiveRead()

Description copied from interface: OMDataSourceExt

Returns true if reading the backing object is destructive. An example of an object with a destructive read is an InputSteam. The owning OMSourcedElement uses this information to detemine if OM tree expansion is needed when reading the OMDataSourceExt.

Returns:

boolean

close

public void close()

Description copied from interface: OMDataSourceExt

Close the DataSource and free its resources.

Specified by:

close in interface OMDataSourceExt

Overrides:

close in class AbstractOMDataSource