Package org.svetovid.io

Class AbstractSvetovidReader

java.lang.Object

org.svetovid.io.AbstractSvetovidReader

All Implemented Interfaces:

Closeable, AutoCloseable, SvetovidReader

Direct Known Subclasses:

DefaultSvetovidReader

public abstract class AbstractSvetovidReader
extends Object
implements SvetovidReader

This class provides default implementations for the SvetovidReader interface. Standard behaviors of all methods are defined here. The developer need only subclass this abstract class and define the doReadLine() method.

Author:

Ivan Pribela

See Also:

• SvetovidReader
• doReadLine()

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected static enum	AbstractSvetovidReader.TokenType

Field Summary

Fields

Modifier and Type	Field	Description
protected Throwable	lastException
protected String	line
protected boolean	throwingExceptions
protected String	tokenContent
protected AbstractSvetovidReader.TokenType	tokenType
protected Pattern	whitespace

Constructor Summary

Constructors

Constructor	Description
AbstractSvetovidReader()

Method Summary

Modifier and Type	Method	Description
void	close()	Closes this reader and releases any resources associated with the underlying source.
protected abstract String	doReadLine()
Throwable	getLastException()	Returns the exception raised in the last operation; if the operation was successful and no exception was raised, returns null.
Pattern	getWhitespace()	Returns the currently used pattern for recognizing whitespace.
protected void	handleAnyException(Throwable exception)
protected void	handleFormatException(SvetovidFormatException exception)
boolean	hasMore()	Checks whether this reader has data to be read.
protected boolean	isCharInNumber(char ch)
protected boolean	isCharWhitespace(char ch)
protected boolean	isCharWhitespaceOrSymbol(char ch)
boolean	isEmpty()	Checks whether this reader has no more data to be read.
boolean	isThrowingExceptions()	Returns the indicator whether this reader will throw exceptions on I/O operation errors or just return default values.
protected List<Object>	nextArray()
protected char	nextChar()
protected Boolean	nextLiteral()
protected Number	nextNumber()
protected Map.Entry<String,Object>	nextPair()
protected String	nextString()
protected void	nextToken()
protected Object	nextValue()
protected boolean	parseBool(String string)
protected char	parseChar(String string)
String	readAll()	Reads all remaining content and returns it as a string.
String[]	readAllLines()	Read all remaining lines and returns them as an array of strings.
boolean	readBool()	Reads one token and converts it to a boolean value.
boolean[]	readBoolArray()	Reads one line, separates it into tokens and converts them to boolean values.
Boolean[]	readBoolArrayBoxed()	Reads one line, separates it into tokens and converts them to boolean values.
Boolean	readBoolBoxed()	Reads one token and converts it to a boolean value.
boolean[][]	readBoolMatrix()	Reads multiple lines and converts the data to a boolean matrix.
Boolean[][]	readBoolMatrixBoxed()	Reads multiple lines and converts the data to a boolean matrix.
byte	readByte()	Reads one token and converts it to a byte value.
byte[]	readByteArray()	Reads one line, separates it into tokens and converts them to byte values.
Byte[]	readByteArrayBoxed()	Reads one line, separates it into tokens and converts them to byte values.
Byte	readByteBoxed()	Reads one token and converts it to a byte value.
byte[][]	readByteMatrix()	Reads multiple lines and converts the data to a byte matrix.
Byte[][]	readByteMatrixBoxed()	Reads multiple lines and converts the data to a byte matrix.
char	readChar()	Reads one token and converts it to a character value.
char[]	readCharArray()	Reads one line, separates it into tokens and converts them to character values.
Character[]	readCharArrayBoxed()	Reads one line, separates it into tokens and converts them to character values.
Character	readCharBoxed()	Reads one token and converts it to a character value.
char[][]	readCharMatrix()	Reads multiple lines and converts the data to a character matrix.
Character[][]	readCharMatrixBoxed()	Reads multiple lines and converts the data to a character matrix.
double	readDouble()	Reads one token and converts it to a double-precision floating-point value.
double[]	readDoubleArray()	Reads one line, separates it into tokens and converts them to double-precision floating-point values.
Double[]	readDoubleArrayBoxed()	Reads one line, separates it into tokens and converts them to double-precision floating-point values.
Double	readDoubleBoxed()	Reads one token and converts it to a double-precision floating-point value.
double[][]	readDoubleMatrix()	Reads multiple lines and converts the data to a double-precision floating-point matrix.
Double[][]	readDoubleMatrixBoxed()	Reads multiple lines and converts the data to a double-precision floating-point matrix.
float	readFloat()	Reads one token and converts it to a floating-point value.
float[]	readFloatArray()	Reads one line, separates it into tokens and converts them to floating-point values.
Float[]	readFloatArrayBoxed()	Reads one line, separates it into tokens and converts them to floating-point values.
Float	readFloatBoxed()	Reads one token and converts it to a floating-point value.
float[][]	readFloatMatrix()	Reads multiple lines and converts the data to a floating-point matrix.
Float[][]	readFloatMatrixBoxed()	Reads multiple lines and converts the data to a floating-point matrix.
int	readInt()	Reads one token and converts it to an integer value.
int[]	readIntArray()	Reads one line, separates it into tokens and converts them to integer values.
Integer[]	readIntArrayBoxed()	Reads one line, separates it into tokens and converts them to integer values.
Integer	readIntBoxed()	Reads one token and converts it to an integer value.
int[][]	readIntMatrix()	Reads multiple lines and converts the data to an integer matrix.
Integer[][]	readIntMatrixBoxed()	Reads multiple lines and converts the data to an integer matrix.
String	readLine()	Reads a line of text and returns it as a string.
long	readLong()	Reads one token and converts it to a long integer value.
long[]	readLongArray()	Reads one line, separates it into tokens and converts them to long integer values.
Long[]	readLongArrayBoxed()	Reads one line, separates it into tokens and converts them to long integer values.
Long	readLongBoxed()	Reads one token and converts it to a long integer value.
long[][]	readLongMatrix()	Reads multiple lines and converts the data to a long integer matrix.
Long[][]	readLongMatrixBoxed()	Reads multiple lines and converts the data to a long integer matrix.
protected Map<String,Object>	readNextObject()
Object	readObject()	Reads a JSON (JavaScript Object Notation) formatted object.
short	readShort()	Reads one token and converts it to a short integer value.
short[]	readShortArray()	Reads one line, separates it into tokens and converts them to short integer values.
Short[]	readShortArrayBoxed()	Reads one line, separates it into tokens and converts them to short integer values.
Short	readShortBoxed()	Reads one token and converts it to a short integer value.
short[][]	readShortMatrix()	Reads multiple lines and converts the data to a shot integer matrix.
Short[][]	readShortMatrixBoxed()	Reads multiple lines and converts the data to a shot integer matrix.
String	readToken()	Reads one token and returns it as a string value.
String[]	readTokenArray()	Reads one line, separates it into tokens and returns them as string values.
String[][]	readTokenMatrix()	Reads multiple lines and converts the data to a string matrix.
protected void	returnChar(char ch)
void	setThrowingExceptions(boolean shouldThrow)	Configures whether this reader should throw exceptions on I/O operation errors or just return default values.
void	setWhitespace(Pattern whitespace)	Sets the pattern used to recognize whitespace.
protected void	wrapUpIOException(IOException e)

