net.markenwerk.commons.iterables

Class FilteredIterable<Payload>

java.lang.Object

net.markenwerk.commons.iterables.FilteredIterable<Payload>

Type Parameters:

Payload - The payload type.

All Implemented Interfaces:

Iterable<Payload>

public final class FilteredIterable<Payload>
extends Object
implements Iterable<Payload>

A FilteredIterable is an Iterable that can be wrapped around a given Iterable and generates Iterators that filters out values according to a given Predicate.

Calling iterator() creates an instance of FilteredIterator.

Since:

1.0.0

Author:

Torsten Krause (tk at markenwerk dot net)

Constructor Summary

Constructors

Constructor and Description
FilteredIterable(Iterable<? extends Payload> iterable, Predicate<Payload> predicate) Creates a new FilteredIterable from the given Iterable.
FilteredIterable(Iterable<? extends Payload> iterable, Predicate<Payload> predicate, boolean invertPredicate) Creates a new FilteredIterable from the given Iterable.

Method Summary

Modifier and Type	Method and Description
FilteredIterator<Payload>	iterator()

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

FilteredIterable

public FilteredIterable(Iterable<? extends Payload> iterable,
                        Predicate<Payload> predicate)
                 throws IllegalArgumentException

Creates a new FilteredIterable from the given Iterable.

Parameters:

iterable - The Iterable, around which the new FilteredIterable will be wrapped.

predicate - The Predicate to test every value yielded by the given Iterable with.

Throws:

IllegalArgumentException - If the given Iterable is null or if the given Predicate is null.

FilteredIterable

public FilteredIterable(Iterable<? extends Payload> iterable,
                        Predicate<Payload> predicate,
                        boolean invertPredicate)
                 throws IllegalArgumentException

Creates a new FilteredIterable from the given Iterable.

Parameters:

iterable - The Iterable, around which the new FilteredIterable will be wrapped.

predicate - The Predicate to test every value yielded by the given Iterable with.

invertPredicate - Whether to invert the test result and yield values that don't satisfy the given Predicate.

Throws:

IllegalArgumentException - If the given Iterable is null or if the given Predicate is null.

Method Detail

iterator

public FilteredIterator<Payload> iterator()

Specified by:

iterator in interface Iterable<Payload>