Class Request<I,R>

java.lang.Object

org.microbean.reference.Request<I,R>

Type Parameters:

I - the contextual instance type (see for example Creation)

R - the contextual reference type (see References)

All Implemented Interfaces:

AutoCloseable, Iterable<R>, Creation<I>, Destruction, References<R>, ReferencesSelector

public final class Request<I,R>
extends Object
implements Creation<I>, Destruction, References<R>

A central object representing a request for dependencies that is a Creation (and therefore also a Destruction) and a References.

Instances of this class are the heart and soul of a dependency injection and acquisition system.

Author:

Laird Nelson

See Also:

• Creation
• Destruction
• References
• Factory.create(Creation)
• Factory.destroy(Object, Destruction)

Constructor Summary

Constructors

Constructor	Description
Request(Selectable<? super AttributedType,Bean<?>> s, Instances instances, AutoCloseableRegistry acr, ClientProxier cp)	Creates a new Request.

Method Summary

Modifier and Type	Method	Description
final void	close()
final boolean	destroy(R r)
final Id	id()
final Iterator<R>	iterator()
final <R> References<R>	references(AttributedType t)
final int	size()

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.microbean.bean.Creation

creating

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Methods inherited from interface org.microbean.bean.References

get

Methods inherited from interface org.microbean.bean.ReferencesSelector

reference

Constructor Details

Request

public Request(Selectable<? super AttributedType,Bean<?>> s,
 Instances instances,
 AutoCloseableRegistry acr,
 ClientProxier cp)

Creates a new Request.

Parameters:

s - a Selectable providing access to Beans by AttributedType; must not be null; must be safe for concurrent use by multiple threads; often assembled out of methods present in the Selectables and Beans classes, among other such utility classes

instances - an Instances responsible for using a Bean to acquire an appropriate Supplier of contextual instances; must not be null

acr - an AutoCloseableRegistry; may be null in which case a default implementation will be used instead

cp - a ClientProxier; must not be null

Throws:

NullPointerException - if s, instances, or cp is null

Method Details

close

public final void close()

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Destruction

id

public final Id id()

Specified by:

id in interface Creation<I>

iterator

public final Iterator<R> iterator()

Specified by:

iterator in interface Iterable<I>

references

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

Specified by:

references in interface ReferencesSelector

size

public final int size()

Specified by:

size in interface References<I>

destroy

public final boolean destroy(R r)

Specified by:

destroy in interface References<I>