Methods inherited from class java.lang.Object

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

Field Details

whitespace

protected Pattern whitespace

throwingExceptions

protected boolean throwingExceptions

lastException

protected Throwable lastException

line

protected String line

tokenType

protected AbstractSvetovidReader.TokenType tokenType

tokenContent

protected String tokenContent

Constructor Details

AbstractSvetovidReader

public AbstractSvetovidReader()

Method Details

getWhitespace

public Pattern getWhitespace()

Description copied from interface: SvetovidReader

Returns the currently used pattern for recognizing whitespace. This pattern is used to separate tokens when reading form the underlying source. For more on patterns see Pattern.

Specified by:

getWhitespace in interface SvetovidReader

Returns:

the pattern currently used to recognize whitespace.

See Also:

• Pattern

setWhitespace

public void setWhitespace(Pattern whitespace)

Description copied from interface: SvetovidReader

Sets the pattern used to recognize whitespace. This pattern is used to separate tokens when reading form the underlying source. For more on patterns see Pattern.

Specified by:

setWhitespace in interface SvetovidReader

Parameters:

whitespace - the pattern to use recognize whitespace

See Also:

• Pattern

isThrowingExceptions

public boolean isThrowingExceptions()

Description copied from interface: SvetovidReader

Returns the indicator whether this reader will throw exceptions on I/O operation errors or just return default values.

