org.gcube.data.streams.delegates

Class UnfoldedStream<E1,E2>

java.lang.Object

org.gcube.data.streams.LookAheadStream<E2>

org.gcube.data.streams.delegates.UnfoldedStream<E1,E2>

Type Parameters:

E1 - the type of elements of the input stream

E2 - the type of stream elements

All Implemented Interfaces:

Iterator<E2>, Stream<E2>

public class UnfoldedStream<E1,E2>
extends LookAheadStream<E2>

A Stream of elements generated by unfolding the elements of an input Stream into multiple elements.

Author:

Fabio Simeoni

Field Summary

Fields inherited from class org.gcube.data.streams.LookAheadStream

element, hasNext

Constructor Summary

Constructors

Constructor and Description
UnfoldedStream(Stream<E1> stream, Generator<E1,Stream<E2>> generator) Creates an instance with a Stream and an element Generator.

Method Summary

Modifier and Type	Method and Description
void	close() Closes the stream unconditionally, releasing any resources that it may be using.
protected boolean	delegateHasNext() Returns true if the underlying stream has more elements.
protected E2	delegateNext() Returns an element of the underlying stream
boolean	isClosed() Returns true if the stream has been closed.
URI	locator() Returns the stream locator.
void	remove()
protected Stream<E1>	stream() Returns the underlying Stream.

Methods inherited from class org.gcube.data.streams.LookAheadStream

hasNext, next, setHandler

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Iterator

forEachRemaining

Constructor Detail

UnfoldedStream

public UnfoldedStream(Stream<E1> stream,
                      Generator<E1,Stream<E2>> generator)
               throws IllegalArgumentException

Creates an instance with a Stream and an element Generator.

Parameters:

stream - the stream

generator - the generator

Throws:

IllegalArgumentException - if the stream or the generator are null

Method Detail

delegateNext

protected E2 delegateNext()

Description copied from class: LookAheadStream

Returns an element of the underlying stream

Specified by:

delegateNext in class LookAheadStream<E2>

Returns:

the element

delegateHasNext

protected boolean delegateHasNext()

Description copied from class: LookAheadStream

Returns true if the underlying stream has more elements.

Specified by:

delegateHasNext in class LookAheadStream<E2>

Returns:

true if the underlying stream has more elements

close

public void close()

Description copied from interface: Stream

Closes the stream unconditionally, releasing any resources that it may be using.

Subsequent invocations of this method have no effect.
Subsequents invocations of Stream.hasNext() return false.
Subsequent invocations of Stream.next() throw NoSuchElementExceptions.

Failures are logged by implementations and suppressed otherwise.

Specified by:

close in interface Stream<E2>

stream

protected Stream<E1> stream()

Returns the underlying Stream.

Returns:

the stream

locator

public URI locator()
            throws IllegalStateException

Description copied from interface: Stream

Returns the stream locator.

Returns:

the locator

Throws:

IllegalStateException - if the stream is no longer addressable at the time of invocation.

remove

public void remove()

isClosed

public boolean isClosed()

Description copied from interface: Stream

Returns true if the stream has been closed.

Returns:

true if the stream has been closed