org.datavec.api.records.reader

Interface RecordReader

All Superinterfaces:

java.lang.AutoCloseable, java.io.Closeable, Configurable, java.io.Serializable

All Known Subinterfaces:

SequenceRecordReader

All Known Implementing Classes:

BaseCodecRecordReader, BaseImageRecordReader, BaseRecordReader, CodecRecordReader, CollectionRecordReader, CollectionSequenceRecordReader, ComposableRecordReader, CSVNLinesSequenceRecordReader, CSVRecordReader, CSVRegexRecordReader, CSVSequenceRecordReader, FileRecordReader, ImageRecordReader, JacksonRecordReader, LibSvmRecordReader, LineRecordReader, ListStringRecordReader, MatlabRecordReader, NativeCodecRecordReader, RegexLineRecordReader, RegexSequenceRecordReader, SVMLightRecordReader, SVMLightRecordReader, TfidfRecordReader, VideoRecordReader, WavFileRecordReader

public interface RecordReader
extends java.io.Closeable, java.io.Serializable, Configurable

Record reader

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	APPEND_LABEL
static java.lang.String	LABELS
static java.lang.String	NAME_SPACE

Method Summary

Modifier and Type	Method and Description
java.util.List<java.lang.String>	getLabels() List of label strings
java.util.List<RecordListener>	getListeners() Get the record listeners for this record reader.
boolean	hasNext() Whether there are anymore records
void	initialize(Configuration conf, InputSplit split) Called once at initialization.
void	initialize(InputSplit split) Called once at initialization.
java.util.List<Record>	loadFromMetaData(java.util.List<RecordMetaData> recordMetaDatas) Load multiple records from the given a list of RecordMetaData instances
Record	loadFromMetaData(RecordMetaData recordMetaData) Load a single record from the given RecordMetaData instance Note: that for data that isn't splittable (i.e., text data that needs to be scanned/split), it is more efficient to load multiple records at once using loadFromMetaData(List)
java.util.List<Writable>	next() Get the next record
Record	nextRecord() Similar to next(), but returns a Record object, that may include metadata such as the source of the data
java.util.List<Writable>	record(java.net.URI uri, java.io.DataInputStream dataInputStream) Load the record from the given DataInputStream Unlike next() the internal state of the RecordReader is not modified Implementations of this method should not close the DataInputStream
void	reset() Reset record reader iterator
void	setListeners(java.util.Collection<RecordListener> listeners) Set the record listeners for this record reader.
void	setListeners(RecordListener... listeners) Set the record listeners for this record reader.

Methods inherited from interface java.io.Closeable

close

Methods inherited from interface org.datavec.api.conf.Configurable

getConf, setConf

Field Detail

NAME_SPACE

static final java.lang.String NAME_SPACE

APPEND_LABEL

static final java.lang.String APPEND_LABEL

LABELS

static final java.lang.String LABELS

Method Detail

initialize

void initialize(InputSplit split)
         throws java.io.IOException,
                java.lang.InterruptedException

Called once at initialization.

Parameters:

split - the split that defines the range of records to read

Throws:

java.io.IOException

java.lang.InterruptedException

initialize

void initialize(Configuration conf,
                InputSplit split)
         throws java.io.IOException,
                java.lang.InterruptedException

Called once at initialization.

Parameters:

conf - a configuration for initialization

split - the split that defines the range of records to read

Throws:

java.io.IOException

java.lang.InterruptedException

next

java.util.List<Writable> next()

Get the next record

Returns:

hasNext

boolean hasNext()

Whether there are anymore records

Returns:

getLabels

java.util.List<java.lang.String> getLabels()

List of label strings

Returns:

reset

void reset()

Reset record reader iterator

record

java.util.List<Writable> record(java.net.URI uri,
                                java.io.DataInputStream dataInputStream)
                         throws java.io.IOException

Load the record from the given DataInputStream Unlike next() the internal state of the RecordReader is not modified Implementations of this method should not close the DataInputStream

Throws:

java.io.IOException - if error occurs during reading from the input stream

nextRecord

Record nextRecord()

Similar to next(), but returns a Record object, that may include metadata such as the source of the data

Returns:

next record

loadFromMetaData

Record loadFromMetaData(RecordMetaData recordMetaData)
                 throws java.io.IOException

Load a single record from the given RecordMetaData instance
Note: that for data that isn't splittable (i.e., text data that needs to be scanned/split), it is more efficient to load multiple records at once using loadFromMetaData(List)

Parameters:

recordMetaData - Metadata for the record that we want to load from

Returns:

Single record for the given RecordMetaData instance

Throws:

java.io.IOException - If I/O error occurs during loading

loadFromMetaData

java.util.List<Record> loadFromMetaData(java.util.List<RecordMetaData> recordMetaDatas)
                                 throws java.io.IOException

Load multiple records from the given a list of RecordMetaData instances

Parameters:

recordMetaDatas - Metadata for the records that we want to load from

Returns:

Multiple records for the given RecordMetaData instances

Throws:

java.io.IOException - If I/O error occurs during loading

getListeners

java.util.List<RecordListener> getListeners()

Get the record listeners for this record reader.

setListeners

void setListeners(RecordListener... listeners)

Set the record listeners for this record reader.

setListeners

void setListeners(java.util.Collection<RecordListener> listeners)

Set the record listeners for this record reader.