ikr.simlib.result.xml

Class XMLResultReader

java.lang.Object

ikr.simlib.result.xml.XMLResultReader

All Implemented Interfaces:

ResultReader

public class XMLResultReader
extends java.lang.Object
implements ResultReader

Nested Class Summary

Nested classes/interfaces inherited from interface ikr.simlib.result.ResultReader

ResultReader.Event

Constructor Summary

Constructors

Constructor and Description
XMLResultReader(java.io.InputStream input)

Method Summary

Methods

Modifier and Type	Method and Description
void	close() Closes the reader and underlying streams.
double	getDouble() Returns the current double result.
int	getIndex() Returns the index of the current result element.
int	getInt() Returns the current integer result.
long	getLong() Returns the current long integer result.
java.lang.String	getName() Returns the name of the current result.
java.lang.String	getString() Returns the current string result.
java.lang.String	getTypeName() Returns the type of the current result.
java.lang.String	getValue() Reads the unparsed value of the current result from the input.
boolean	hasNext() Returns whether any read events remain or the result tree has been fully traversed.
ResultReader.Event	next() Returns the next result read event.
ResultReader.Event	nextResult() Reads the next result (item, node or array).
double	readDouble(java.lang.String expectedName) Reads the next double result from the input.
void	readEndArray() Reads the end of the current result array.
void	readEndArrayItem() Reads the end of the current array element.
void	readEndNode() Reads the end of the current result node.
void	readEndResults() Reads the end of the result tree.
int	readInt(java.lang.String expectedName) Reads the next integer result from the input.
long	readLong(java.lang.String expectedName) Reads the next long integer result from the input.
void	readStartArray() Reads the next result array.
int	readStartArrayItem() Reads the next array element.
void	readStartNode() Reads the next result node.
void	readStartNode(java.lang.String expectedType) Reads the next result node.
void	readStartNode(java.lang.String expectedType, java.lang.String expectedName) Reads the next result node.
void	readStartResults() Reads the start of the result tree.
java.lang.String	readString(java.lang.String expectedName) Reads the next string result from the input.

Methods inherited from class java.lang.Object

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

Constructor Detail

XMLResultReader

public XMLResultReader(java.io.InputStream input)
                throws ResultException

Throws:

ResultException

Method Detail

close

public void close()
           throws ResultException

Description copied from interface: ResultReader

Closes the reader and underlying streams.

Specified by:

close in interface ResultReader

Throws:

ResultException

getDouble

public double getDouble()
                 throws ResultException

Description copied from interface: ResultReader

Returns the current double result.

Specified by:

getDouble in interface ResultReader

Returns:

the current double result

Throws:

ResultException

getIndex

public int getIndex()

Description copied from interface: ResultReader

Returns the index of the current result element.

Specified by:

getIndex in interface ResultReader

Returns:

the index of the current element

getInt

public int getInt()
           throws ResultException

Description copied from interface: ResultReader

Returns the current integer result.

Specified by:

getInt in interface ResultReader

Returns:

the current integer result

Throws:

ResultException

getLong

public long getLong()
             throws ResultException

Description copied from interface: ResultReader

Returns the current long integer result.

Specified by:

getLong in interface ResultReader

Returns:

the current long integer result

Throws:

ResultException

getName

public java.lang.String getName()

Description copied from interface: ResultReader

Returns the name of the current result. If the current result has no name null is returned.

Specified by:

getName in interface ResultReader

Returns:

the name of the current result or null

getString

public java.lang.String getString()

Description copied from interface: ResultReader

Returns the current string result.

Specified by:

getString in interface ResultReader

Returns:

the current string result

getTypeName

public java.lang.String getTypeName()

Description copied from interface: ResultReader

Returns the type of the current result.

Specified by:

getTypeName in interface ResultReader

Returns:

the type of the current result

getValue

public java.lang.String getValue()

Description copied from interface: ResultReader

Reads the unparsed value of the current result from the input.

Specified by:

getValue in interface ResultReader

Returns:

the unparsed value of the current result

hasNext

public boolean hasNext()

Description copied from interface: ResultReader

Returns whether any read events remain or the result tree has been fully traversed.

Calling ResultReader.next() after this mehtod returned false will result in an exception.

Specified by:

