com.google.cloud.dataflow.sdk.io

Interface Source.Reader<T>

All Superinterfaces:

java.lang.AutoCloseable

All Known Implementing Classes:

DatastoreIO.DatastoreReader

Enclosing class:

Source<T>

public static interface Source.Reader<T>
extends java.lang.AutoCloseable

The interface which readers of custom input sources must implement.

This interface is deliberately distinct from Iterator because the current model tends to be easier to program and more efficient in practice for iterating over sources such as files, databases etc. (rather than pure collections).

To read a SourceIterator:

 while (iterator.advance()) {
   T item = iterator.getCurrent();
   ...
 }
 

Note: this interface is work-in-progress and may change.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	advance() Advances the iterator to the next valid record.
void	close() Closes the iterator.
T	getCurrent() Returns the value of the data item which was read by the last advance() call.

Method Detail

advance

boolean advance()
                throws java.io.IOException

Advances the iterator to the next valid record. Invalidates the result of the previous getCurrent() call.

Returns:

true if a record was read, false if we're at the end of input.

Throws:

java.io.IOException

getCurrent

T getCurrent()
             throws java.util.NoSuchElementException

Returns the value of the data item which was read by the last advance() call.

Throws:

java.util.NoSuchElementException - if the iterator is at the beginning of the input and advance() wasn't called, or if the last advance() returned false.

close

void close()
           throws java.io.IOException

Closes the iterator. The iterator cannot be used after this method was called.

Specified by:

close in interface java.lang.AutoCloseable

Throws:

java.io.IOException