Package org.apache.iceberg.io

Interface CloseableIterable<T>

All Superinterfaces:

AutoCloseable, Closeable, Iterable<T>

All Known Implementing Classes:

CloseableIterable.ConcatCloseableIterable

public interface CloseableIterable<T>
extends Iterable<T>, Closeable

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static class	CloseableIterable.ConcatCloseableIterable<E>

Method Summary

Modifier and Type	Method	Description
static <E> CloseableIterable<E>	combine(Iterable<E> iterable, Closeable closeable)
static <E> CloseableIterable<E>	concat(Iterable<CloseableIterable<E>> iterable)
static <T> CloseableIterable<T>	count(Counter counter, CloseableIterable<T> iterable)	Counts the number of elements in the given CloseableIterable by incrementing the Counter instance for each Iterator.next() call.
static <E> CloseableIterable<E>	empty()
static <E> CloseableIterable<E>	filter(CloseableIterable<E> iterable, Predicate<E> pred)
static <E> CloseableIterable<E>	filter(Counter skipCounter, CloseableIterable<E> iterable, Predicate<E> pred)	Filters the given CloseableIterable and counts the number of elements that do not match the predicate by incrementing the Counter.
CloseableIterator<T>	iterator()	Returns a closeable iterator over elements of type T.
static <E> CloseableIterable<E>	of(Iterable<E> iterable)	Adapts an Iterable to CloseableIterable using a no-op close if it is not Closeable.
static <I, O> CloseableIterable<O>	transform(CloseableIterable<I> iterable, Function<I,O> transform)
static <E> CloseableIterable<E>	whenComplete(CloseableIterable<E> iterable, Runnable onCompletionRunnable)	Will run the given runnable when Closeable.close() has been called.
static <E> CloseableIterable<E>	withNoopClose(E entry)
static <E> CloseableIterable<E>	withNoopClose(Iterable<E> iterable)

Methods inherited from interface java.io.Closeable

close

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Method Details

of

static <E> CloseableIterable<E> of(Iterable<E> iterable)

Adapts an Iterable to CloseableIterable using a no-op close if it is not Closeable.

Parameters:

iterable - an Iterable

Returns:

a CloseableIterable that closes Iterable if it is Closeable

iterator

CloseableIterator<T> iterator()

Returns a closeable iterator over elements of type T.

Specified by:

iterator in interface Iterable<T>

Returns:

an CloseableIterator.

withNoopClose

static <E> CloseableIterable<E> withNoopClose(E entry)

withNoopClose

static <E> CloseableIterable<E> withNoopClose(Iterable<E> iterable)

empty

static <E> CloseableIterable<E> empty()

combine

static <E> CloseableIterable<E> combine(Iterable<E> iterable,
 Closeable closeable)

whenComplete

static <E> CloseableIterable<E> whenComplete(CloseableIterable<E> iterable,
 Runnable onCompletionRunnable)

Will run the given runnable when Closeable.close() has been called.

Type Parameters:

E - The type of the underlying iterable

Parameters:

iterable - The underlying CloseableIterable to iterate over

onCompletionRunnable - The runnable to run after the underlying iterable was closed

Returns:

A new CloseableIterable where the runnable will be executed as the final step after Closeable.close() has been called

filter

static <E> CloseableIterable<E> filter(CloseableIterable<E> iterable,
 Predicate<E> pred)

filter

static <E> CloseableIterable<E> filter(Counter skipCounter,
 CloseableIterable<E> iterable,
 Predicate<E> pred)

Filters the given CloseableIterable and counts the number of elements that do not match the predicate by incrementing the Counter.

Type Parameters:

E - The underlying type to be iterated.

Parameters:

skipCounter - The Counter instance to increment on each skipped item during filtering.

iterable - The underlying CloseableIterable to filter.

Returns:

A filtered CloseableIterable where the given skipCounter is incremented whenever the predicate does not match.

count

static <T> CloseableIterable<T> count(Counter counter,
 CloseableIterable<T> iterable)

Counts the number of elements in the given CloseableIterable by incrementing the Counter instance for each Iterator.next() call.

Type Parameters:

T - The underlying type to be iterated.

Parameters:

counter - The Counter instance to increment on each Iterator.next() call.

iterable - The underlying CloseableIterable to count

Returns:

A CloseableIterable that increments the given counter on each Iterator.next() call.

transform

static <I,
O> CloseableIterable<O> transform(CloseableIterable<I> iterable,
 Function<I,O> transform)

concat

static <E> CloseableIterable<E> concat(Iterable<CloseableIterable<E>> iterable)