Specified by:

isThrowingExceptions in interface SvetovidReader

Returns:

true if this reader throws exceptions on failed I/O operations; false otherwise.

setThrowingExceptions

public void setThrowingExceptions(boolean shouldThrow)

Description copied from interface: SvetovidReader

Configures whether this reader should throw exceptions on I/O operation errors or just return default values.

Specified by:

setThrowingExceptions in interface SvetovidReader

Parameters:

shouldThrow - true if this reader should throw exceptions on failed I/O operations in the future; false if it should return default values.

getLastException

public Throwable getLastException()

Description copied from interface: SvetovidReader

Returns the exception raised in the last operation; if the operation was successful and no exception was raised, returns null.

Specified by:

getLastException in interface SvetovidReader

Returns:

the exception raised in the last operation or null it the operation was successful.

wrapUpIOException

protected void wrapUpIOException(IOException e)
                          throws SvetovidException

Throws:

SvetovidException

handleFormatException

protected void handleFormatException(SvetovidFormatException exception)
                              throws SvetovidFormatException

Throws:

SvetovidFormatException

handleAnyException

protected void handleAnyException(Throwable exception)
                           throws RuntimeException

Throws:

RuntimeException

isEmpty

public boolean isEmpty()

Description copied from interface: SvetovidReader

Checks whether this reader has no more data to be read.

Specified by:

isEmpty in interface SvetovidReader

Returns:

true if this reader has no more data to be read; false otherwise.

hasMore

public boolean hasMore()

Description copied from interface: SvetovidReader

Checks whether this reader has data to be read.

Specified by:

hasMore in interface SvetovidReader

Returns:

true if this reader has data to be read; false otherwise.

close

public void close()
           throws SvetovidIOException

Description copied from interface: SvetovidReader

Closes this reader and releases any resources associated with the underlying source. The general contract of close is that it closes the input source. A closed source cannot perform input operations and cannot be reopened.

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Specified by:

close in interface SvetovidReader

Throws:

SvetovidIOException - if an error occurred during the operation.

readBool

public boolean readBool()
                 throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads one token and converts it to a boolean value.

Specified by:

readBool in interface SvetovidReader

Returns:

the boolean value read.

Throws:

SvetovidFormatException - if the token is not a parsable boolean.

SvetovidIOException - if an error occurred during the operation.

parseBool

protected boolean parseBool(String string)
                     throws NumberFormatException

Throws:

NumberFormatException

readByte

public byte readByte()
              throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads one token and converts it to a byte value.

Specified by:

readByte in interface SvetovidReader

Returns:

the byte value read.

Throws:

SvetovidFormatException - if the token is not a parsable byte.

SvetovidIOException - if an error occurred during the operation.

readShort

public short readShort()
                throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads one token and converts it to a short integer value.

Specified by:

readShort in interface SvetovidReader

Returns:

the short value read.

Throws:

SvetovidFormatException - if the token is not a parsable short.

SvetovidIOException - if an error occurred during the operation.

readInt

public int readInt()
            throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads one token and converts it to an integer value.

Specified by:

readInt in interface SvetovidReader

Returns:

the int value read.

Throws:

SvetovidFormatException - if the token is not a parsable int.

SvetovidIOException - if an error occurred during the operation.

readLong

public long readLong()
              throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads one token and converts it to a long integer value.

Specified by:

readLong in interface SvetovidReader

Returns:

the long value read.

Throws:

SvetovidFormatException - if the token is not a parsable long.

SvetovidIOException - if an error occurred during the operation.

readFloat

public float readFloat()
                throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads one token and converts it to a floating-point value.

Specified by:

readFloat in interface SvetovidReader

Returns:

the float value read.

Throws:

SvetovidFormatException - if the token is not a parsable float.

SvetovidIOException - if an error occurred during the operation.

readDouble

