Class AbstractPullReader

java.lang.Object

com.thoughtworks.xstream.io.AbstractReader

com.thoughtworks.xstream.io.xml.AbstractXmlReader

com.thoughtworks.xstream.io.xml.AbstractPullReader

All Implemented Interfaces:

ErrorReporter, ExtendedHierarchicalStreamReader, HierarchicalStreamReader

Direct Known Subclasses:

StaxReader, XppReader

public abstract class AbstractPullReader
extends AbstractXmlReader

Base class that contains common functionality across HierarchicalStreamReader implementations that need to read from a pull parser.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static class	AbstractPullReader.Event

Field Summary

Fields

Modifier and Type	Field	Description
protected static final int	COMMENT
private final FastStack	elementStack
protected static final int	END_NODE
private final FastStack	lookahead
private final FastStack	lookback
private boolean	marked
protected static final int	OTHER
private final FastStack	pool
protected static final int	START_NODE
protected static final int	TEXT

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AbstractPullReader(NameCoder nameCoder)
protected	AbstractPullReader(XmlFriendlyReplacer replacer)	Deprecated. As of 1.4 use AbstractPullReader(NameCoder) instead

Method Summary

Modifier and Type	Method	Description
Iterator	getAttributeNames()	Iterator with the names of the attributes.
String	getNodeName()	Get the name of the current node.
String	getValue()	Get the value (text content) of the current node.
boolean	hasMoreChildren()	Does the node have any more children remaining that have not yet been read?
void	mark()
private void	move()
void	moveDown()	Select the current child as current node.
void	moveUp()	Select the parent node as current node.
String	peekNextChild()	Peek the name of the next child.
protected abstract String	pullElementName()	Pull the name of the current element from the stream.
protected abstract int	pullNextEvent()	Pull the next event from the stream.
protected abstract String	pullText()	Pull the contents of the current text node from the stream.
private AbstractPullReader.Event	readEvent()
private AbstractPullReader.Event	readRealEvent()
void	reset()

Methods inherited from class AbstractXmlReader

escapeXmlName, unescapeXmlName

Methods inherited from class AbstractReader

decodeAttribute, decodeNode, encodeAttribute, encodeNode, underlyingReader

Methods inherited from class Object

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

Methods inherited from interface HierarchicalStreamReader

appendErrors, close, getAttribute, getAttribute, getAttributeCount, getAttributeName

Field Details

START_NODE

protected static final int START_NODE

See Also:

• Constant Field Values

END_NODE

protected static final int END_NODE

See Also:

• Constant Field Values

TEXT

protected static final int TEXT

See Also:

• Constant Field Values

COMMENT

protected static final int COMMENT

See Also:

• Constant Field Values

OTHER

protected static final int OTHER

See Also:

• Constant Field Values

elementStack

private final FastStack elementStack

pool

private final FastStack pool

lookahead

private final FastStack lookahead

lookback

private final FastStack lookback

marked

private boolean marked

Constructor Details

AbstractPullReader

protected AbstractPullReader(NameCoder nameCoder)

Since:

1.4

AbstractPullReader

protected AbstractPullReader(XmlFriendlyReplacer replacer)

Deprecated.

As of 1.4 use AbstractPullReader(NameCoder) instead

Since:

1.2

Method Details

pullNextEvent

protected abstract int pullNextEvent()

Pull the next event from the stream.

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

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

pullElementName

protected abstract String pullElementName()

Pull the name of the current element from the stream.

pullText

protected abstract String pullText()

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

hasMoreChildren

public boolean hasMoreChildren()

Description copied from interface: HierarchicalStreamReader

Does the node have any more children remaining that have not yet been read?

moveDown

public void moveDown()

Description copied from interface: HierarchicalStreamReader

Select the current child as current node. A call to this function must be balanced with a call to HierarchicalStreamReader.moveUp().

moveUp

public void moveUp()

Description copied from interface: HierarchicalStreamReader

Select the parent node as current node.

move

private void move()

readEvent

private AbstractPullReader.Event readEvent()

readRealEvent

private AbstractPullReader.Event readRealEvent()

mark

public void mark()

reset

public void reset()

getValue

public String getValue()

Description copied from interface: HierarchicalStreamReader

Get the value (text content) of the current node.

getAttributeNames

public Iterator getAttributeNames()

Description copied from interface: HierarchicalStreamReader

Iterator with the names of the attributes.

Note, the iterator is only valid as long as the internal state of the underlying parser is still at the start of the current element. The behavior is undefined if the parser moved on.

getNodeName

public String getNodeName()

Description copied from interface: HierarchicalStreamReader

Get the name of the current node.

peekNextChild

public String peekNextChild()

Description copied from interface: ExtendedHierarchicalStreamReader

Peek the name of the next child. In situation where HierarchicalStreamReader.hasMoreChildren() returns true, peek the tag name of the child.

Specified by:

peekNextChild in interface ExtendedHierarchicalStreamReader

Overrides:

peekNextChild in class AbstractReader