com.atlassian.bamboo.util

Class BambooIterables

java.lang.Object

com.atlassian.bamboo.util.BambooIterables

public final class BambooIterables
extends Object

Method Summary

Methods

Modifier and Type	Method and Description
static <T> Iterable<T>	concat(Iterable<? extends T> iterable, T object) Combines an iterable and an element into a single iterable.
static <T> Iterable<T>	concat(T object, Iterable<? extends T> iterable) Combines an iterable and an element into a single iterable.
static <T,E extends Throwable,F extends Throwable> T	find(Iterable<T> iterable, DoubleThrowingPredicate<? super T,E,F> predicate, T defaultValue) Returns the first element in iterable that satisfies the given predicate, or defaultValue if none found.
static <T> T	find(Iterable<T> iterable, com.google.common.base.Predicate<? super T> predicate, String exceptionMessage) Utility method to customize exception message thrown by Iterables.find(Iterable, com.google.common.base.Predicate).
static <T,E extends Throwable> T	find(Iterable<T> iterable, ThrowingPredicate<? super T,E> predicate, T defaultValue) Returns the first element in iterable that satisfies the given predicate, or defaultValue if none found.
static boolean	hasSize(Iterable<?> iterable, int size) Checks if the supplied iterable is of size size.
<T> boolean	none(Iterable<T> iterable, com.google.common.base.Predicate<? super T> predicate) Returns true if no elements in iterable fulfill predicate
static <T> T	removeFirst(Iterable<T> iterable, com.google.common.base.Predicate<T> predicate) Removes first object matching the predicate
static <T> Pair<Iterable<T>,Iterable<T>>	split(Iterable<T> unfiltered, com.google.common.base.Predicate<T> predicate) Splits iterable into a pair of two iterables, one fulfilling the predicate and one not fulfillling it.
static <T> Pair<Iterable<T>,Iterable<T>>	split(List<T> unfiltered, com.google.common.base.Predicate<T> predicate) Deprecated. since 5.7 use the Iterable variant

Methods inherited from class java.lang.Object

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

Method Detail

find

@Nullable
public static <T,E extends Throwable> T find(Iterable<T> iterable,
                                      ThrowingPredicate<? super T,E> predicate,
                                      @Nullable
                                      T defaultValue)
              throws E extends Throwable

Returns the first element in iterable that satisfies the given predicate, or defaultValue if none found.

Throws:

E extends Throwable

find

@Nullable
public static <T,E extends Throwable,F extends Throwable> T find(Iterable<T> iterable,
                                                          DoubleThrowingPredicate<? super T,E,F> predicate,
                                                          @Nullable
                                                          T defaultValue)
              throws E extends Throwable,
                     F extends Throwable

Returns the first element in iterable that satisfies the given predicate, or defaultValue if none found.

Throws:

E extends Throwable

none

public <T> boolean none(@NotNull
               Iterable<T> iterable,
               @NotNull
               com.google.common.base.Predicate<? super T> predicate)

Returns true if no elements in iterable fulfill predicate

find

public static <T> T find(Iterable<T> iterable,
         com.google.common.base.Predicate<? super T> predicate,
         @Nullable
         String exceptionMessage)

Utility method to customize exception message thrown by Iterables.find(Iterable, com.google.common.base.Predicate).

concat

public static <T> Iterable<T> concat(Iterable<? extends T> iterable,
                     T object)

Combines an iterable and an element into a single iterable. The returned iterable has an iterator that traverses the elements in a, followed by b. The source iterator is not polled until necessary. The returned iterable's iterator supports remove() when the corresponding input iterator supports it.

concat

public static <T> Iterable<T> concat(T object,
                     Iterable<? extends T> iterable)

Combines an iterable and an element into a single iterable. The returned iterable has an iterator that returns a, followed by the elements in b. The source iterator is not polled until necessary. The returned iterable's iterator supports remove() when the corresponding input iterator supports it.

split

@Deprecated
public static <T> Pair<Iterable<T>,Iterable<T>> split(List<T> unfiltered,
                                                 com.google.common.base.Predicate<T> predicate)

Deprecated. since 5.7 use the Iterable variant

Splits iterable into a pair of two iterables, one fulfilling the predicate and one not fulfillling it. The predicate will be run twice over the unfiltered list, so don't use this with large lists or slow predicates.

Parameters:

unfiltered -

predicate -

split

public static <T> Pair<Iterable<T>,Iterable<T>> split(Iterable<T> unfiltered,
                                      com.google.common.base.Predicate<T> predicate)

Splits iterable into a pair of two iterables, one fulfilling the predicate and one not fulfillling it. The predicate will be run twice over the unfiltered list, so don't use this with large lists or slow predicates.

Parameters:

unfiltered -

predicate -

removeFirst

@Nullable
public static <T> T removeFirst(@NotNull
                         Iterable<T> iterable,
                         @NotNull
                         com.google.common.base.Predicate<T> predicate)

Removes first object matching the predicate

hasSize

public static boolean hasSize(@NotNull
              Iterable<?> iterable,
              int size)

Checks if the supplied iterable is of size size.