public double readDouble()
                  throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads one token and converts it to a double-precision floating-point value.

Specified by:

readDouble in interface SvetovidReader

Returns:

the double value read.

Throws:

SvetovidFormatException - if the token is not a parsable double.

SvetovidIOException - if an error occurred during the operation.

readChar

public char readChar()
              throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads one token and converts it to a character value.

Specified by:

readChar in interface SvetovidReader

Returns:

the char value read.

Throws:

SvetovidFormatException - if the token is not a parsable char.

SvetovidIOException - if an error occurred during the operation.

parseChar

protected char parseChar(String string)
                  throws NumberFormatException

Throws:

NumberFormatException

readToken

public String readToken()
                 throws SvetovidIOException

Description copied from interface: SvetovidReader

Reads one token and returns it as a string value.

Specified by:

readToken in interface SvetovidReader

Returns:

the String value read.

Throws:

SvetovidIOException - if an error occurred during the operation.

readBoolBoxed

public Boolean readBoolBoxed()
                      throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads one token and converts it to a boolean value.

Specified by:

readBoolBoxed in interface SvetovidReader

Returns:

the Boolean value read.

Throws:

SvetovidFormatException - if the token is not a parsable boolean.

SvetovidIOException - if an error occurred during the operation.

readByteBoxed

public Byte readByteBoxed()
                   throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads one token and converts it to a byte value.

Specified by:

readByteBoxed in interface SvetovidReader

Returns:

the Byte value read.

Throws:

SvetovidFormatException - if the token is not a parsable byte.

SvetovidIOException - if an error occurred during the operation.

readShortBoxed

public Short readShortBoxed()
                     throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads one token and converts it to a short integer value.

Specified by:

readShortBoxed in interface SvetovidReader

Returns:

the Short value read.

Throws:

SvetovidFormatException - if the token is not a parsable short.

SvetovidIOException - if an error occurred during the operation.

readIntBoxed

public Integer readIntBoxed()
                     throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads one token and converts it to an integer value.

Specified by:

readIntBoxed in interface SvetovidReader

Returns:

the Integer value read.

Throws:

SvetovidFormatException - if the token is not a parsable int.

SvetovidIOException - if an error occurred during the operation.

readLongBoxed

public Long readLongBoxed()
                   throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads one token and converts it to a long integer value.

Specified by:

readLongBoxed in interface SvetovidReader

Returns:

the Long value read.

Throws:

SvetovidFormatException - if the token is not a parsable long.

SvetovidIOException - if an error occurred during the operation.

readFloatBoxed

public Float readFloatBoxed()
                     throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads one token and converts it to a floating-point value.

Specified by:

readFloatBoxed in interface SvetovidReader

Returns:

the Float value read.

Throws:

SvetovidFormatException - if the token is not a parsable float.

SvetovidIOException - if an error occurred during the operation.

readDoubleBoxed

public Double readDoubleBoxed()
                       throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads one token and converts it to a double-precision floating-point value.

Specified by:

readDoubleBoxed in interface SvetovidReader

Returns:

the Double value read.

Throws:

SvetovidFormatException - if the token is not a parsable double.

SvetovidIOException - if an error occurred during the operation.

readCharBoxed

public Character readCharBoxed()
                        throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads one token and converts it to a character value.

Specified by:

readCharBoxed in interface SvetovidReader

Returns:

the Character value read.

Throws:

SvetovidFormatException - if the token is not a parsable character.

SvetovidIOException - if an error occurred during the operation.

readBoolArray

public boolean[] readBoolArray()
                        throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads one line, separates it into tokens and converts them to boolean values.

Specified by:

readBoolArray in interface SvetovidReader

Returns:

an array of boolean values read.

Throws:

SvetovidFormatException - if one of the tokens is not a parsable boolean.

SvetovidIOException - if an error occurred during the operation.

readByteArray

public byte[] readByteArray()
                     throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads one line, separates it into tokens and converts them to byte values.

Specified by:

readByteArray in interface SvetovidReader

Returns:

an array of byte values read.

Throws:

SvetovidFormatException - if one of the tokens is not a parsable byte.

SvetovidIOException - if an error occurred during the operation.

