Class InterceptingProducer<I>

java.lang.Object

org.microbean.bean.InterceptingProducer<I>

Type Parameters:

I - the type of contextual instance

All Implemented Interfaces:

Aggregate, Producer<I>

public final class InterceptingProducer<I>
extends Object
implements Producer<I>

A Producer that applies constructor interception to produce contextual instances.

Author:

Laird Nelson

See Also:

• InterceptorMethod

Field Summary

Fields inherited from interface org.microbean.bean.Aggregate

EMPTY_ASSIGNMENTS, EMPTY_DEPENDENCIES

Constructor Summary

Constructors

Constructor	Description
InterceptingProducer(Collection<? extends org.microbean.interceptor.InterceptorMethod> interceptorMethods, Producer<I> producer)	Creates a new InterceptingProducer.

Method Summary

Modifier and Type	Method	Description
final SequencedSet<? extends Assignment<?>>	assign(Request<?> r)	Calls the assign(Request) method on the Producer supplied at construction time with the supplied Request and returns the result.
final SequencedSet<AttributedElement>	dependencies()	Calls the dependencies() method on the Producer supplied at construction time and returns the result.
final void	dispose(I i, Request<I> r)	Calls the dispose(Object, Request) method on the Producer supplied at construction time with the supplied i and the supplied Request.
final I	produce(SequencedSet<? extends Assignment<?>> assignments)	Calls the produce(SequencedSet) method on the Producer supplied at construction time with the supplied assignments and returns the result.
final I	produce(Request<?> r)	Produces a potentially uninitialized contextual instance and returns it, using the Collection of InterceptorMethods supplied at construction time to intercept the production.

Methods inherited from class java.lang.Object

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

Constructor Details

InterceptingProducer

public InterceptingProducer(Collection<? extends org.microbean.interceptor.InterceptorMethod> interceptorMethods,
 Producer<I> producer)

Creates a new InterceptingProducer.

Parameters:

interceptorMethods - a Collection of InterceptorMethods; must not be null

producer - a subordinate Producer to which are delegated the assign(Request), dependencies(), dispose(Object, Request) and produce(SequencedSet) operations; must not be null

Throws:

NullPointerException - if either argument is null

Method Details

assign

public final SequencedSet<? extends Assignment<?>> assign(Request<?> r)

Calls the assign(Request) method on the Producer supplied at construction time with the supplied Request and returns the result.

Specified by:

assign in interface Aggregate

Parameters:

r - a Request; must not be null

Returns:

the result of calling the assign(Request) method on the Producer supplied at construction time; never null

Throws:

NullPointerException - if r is null

See Also:

• InterceptingProducer(Collection, Producer)
• Aggregate.assign(Request)

dependencies

public final SequencedSet<AttributedElement> dependencies()

Calls the dependencies() method on the Producer supplied at construction time and returns the result.

Specified by:

dependencies in interface Aggregate

Returns:

the result of calling the dependencies() method on the Producer supplied at construction time; never null

See Also:

• InterceptingProducer(Collection, Producer)
• Aggregate.dependencies()

dispose

public final void dispose(I i,
 Request<I> r)

Calls the dispose(Object, Request) method on the Producer supplied at construction time with the supplied i and the supplied Request.

Specified by:

dispose in interface Producer<I>

Parameters:

i - a contextual instance produced by this InterceptingProducer; may be null

r - a Request; must not be null

Throws:

NullPointerException - if r is null

See Also:

• InterceptingProducer(Collection, Producer)
• Aggregate.assign(Request)

produce

public final I produce(Request<?> r)

Produces a potentially uninitialized contextual instance and returns it, using the Collection of InterceptorMethods supplied at construction time to intercept the production.

Specified by:

produce in interface Producer<I>

Parameters:

r - a Request; must not be null

Returns:

a contextual instance, which may be null

Throws:

NullPointerException - if r is null

See Also:

• InterceptingProducer(Collection, Producer)
• Producer.produce(Request)

produce

public final I produce(SequencedSet<? extends Assignment<?>> assignments)

Calls the produce(SequencedSet) method on the Producer supplied at construction time with the supplied assignments and returns the result.

Specified by:

produce in interface Producer<I>

Parameters:

assignments - a SequencedSet of Assignments; must not be null

Returns:

a new contextual instance, or null

Throws:

NullPointerException - if assignments is null

See Also:

• InterceptingProducer(Collection, Producer)
• Producer.produce(SequencedSet)