Class Selectables

java.lang.Object

org.microbean.bean.Selectables

public final class Selectables
extends Object

Utility methods for working with Selectables.

Author:

Laird Nelson

See Also:

• Selectable

Method Summary

Modifier and Type	Method	Description
static final <C, E extends Ranked> Selectable<C,E>	ambiguityReducing(Selectable<C,E> s)	Returns a Selectable that reduces any ambiguity in the results returned by another Selectable, considering alternate status and rank.
static <C, E> Selectable<C,E>	caching(Selectable<C,E> selectable)	Returns a Selectable that caches its results.
static <C, E> Selectable<C,E>	caching(Selectable<C,E> selectable, BiFunction<? super C,Function<? super C,? extends List<E>>,? extends List<E>> f)	Returns a Selectable that caches its results.
static final <C, E> Selectable<C,E>	empty()	Returns a Selectable whose Selectable.select(Object) method always returns an empty, immutable List.
static <C, E> Selectable<C,E>	filtering(Collection<? extends E> collection, BiFunction<? super E,? super C,? extends Boolean> f)	Returns a Selectable using the supplied Collection as its elements, and the supplied BiFunction as its selector function.
static final Selectable<AttributedType,Bean<?>>	typesafeReducing(Collection<? extends Bean<?>> beans, Matcher<? super AttributedType,? super Id> m)	Normalizes the supplied Collection of Beans and returns a Selectable for it and the supplied Matcher.

Methods inherited from class java.lang.Object

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

Method Details

ambiguityReducing

public static final <C,
E extends Ranked>
Selectable<C,E> ambiguityReducing(Selectable<C,E> s)

Returns a Selectable that reduces any ambiguity in the results returned by another Selectable, considering alternate status and rank.

Type Parameters:

C - the criteria type

E - the element type

Parameters:

s - a Selectable; must not be null

Returns:

a non-null Selectable

Throws:

NullPointerException - if s is null

See Also:

• Ranked.rank()
• Ranked.alternate()

caching

public static <C,
E> Selectable<C,E> caching(Selectable<C,E> selectable)

Returns a Selectable that caches its results.

The cache is unbounded.

Type Parameters:

C - the criteria type

E - the element type

Parameters:

selectable - a Selectable; must not be null

Returns:

a non-null Selectable

Throws:

NullPointerException - if selectable is null

See Also:

• caching(Selectable, BiFunction)

caching

public static <C,
E> Selectable<C,E> caching(Selectable<C,E> selectable,
 BiFunction<? super C,Function<? super C,? extends List<E>>,? extends List<E>> f)

Returns a Selectable that caches its results.

Type Parameters:

C - the criteria type

E - the element type

Parameters:

selectable - a Selectable; must not be null

f - a BiFunction that returns a cached result, computing it on demand via its supplied mapping Function if necessary; must not be null; normally safe for concurrent use by multiple threads; often a reference to the ConcurrentHashMap.computeIfAbsent(Object, Function) method

Returns:

a non-null Selectable

Throws:

NullPointerException - if selectable or f is null

See Also:

• ConcurrentHashMap.computeIfAbsent(Object, Function)

empty

public static final <C,
E> Selectable<C,E> empty()

Returns a Selectable whose Selectable.select(Object) method always returns an empty, immutable List.

Type Parameters:

C - the criteria type

E - the element type

Returns:

a non-null Selectable

filtering

public static <C,
E> Selectable<C,E> filtering(Collection<? extends E> collection,
 BiFunction<? super E,? super C,? extends Boolean> f)

Returns a Selectable using the supplied Collection as its elements, and the supplied BiFunction as its selector function.

There is no guarantee that this method will return new Selectable instances.

The Selectable instances returned by this method may or may not cache their selections.

The selector function must select a sublist from the supplied Collection as mediated by the supplied criteria. The selector function must additionally be idempotent and must produce a determinate value when given the same arguments.

No validation of these semantics of the selector function is performed.

Type Parameters:

C - the criteria type

E - the element type

Parameters:

collection - a Collection of elements from which sublists may be selected; must not be null

f - the selector function; must not be null

Returns:

a Selectable; never null

Throws:

NullPointerException - if either collection or f is null

typesafeReducing

public static final Selectable<AttributedType,Bean<?>> typesafeReducing(Collection<? extends Bean<?>> beans,
 Matcher<? super AttributedType,? super Id> m)

Normalizes the supplied Collection of Beans and returns a Selectable for it and the supplied Matcher.

The Selectable does not cache its results.

Parameters:

beans - a Collection of Beans; must not be null

m - an IdMatcher; must not be null

Returns:

a non-null Selectable

Throws:

NullPointerException - if any argument is null

See Also:

• filtering(Collection, BiFunction)
• ambiguityReducing(Selectable)
• caching(Selectable)
• Beans.normalize(Collection)