readShortArray

public short[] readShortArray()
                       throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads one line, separates it into tokens and converts them to short integer values.

Specified by:

readShortArray in interface SvetovidReader

Returns:

an array of short values read.

Throws:

SvetovidFormatException - if one of the tokens is not a parsable short.

SvetovidIOException - if an error occurred during the operation.

readIntArray

public int[] readIntArray()
                   throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads one line, separates it into tokens and converts them to integer values.

Specified by:

readIntArray in interface SvetovidReader

Returns:

an array of int values read.

Throws:

SvetovidFormatException - if one of the tokens is not a parsable integer.

SvetovidIOException - if an error occurred during the operation.

readLongArray

public long[] readLongArray()
                     throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads one line, separates it into tokens and converts them to long integer values.

Specified by:

readLongArray in interface SvetovidReader

Returns:

an array of long values read.

Throws:

SvetovidFormatException - if one of the tokens is not a parsable long.

SvetovidIOException - if an error occurred during the operation.

readFloatArray

public float[] readFloatArray()
                       throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads one line, separates it into tokens and converts them to floating-point values.

Specified by:

readFloatArray in interface SvetovidReader

Returns:

an array of float values read.

Throws:

SvetovidFormatException - if one of the tokens is not a parsable float.

SvetovidIOException - if an error occurred during the operation.

readDoubleArray

public double[] readDoubleArray()
                         throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads one line, separates it into tokens and converts them to double-precision floating-point values.

Specified by:

readDoubleArray in interface SvetovidReader

Returns:

an array of double values read.

Throws:

SvetovidFormatException - if one of the tokens is not a parsable double.

SvetovidIOException - if an error occurred during the operation.

readCharArray

public char[] readCharArray()
                     throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads one line, separates it into tokens and converts them to character values.

Specified by:

readCharArray in interface SvetovidReader

Returns:

an array of char values read.

Throws:

SvetovidFormatException - if one of the tokens is not a parsable character.

SvetovidIOException - if an error occurred during the operation.

readTokenArray

public String[] readTokenArray()
                        throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads one line, separates it into tokens and returns them as string values.

Specified by:

readTokenArray in interface SvetovidReader

Returns:

an array of String values read.

Throws:

SvetovidIOException - if an error occurred during the operation.

SvetovidFormatException

readBoolArrayBoxed

public Boolean[] readBoolArrayBoxed()
                             throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads one line, separates it into tokens and converts them to boolean values.

Specified by:

readBoolArrayBoxed in interface SvetovidReader

Returns:

an array of Boolean values read.

Throws:

SvetovidFormatException - if one of the tokens is not a parsable boolean.

SvetovidIOException - if an error occurred during the operation.

readByteArrayBoxed

public Byte[] readByteArrayBoxed()
                          throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads one line, separates it into tokens and converts them to byte values.

Specified by:

readByteArrayBoxed in interface SvetovidReader

Returns:

an array of Byte values read.

Throws:

SvetovidFormatException - if one of the tokens is not a parsable byte.

SvetovidIOException - if an error occurred during the operation.

readShortArrayBoxed

public Short[] readShortArrayBoxed()
                            throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads one line, separates it into tokens and converts them to short integer values.

Specified by:

readShortArrayBoxed in interface SvetovidReader

Returns:

an array of Short values read.

Throws:

SvetovidFormatException - if one of the tokens is not a parsable short.

SvetovidIOException - if an error occurred during the operation.

readIntArrayBoxed

public Integer[] readIntArrayBoxed()
                            throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads one line, separates it into tokens and converts them to integer values.

Specified by:

readIntArrayBoxed in interface SvetovidReader

Returns:

an array of Integer values read.

Throws:

SvetovidFormatException - if one of the tokens is not a parsable integer.

SvetovidIOException - if an error occurred during the operation.

readLongArrayBoxed

public Long[] readLongArrayBoxed()
                          throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads one line, separates it into tokens and converts them to long integer values.

Specified by:

readLongArrayBoxed in interface SvetovidReader

Returns:

an array of Long values read.

Throws:

SvetovidFormatException - if one of the tokens is not a parsable long.

SvetovidIOException - if an error occurred during the operation.

readFloatArrayBoxed

public Float[] readFloatArrayBoxed()
                            throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads one line, separates it into tokens and converts them to floating-point values.

Specified by:

readFloatArrayBoxed in interface SvetovidReader

Returns:

an array of Float values read.

Throws:

SvetovidFormatException - if one of the tokens is not a parsable float.

SvetovidIOException - if an error occurred during the operation.

readDoubleArrayBoxed

public Double[] readDoubleArrayBoxed()
                              throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads one line, separates it into tokens and converts them to double-precision floating-point values.

Specified by:

readDoubleArrayBoxed in interface SvetovidReader

Returns:

an array of Double values read.

Throws:

SvetovidFormatException - if one of the tokens is not a parsable double.

SvetovidIOException - if an error occurred during the operation.

readCharArrayBoxed

public Character[] readCharArrayBoxed()
                               throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads one line, separates it into tokens and converts them to character values.

Specified by:

readCharArrayBoxed in interface SvetovidReader

Returns:

an array of Character values read.

Throws:

SvetovidFormatException - if one of the tokens is not a parsable character.

SvetovidIOException - if an error occurred during the operation.

readLine

public String readLine()
                throws SvetovidIOException

Description copied from interface: SvetovidReader

Reads a line of text and returns it as a string. A line is considered to be terminated by any one of a line feed ('\n'), a carriage return ('\r'), or a carriage return followed immediately by a line feed.

Specified by:

readLine in interface SvetovidReader

Returns:

A String containing the contents of the line, not including any line-termination characters, or null if the end of the source has been reached.

Throws:

SvetovidIOException - if an error occurred during the operation.

doReadLine

protected abstract String doReadLine()
                              throws IOException

Throws:

IOException

readAllLines

public String[] readAllLines()
                      throws SvetovidIOException

Description copied from interface: SvetovidReader

Read all remaining lines and returns them as an array of strings. A line is considered to be terminated by any one of a line feed ('\n'), a carriage return ('\r'), or a carriage return followed immediately by a line feed.

Specified by:

readAllLines in interface SvetovidReader

Returns:

A String array containing the contents of the remaining lines, not including any line-termination characters, or an empty array if the end of the source has been reached.

Throws:

SvetovidIOException - if an error occurred during the operation.

readAll

public String readAll()
               throws SvetovidIOException

Description copied from interface: SvetovidReader

Reads all remaining content and returns it as a string.

Specified by:

readAll in interface SvetovidReader

Returns:

A String containing all the remaining contents of the source, or null if the end of the source has been reached.

Throws:

SvetovidIOException - if an error occurred during the operation.

readBoolMatrix

public boolean[][] readBoolMatrix()
                           throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads multiple lines and converts the data to a boolean matrix. The matrix is read row by row until an empty row is found or the end of input is reached.

Specified by:

readBoolMatrix in interface SvetovidReader

Returns:

a matrix of boolean values read.

Throws:

SvetovidFormatException - if one of the read values is not a parsable boolean.

SvetovidIOException - if an error occurred during the operation.

readByteMatrix

public byte[][] readByteMatrix()
                        throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads multiple lines and converts the data to a byte matrix. The matrix is read row by row until an empty row is found or the end of input is reached.

Specified by:

readByteMatrix in interface SvetovidReader

Returns:

a matrix of byte values read.

Throws:

SvetovidFormatException - if one of the read values is not a parsable byte.

SvetovidIOException - if an error occurred during the operation.

readShortMatrix

public short[][] readShortMatrix()
                          throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads multiple lines and converts the data to a shot integer matrix. The matrix is read row by row until an empty row is found or the end of input is reached.

Specified by:

readShortMatrix in interface SvetovidReader

Returns:

a matrix of short values read.

Throws:

SvetovidFormatException - if one of the read values is not a parsable short.

SvetovidIOException - if an error occurred during the operation.

readIntMatrix

public int[][] readIntMatrix()
                      throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads multiple lines and converts the data to an integer matrix. The matrix is read row by row until an empty row is found or the end of input is reached.

Specified by:

readIntMatrix in interface SvetovidReader

Returns:

a matrix of int values read.

Throws:

SvetovidFormatException - if one of the read values is not a parsable integer.

SvetovidIOException - if an error occurred during the operation.

readLongMatrix

public long[][] readLongMatrix()
                        throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads multiple lines and converts the data to a long integer matrix. The matrix is read row by row until an empty row is found or the end of input is reached.

Specified by:

readLongMatrix in interface SvetovidReader

Returns:

a matrix of long values read.

Throws:

SvetovidFormatException - if one of the read values is not a parsable long.

SvetovidIOException - if an error occurred during the operation.

readFloatMatrix

public float[][] readFloatMatrix()
                          throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads multiple lines and converts the data to a floating-point matrix. The matrix is read row by row until an empty row is found or the end of input is reached.

Specified by:

readFloatMatrix in interface SvetovidReader

Returns:

a matrix of float values read.

Throws:

SvetovidFormatException - if one of the read values is not a parsable float.

SvetovidIOException - if an error occurred during the operation.

readDoubleMatrix

public double[][] readDoubleMatrix()
                            throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads multiple lines and converts the data to a double-precision floating-point matrix. The matrix is read row by row until an empty row is found or the end of input is reached.

Specified by:

readDoubleMatrix in interface SvetovidReader

Returns:

a matrix of double values read.

Throws:

SvetovidFormatException - if one of the read values is not a parsable double.

SvetovidIOException - if an error occurred during the operation.

readCharMatrix

public char[][] readCharMatrix()
                        throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads multiple lines and converts the data to a character matrix. The matrix is read row by row until an empty row is found or the end of input is reached.

Specified by:

readCharMatrix in interface SvetovidReader

Returns:

a matrix of char values read.

Throws:

SvetovidFormatException - if one of the read values is not a parsable character.

SvetovidIOException - if an error occurred during the operation.

readTokenMatrix

public String[][] readTokenMatrix()
                           throws SvetovidIOException

Description copied from interface: SvetovidReader

Reads multiple lines and converts the data to a string matrix. The matrix is read row by row until an empty row is found or the end of input is reached.

Specified by:

readTokenMatrix in interface SvetovidReader

Returns:

a matrix of String values read.

Throws:

SvetovidIOException - if an error occurred during the operation.

readBoolMatrixBoxed

public Boolean[][] readBoolMatrixBoxed()
                                throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads multiple lines and converts the data to a boolean matrix. The matrix is read row by row until an empty row is found or the end of input is reached.

Specified by:

readBoolMatrixBoxed in interface SvetovidReader

Returns:

a matrix of Boolean values read.

Throws:

SvetovidFormatException - if one of the read values is not a parsable boolean.

SvetovidIOException - if an error occurred during the operation.

readByteMatrixBoxed

public Byte[][] readByteMatrixBoxed()
                             throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads multiple lines and converts the data to a byte matrix. The matrix is read row by row until an empty row is found or the end of input is reached.

Specified by:

readByteMatrixBoxed in interface SvetovidReader

Returns:

a matrix of Byte values read.

Throws:

SvetovidFormatException - if one of the read values is not a parsable byte.

SvetovidIOException - if an error occurred during the operation.

readShortMatrixBoxed

public Short[][] readShortMatrixBoxed()
                               throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads multiple lines and converts the data to a shot integer matrix. The matrix is read row by row until an empty row is found or the end of input is reached.

Specified by:

readShortMatrixBoxed in interface SvetovidReader

Returns:

a matrix of Short values read.

Throws:

SvetovidFormatException - if one of the read values is not a parsable short.

SvetovidIOException - if an error occurred during the operation.

readIntMatrixBoxed

public Integer[][] readIntMatrixBoxed()
                               throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads multiple lines and converts the data to an integer matrix. The matrix is read row by row until an empty row is found or the end of input is reached.

Specified by:

readIntMatrixBoxed in interface SvetovidReader

Returns:

a matrix of Integer values read.

Throws:

SvetovidFormatException - if one of the read values is not a parsable integer.

SvetovidIOException - if an error occurred during the operation.

readLongMatrixBoxed

public Long[][] readLongMatrixBoxed()
                             throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads multiple lines and converts the data to a long integer matrix. The matrix is read row by row until an empty row is found or the end of input is reached.

