Package com.thoughtworks.xstream.io.xml

Class XppReader

java.lang.Object

com.thoughtworks.xstream.io.AbstractReader

com.thoughtworks.xstream.io.xml.AbstractXmlReader

com.thoughtworks.xstream.io.xml.AbstractPullReader

com.thoughtworks.xstream.io.xml.XppReader

All Implemented Interfaces:

ErrorReporter, ExtendedHierarchicalStreamReader, HierarchicalStreamReader

public class XppReader
extends AbstractPullReader

XStream reader that pulls directly from the stream using the XmlPullParser API.

Field Summary

Fields

Modifier and Type	Field	Description
private org.xmlpull.v1.XmlPullParser	parser
private java.io.Reader	reader

Fields inherited from class com.thoughtworks.xstream.io.xml.AbstractPullReader

COMMENT, END_NODE, OTHER, START_NODE, TEXT

Constructor Summary

Constructors

Constructor	Description
XppReader(java.io.Reader reader)	Deprecated. As of 1.4, use XppReader(Reader, XmlPullParser) instead
XppReader(java.io.Reader reader, XmlFriendlyReplacer replacer)	Deprecated. As of 1.4, use XppReader(Reader, XmlPullParser, NameCoder) instead
XppReader(java.io.Reader reader, org.xmlpull.v1.XmlPullParser parser)	Construct an XppReader.
XppReader(java.io.Reader reader, org.xmlpull.v1.XmlPullParser parser, NameCoder nameCoder)	Construct an XppReader.

Method Summary

Modifier and Type	Method	Description
void	appendErrors(ErrorWriter errorWriter)	If any errors are detected, allow the reader to add any additional information that can aid debugging (such as line numbers, XPath expressions, etc).
void	close()	Close the reader, if necessary.
protected org.xmlpull.v1.XmlPullParser	createParser()	Deprecated. As of 1.4, use XppReader(Reader, XmlPullParser) instead
java.lang.String	getAttribute(int index)	Get the value of an attribute of the current node, by index.
java.lang.String	getAttribute(java.lang.String name)	Get the value of an attribute of the current node.
int	getAttributeCount()	Number of attributes in current node.
java.lang.String	getAttributeName(int index)	Name of attribute in current node.
protected java.lang.String	pullElementName()	Pull the name of the current element from the stream.
protected int	pullNextEvent()	Pull the next event from the stream.
protected java.lang.String	pullText()	Pull the contents of the current text node from the stream.

Methods inherited from class com.thoughtworks.xstream.io.xml.AbstractPullReader

getAttributeNames, getNodeName, getValue, hasMoreChildren, mark, moveDown, moveUp, peekNextChild, reset

Methods inherited from class com.thoughtworks.xstream.io.xml.AbstractXmlReader

escapeXmlName, unescapeXmlName

Methods inherited from class com.thoughtworks.xstream.io.AbstractReader

decodeAttribute, decodeNode, encodeAttribute, encodeNode, underlyingReader

Methods inherited from class java.lang.Object

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

Field Detail

parser

private final org.xmlpull.v1.XmlPullParser parser

reader

private final java.io.Reader reader

Constructor Detail

XppReader

public XppReader(java.io.Reader reader,
                 org.xmlpull.v1.XmlPullParser parser)

Construct an XppReader.

Parameters:

reader - the reader with the input data

parser - the XPP parser to use

Since:

1.4

XppReader

public XppReader(java.io.Reader reader,
                 org.xmlpull.v1.XmlPullParser parser,
                 NameCoder nameCoder)

Construct an XppReader.

Parameters:

reader - the reader with the input data

parser - the XPP parser to use

nameCoder - the coder for XML friendly tag and attribute names

Since:

1.4

XppReader

public XppReader(java.io.Reader reader)

Deprecated.

As of 1.4, use XppReader(Reader, XmlPullParser) instead

XppReader

public XppReader(java.io.Reader reader,
                 XmlFriendlyReplacer replacer)

Deprecated.

As of 1.4, use XppReader(Reader, XmlPullParser, NameCoder) instead

Since:

1.2

Method Detail

createParser

protected org.xmlpull.v1.XmlPullParser createParser()

Deprecated.

As of 1.4, use XppReader(Reader, XmlPullParser) instead

To use another implementation of org.xmlpull.v1.XmlPullParser, override this method.

pullNextEvent

protected int pullNextEvent()

Description copied from class: AbstractPullReader

Pull the next event from the stream.

This MUST return AbstractPullReader.START_NODE, AbstractPullReader.END_NODE, AbstractPullReader.TEXT, AbstractPullReader.COMMENT, AbstractPullReader.OTHER or throw StreamException.

The underlying pull parser will most likely return its own event types. These must be mapped to the appropriate events.

Specified by:

pullNextEvent in class AbstractPullReader

pullElementName

protected java.lang.String pullElementName()

Description copied from class: AbstractPullReader

Pull the name of the current element from the stream.

Specified by:

pullElementName in class AbstractPullReader

pullText

protected java.lang.String pullText()

Description copied from class: AbstractPullReader

Pull the contents of the current text node from the stream.

Specified by:

pullText in class AbstractPullReader

getAttribute

public java.lang.String getAttribute(java.lang.String name)

Description copied from interface: HierarchicalStreamReader

Get the value of an attribute of the current node.

If no such attribute exists, the method returns null.

getAttribute

public java.lang.String getAttribute(int index)

Description copied from interface: HierarchicalStreamReader

Get the value of an attribute of the current node, by index.

Note, the behavior of this method is dependent on the underlying parser when calling it with a non-existing index. Typically some kind of RuntimeException is thrown.

getAttributeCount

public int getAttributeCount()

Description copied from interface: HierarchicalStreamReader

Number of attributes in current node.

getAttributeName

public java.lang.String getAttributeName(int index)

Description copied from interface: HierarchicalStreamReader

Name of attribute in current node.

Note, the behavior of this method is dependent on the underlying parser when calling it with a non-existing index. Typically some kind of RuntimeException is thrown.

appendErrors

public void appendErrors(ErrorWriter errorWriter)

Description copied from interface: HierarchicalStreamReader

If any errors are detected, allow the reader to add any additional information that can aid debugging (such as line numbers, XPath expressions, etc).

Parameters:

errorWriter - the error writer

close

public void close()

Description copied from interface: HierarchicalStreamReader

Close the reader, if necessary.