|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface HierarchicalStreamReader
Method Summary | |
---|---|
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. |
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. |
java.util.Iterator |
getAttributeNames()
Names of attributes (as Strings). |
java.lang.String |
getNodeName()
Get the name of the current node. |
java.lang.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 |
moveDown()
Select the current child as current node. |
void |
moveUp()
Select the parent node as current node. |
HierarchicalStreamReader |
underlyingReader()
Return the underlying HierarchicalStreamReader implementation. |
Method Detail |
---|
boolean hasMoreChildren()
void moveDown()
moveUp()
.
void moveUp()
java.lang.String getNodeName()
java.lang.String getValue()
java.lang.String getAttribute(java.lang.String name)
java.lang.String getAttribute(int index)
int getAttributeCount()
java.lang.String getAttributeName(int index)
java.util.Iterator getAttributeNames()
void appendErrors(ErrorWriter errorWriter)
void close()
HierarchicalStreamReader underlyingReader()
If a Converter needs to access methods of a specific HierarchicalStreamReader implementation that are not defined in the HierarchicalStreamReader interface, it should call this method before casting. This is because the reader passed to the Converter is often wrapped/decorated by another implementation to provide additional functionality (such as XPath tracking).
For example:
MySpecificReader mySpecificReader = (MySpecificReader)reader; // INCORRECT! mySpecificReader.doSomethingSpecific();
MySpecificReader mySpecificReader = (MySpecificReader)reader.underlyingReader(); // CORRECT! mySpecificReader.doSomethingSpecific();
Implementations of HierarchicalStreamReader should return 'this', unless they are a decorator, in which case they should delegate to whatever they are wrapping.
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |