Module org.refcodes.tabular

Package org.refcodes.tabular

Interface RecordReader<T>

Type Parameters:

T - The type managed by the Records.

All Superinterfaces:

AutoCloseable, HeaderAccessor<T>, Iterable<T>, Iterator<T>, Records<T>, org.refcodes.io.RowReader<String[]>

All Known Implementing Classes:

CsvRecordReader, CsvStringRecordReader

public interface RecordReader<T>
extends AutoCloseable, Records<T>, HeaderAccessor<T>, org.refcodes.io.RowReader<String[]>

Extends the Records with functionality for file based implementations regarding header management and means to monitor the state of reading data. Reading Record instances may cause problems but no abortion of an operation (if desired), the statistics of the problems may be reported by an implementation of this interface.

Nested Class Summary

Nested classes/interfaces inherited from interface org.refcodes.tabular.HeaderAccessor

HeaderAccessor.HeaderBuilder<T extends HeaderAccessor.HeaderBuilder<?>>, HeaderAccessor.HeaderMutator<T>, HeaderAccessor.HeaderProperty<T>

Method Summary

Modifier and Type	Method	Description
long	getErroneousRecordCount()	The number of erroneous records which were not read by the RecordReader.
Header<T>	readHeader()	Creates a Header from the next line to be read .
String[]	readNext()	Reads the next line from the (standard) input (stream or file) and returns an array of its String representation.
String	skipHeader()	Skips the next line to be read.

Methods inherited from interface java.lang.AutoCloseable

close

Methods inherited from interface org.refcodes.tabular.HeaderAccessor

getHeader

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Methods inherited from interface java.util.Iterator

forEachRemaining, hasNext, next, remove

Methods inherited from interface org.refcodes.tabular.Records

iterator

Methods inherited from interface org.refcodes.io.RowReader

hasNext

Method Detail

getErroneousRecordCount

long getErroneousRecordCount()

The number of erroneous records which were not read by the RecordReader.

Returns:

the erroneous record count

readHeader

Header<T> readHeader()
              throws IOException

Creates a Header from the next line to be read .

Returns:

Returns the Header being read.

Throws:

IOException - thrown in case reading from IO failed.

skipHeader

String skipHeader()
           throws IOException

Skips the next line to be read. This line will not be processed by the Iterator.next() method. This methods is useful when skipping the first line (header).

Returns:

The line being skipped.

Throws:

IOException - thrown in case if IO problems.

readNext

String[] readNext()

Reads the next line from the (standard) input (stream or file) and returns an array of its String representation.

Specified by:

readNext in interface org.refcodes.io.RowReader<T>

Returns:

The String array representation of the next Record instance read.