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
• Selectables

Method Summary

Modifier and Type	Method	Description
static final <C, E extends Ranked> Selectable<C,E>	ambiguityReducing(Selectable<C,E> s)	Deprecated, for removal: This API element is subject to removal in a future version. Please use the ambiguityReducing(Selectable, Predicate, ToIntFunction) method instead.
static final <C, E> Selectable<C,E>	ambiguityReducing(Selectable<C,E> s, Predicate<? super E> p, ToIntFunction<? super E> ranker)	Returns a Selectable that reduces any ambiguity in the results returned by another Selectable, considering alternate status and rank.
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

@Deprecated(forRemoval=true,
            since="0.0.19")
public static final <C,
E extends Ranked>
Selectable<C,E> ambiguityReducing(Selectable<C,E> s)

Deprecated, for removal: This API element is subject to removal in a future version.

Please use the ambiguityReducing(Selectable, Predicate, ToIntFunction) method instead.

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()
• ambiguityReducing(Selectable, Predicate, ToIntFunction)

ambiguityReducing

public static final <C,
E> Selectable<C,E> ambiguityReducing(Selectable<C,E> s,
 Predicate<? super E> p,
 ToIntFunction<? super E> ranker)

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

p - a Predicate that tests whether an element is an alternate; must not be null

ranker - a ToIntFunction that returns a rank for an alternate; a rank of 0 indicates no particular rank; must not be null

Returns:

a non-null Selectable

Throws:

NullPointerException - if any argument 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:

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