Specified by:

readLongMatrixBoxed in interface SvetovidReader

Returns:

a matrix of Long values read.

Throws:

SvetovidFormatException - if one of the read values is not a parsable long.

SvetovidIOException - if an error occurred during the operation.

readFloatMatrixBoxed

public Float[][] readFloatMatrixBoxed()
                               throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads multiple lines and converts the data to a floating-point matrix. The matrix is read row by row until an empty row is found or the end of input is reached.

Specified by:

readFloatMatrixBoxed in interface SvetovidReader

Returns:

a matrix of Float values read.

Throws:

SvetovidFormatException - if one of the read values is not a parsable float.

SvetovidIOException - if an error occurred during the operation.

readDoubleMatrixBoxed

public Double[][] readDoubleMatrixBoxed()
                                 throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads multiple lines and converts the data to a double-precision floating-point matrix. The matrix is read row by row until an empty row is found or the end of input is reached.

Specified by:

readDoubleMatrixBoxed in interface SvetovidReader

Returns:

a matrix of Double values read.

Throws:

SvetovidFormatException - if one of the read values is not a parsable double.

SvetovidIOException - if an error occurred during the operation.

readCharMatrixBoxed

public Character[][] readCharMatrixBoxed()
                                  throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads multiple lines and converts the data to a character matrix. The matrix is read row by row until an empty row is found or the end of input is reached.

Specified by:

readCharMatrixBoxed in interface SvetovidReader

Returns:

a matrix of Character values read.

Throws:

SvetovidFormatException - if one of the read values is not a parsable character.

SvetovidIOException - if an error occurred during the operation.

readObject

public Object readObject()
                  throws SvetovidFormatException,
SvetovidIOException

Description copied from interface: SvetovidReader

Reads a JSON (JavaScript Object Notation) formatted object.

The object is converted to Java types using the following rules:

• literal null is converted to Java null,
• literals true and false are converted to Boolean.TRUE and Boolean.FALSE respectively,
• numbers are converted to an instance of the first numeric type from the following list that can hold the value read: Byte, Short, Integer, Long, Float, Double, BigInteger, BigDecimal,
• strings are converted to String values,
• arrays are converted to Lists containing the held values in the same order
• and objects are converted to Maps that can be iterated in the order in which its members were defined. Each member's value is registered in the map under its name.

Specified by:

readObject in interface SvetovidReader

Returns:

a Java Object parsed form the JSON format according to the above rules.

Throws:

SvetovidFormatException - if the object to be read is not in the JSON format.

SvetovidIOException - if an error occurred during the operation.

nextChar

protected char nextChar()
                 throws SvetovidIOException,
EOFException

Throws:

SvetovidIOException

EOFException

returnChar

protected void returnChar(char ch)

isCharWhitespace

protected boolean isCharWhitespace(char ch)

isCharWhitespaceOrSymbol

protected boolean isCharWhitespaceOrSymbol(char ch)

isCharInNumber

protected boolean isCharInNumber(char ch)

nextToken

protected void nextToken()
                  throws SvetovidIOException

Throws:

SvetovidIOException

nextLiteral

protected Boolean nextLiteral()
                       throws SvetovidFormatException

Throws:

SvetovidFormatException

nextNumber

protected Number nextNumber()
                     throws SvetovidFormatException

Throws:

SvetovidFormatException

nextString

protected String nextString()
                     throws SvetovidFormatException

Throws:

SvetovidFormatException

nextArray

protected List<Object> nextArray()
                          throws SvetovidFormatException,
SvetovidIOException

Throws:

SvetovidFormatException

SvetovidIOException

readNextObject

protected Map<String,Object> readNextObject()
                                     throws SvetovidFormatException,
SvetovidIOException

Throws:

SvetovidFormatException

SvetovidIOException

nextPair

protected Map.Entry<String,Object> nextPair()
                                     throws SvetovidFormatException,
SvetovidIOException

Throws:

SvetovidFormatException

SvetovidIOException

nextValue

protected Object nextValue()
                    throws SvetovidFormatException,
SvetovidIOException

Throws:

SvetovidFormatException

SvetovidIOException