Interface ReferencesSelector

All Known Subinterfaces:

Creation<I>, Destruction, References<R>

public interface ReferencesSelector

A supplier of References objects.

Author:

Laird Nelson

See Also:

• references(AttributedType)
• reference(AttributedType)
• References

Method Summary

Modifier and Type	Method	Description
boolean	destroy(Object r)	Destroys the supplied contextual reference if and only if it meets the conditions for destruction.
default <R> R	reference(AttributedType t)	A convenience method that acquires and returns what is presumed, possibly incorrectly, to be the sole contextual reference of the relevant type.
<R> References<R>	references(AttributedType t)	Returns a References capable of locating contextual references of the relevant type.

Method Details

destroy

boolean destroy(Object r)

Destroys the supplied contextual reference if and only if it meets the conditions for destruction.

Parameters:

r - a contextual reference; may be null in which case false will be returned

Returns:

true if and only if destruction occurred

Throws:

DestructionException - if an error occurs

references

<R> References<R> references(AttributedType t)

Returns a References capable of locating contextual references of the relevant type.

Type Parameters:

R - the contextual reference type

Parameters:

t - an AttributedType describing the contextual reference type; must not be null

Returns:

a non-null References

Throws:

NullPointerException - if t is null

See Also:

• References

reference

default <R> R reference(AttributedType t)

A convenience method that acquires and returns what is presumed, possibly incorrectly, to be the sole contextual reference of the relevant type.

Type Parameters:

R - the contextual reference type

Parameters:

t - an AttributedType describing the contextual reference type; must not be null

Returns:

a non-null contextual reference

Throws:

NullPointerException - if t is null

UnsatisfiedReductionException - if there is no contextual reference for the relevant type

AmbiguousReductionException - if there is more than one contextual reference for the relevant type

See Also:

• references(AttributedType)
• References.get()