com.github.ykrasik.jaci.util.function

Class MoreSuppliers

java.lang.Object

com.github.ykrasik.jaci.util.function.MoreSuppliers

public final class MoreSuppliers
extends java.lang.Object

Supplier related utilities.

Method Summary

Modifier and Type	Method and Description
static <T> Spplr<T>	cache(Spplr<T> supplier) Wrap the given supplier in a supplier that will only call the underlying supplier once, and then cache the returned value.
static <T,R> Spplr<R>	map(Spplr<T> supplier, Func<T,R> function) Create a supplier that will transform the value returned by the given supplier by invoking the given function on it.
static <T> Spplr<T>	of(T value) Create a supplier that will return the given value.

Methods inherited from class java.lang.Object

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

Method Detail

of

public static <T> Spplr<T> of(T value)

Create a supplier that will return the given value.

Type Parameters:

T - Value type.

Parameters:

value - Value to return.

Returns:

A Spplr that will return the given constant value.

map

public static <T,R> Spplr<R> map(Spplr<T> supplier,
                                 Func<T,R> function)

Create a supplier that will transform the value returned by the given supplier by invoking the given function on it. This operation is also known as 'map'. If the given supplier is a const supplier type (supplies a constant or cache value), the returned supplier will also cache the result of the transformation and not re-calculate it on every call.

Type Parameters:

T - Supplied value type.

R - Transformed value type.

Parameters:

supplier - Supplier to transform.

function - Function to transform the supplier with.

Returns:

A Spplr that will apply the given function to the value supplied by the given supplier.

cache

public static <T> Spplr<T> cache(Spplr<T> supplier)

Wrap the given supplier in a supplier that will only call the underlying supplier once, and then cache the returned value. The following calls will returned the cached value. A 'lazy supplier' of sorts.

Type Parameters:

T - Supplied value type.

Parameters:

supplier - Supplier to cache.

Returns:

A Spplr that will call the wrapped supplier once and only once and cache the value for future calls.