hasNext in interface ResultReader

Returns:

whether any read events remain

next

public ResultReader.Event next()
                        throws ResultException

Description copied from interface: ResultReader

Returns the next result read event.

Specified by:

next in interface ResultReader

Returns:

the next read event

Throws:

ResultException

readStartResults

public void readStartResults()
                      throws ResultException

Description copied from interface: ResultReader

Reads the start of the result tree.

Specified by:

readStartResults in interface ResultReader

Throws:

ResultException

readEndResults

public void readEndResults()
                    throws ResultException

Description copied from interface: ResultReader

Reads the end of the result tree.

Specified by:

readEndResults in interface ResultReader

Throws:

ResultException

readEndArrayItem

public void readEndArrayItem()
                      throws ResultException

Description copied from interface: ResultReader

Reads the end of the current array element.

Specified by:

readEndArrayItem in interface ResultReader

Throws:

ResultException

readEndNode

public void readEndNode()
                 throws ResultException

Description copied from interface: ResultReader

Reads the end of the current result node.

Specified by:

readEndNode in interface ResultReader

Throws:

ResultException

readStartNode

public void readStartNode()
                   throws ResultException

Description copied from interface: ResultReader

Reads the next result node.

Specified by:

readStartNode in interface ResultReader

Throws:

ResultException

readStartNode

public void readStartNode(java.lang.String expectedType,
                 java.lang.String expectedName)
                   throws ResultException

Description copied from interface: ResultReader

Reads the next result node.

Specified by:

readStartNode in interface ResultReader

Parameters:

expectedType - the expected type name

expectedName - the expected name

Throws:

ResultException

readStartNode

public void readStartNode(java.lang.String expectedType)
                   throws ResultException

Description copied from interface: ResultReader

Reads the next result node.

Specified by:

readStartNode in interface ResultReader

Parameters:

expectedType - the expected type name

Throws:

ResultException

readEndArray

public void readEndArray()
                  throws ResultException

Description copied from interface: ResultReader

Reads the end of the current result array.

Specified by:

readEndArray in interface ResultReader

Throws:

ResultException

readStartArray

public void readStartArray()
                    throws ResultException

Description copied from interface: ResultReader

Reads the next result array.

Specified by:

readStartArray in interface ResultReader

Throws:

ResultException

nextResult

public ResultReader.Event nextResult()
                              throws ResultException

Description copied from interface: ResultReader

Reads the next result (item, node or array).

Specified by:

nextResult in interface ResultReader

Returns:

either ResultReader.Event.RESULT, ResultReader.Event.START_NODE or ResultReader.Event.START_ARRAY

Throws:

ResultException

readStartArrayItem

public int readStartArrayItem()
                       throws ResultException

Description copied from interface: ResultReader

Reads the next array element. If the end of the array has been reached -1 is returned. If called after the end of the array, an exception will be thrown.

Specified by:

readStartArrayItem in interface ResultReader

Returns:

the index of the next element or -1

Throws:

ResultException

readDouble

public double readDouble(java.lang.String expectedName)
                  throws ResultException

Description copied from interface: ResultReader

Reads the next double result from the input. This method is equivalent of calling

 nextResult();
 getDouble();
 
 

Specified by:

readDouble in interface ResultReader

Returns:

the next double result

Throws:

ResultException

readInt

public int readInt(java.lang.String expectedName)
            throws ResultException

Description copied from interface: ResultReader

Reads the next integer result from the input. This method is equivalent of calling

 nextResult();
 getInt();
 
 

Specified by:

readInt in interface ResultReader

Returns:

the next integer result

Throws:

ResultException

readLong

public long readLong(java.lang.String expectedName)
              throws ResultException

Description copied from interface: ResultReader

Reads the next long integer result from the input. This method is equivalent of calling

 nextResult();
 getLong();
 
 

Specified by:

readLong in interface ResultReader

Returns:

the next long integer result

Throws:

ResultException

readString

public java.lang.String readString(java.lang.String expectedName)
                            throws ResultException

Description copied from interface: ResultReader

Reads the next string result from the input. This method is equivalent of calling

 nextResult();
 getString();
 
 

Specified by:

readString in interface ResultReader

Returns:

the next string result

Throws:

ResultException