Class BeanQualifiersMatcher

java.lang.Object

org.microbean.bean.BeanQualifiersMatcher

All Implemented Interfaces:

BiPredicate<Collection<? extends Attributes>, Collection<? extends Attributes>>, Matcher<Collection<? extends Attributes>, Collection<? extends Attributes>>

public class BeanQualifiersMatcher
extends Object
implements Matcher<Collection<? extends Attributes>, Collection<? extends Attributes>>

A Matcher encapsulating CDI-compatible bean qualifier matching rules.

Author:

Laird Nelson

See Also:

• test(Collection, Collection)

Constructor Summary

Constructors

Constructor	Description
BeanQualifiersMatcher()	Creates a new BeanQualifiersMatcher.

Method Summary

Modifier and Type	Method	Description
protected Collection<? extends Attributes>	qualifiers(Collection<? extends Attributes> as)	Returns an unmodifiable Collection consisting only of those Attributess in the supplied Collection that are deemed to be qualifiers.
final boolean	test(Collection<? extends Attributes> receiverAttributes, Collection<? extends Attributes> payloadAttributes)	Returns true if and only if either (a) the collection of qualifiers present in receiverAttributes is empty and either the collection of qualifiers present in payloadAttributes is also empty or contains the default qualifier, or (b) if the collection of qualifiers present in payloadAttributes is empty or the return value of Qualifiers.anyAndDefaultQualifiers() contains all of the qualifiers present in receiverAttributes, or (c) if the collection of qualifiers present in payloadAttributes contains all of the qualifiers present in receiverAttributes.

Methods inherited from class Object

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

Methods inherited from interface BiPredicate

and, negate, or

Constructor Details

BeanQualifiersMatcher

public BeanQualifiersMatcher()

Creates a new BeanQualifiersMatcher.

Method Details

test

public final boolean test(Collection<? extends Attributes> receiverAttributes,
 Collection<? extends Attributes> payloadAttributes)

Returns true if and only if either (a) the collection of qualifiers present in receiverAttributes is empty and either the collection of qualifiers present in payloadAttributes is also empty or contains the default qualifier, or (b) if the collection of qualifiers present in payloadAttributes is empty or the return value of Qualifiers.anyAndDefaultQualifiers() contains all of the qualifiers present in receiverAttributes, or (c) if the collection of qualifiers present in payloadAttributes contains all of the qualifiers present in receiverAttributes.

Specified by:

test in interface BiPredicate<Collection<? extends Attributes>, Collection<? extends Attributes>>

Specified by:

test in interface Matcher<Collection<? extends Attributes>, Collection<? extends Attributes>>

Parameters:

receiverAttributes - a Collection of Attributess; must not be null

payloadAttributes - a Collection of Attributess; must not be null

Returns:

true if and only if either (a) the collection of qualifiers present in receiverAttributes is empty and either the collection of qualifiers present in payloadAttributes is also empty or contains the default qualifier, or (b) if the collection of qualifiers present in payloadAttributes is empty or the return value of Qualifiers.anyAndDefaultQualifiers() contains all of the qualifiers present in receiverAttributes, or (c) if the collection of qualifiers present in payloadAttributes contains all of the qualifiers present in receiverAttributes

Throws:

NullPointerException - if either receiverAttributes or payloadAttributes is null

qualifiers

protected Collection<? extends Attributes> qualifiers(Collection<? extends Attributes> as)

Returns an unmodifiable Collection consisting only of those Attributess in the supplied Collection that are deemed to be qualifiers.

The default implementation of this method returns the value of an invocation of the Qualifiers.qualifiers(Collection) method.

This method may be removed in favor of a compositional approach in future revisions of this class.

Parameters:

as - a Collection of Attributess; must not be null

Returns:

an unmodifiable Collection consisting only of those Attributess in the supplied Collection that are deemed to be qualifiers; never null

Throws:

NullPointerException - if as is null