Class MapBackedScopelet<M extends MapBackedScopelet<M>>

java.lang.Object

org.microbean.scopelet.Scopelet<M>

org.microbean.scopelet.MapBackedScopelet<M>

Type Parameters:

M - the MapBackedScopelet subclass extending this class

All Implemented Interfaces:

AutoCloseable, Constable, Aggregate, Factory<M>, ScopeMember

Direct Known Subclasses:

SingletonScopelet

public abstract class MapBackedScopelet<M extends MapBackedScopelet<M>>
extends Scopelet<M>

A thread-safe, partial Scopelet implementation backed by ConcurrentMap machinery.

Author:

Laird Nelson

Field Summary

Fields inherited from interface org.microbean.bean.Aggregate

EMPTY_ASSIGNMENTS, EMPTY_DEPENDENCIES

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	MapBackedScopelet(NamedAttributeMap<?> scopeId)	Creates a new MapBackedScopelet.

Method Summary

Modifier and Type	Method	Description
void	close()	Irrevocably closes this Scopelet, and, by doing so, notionally makes it irrevocably inactive.
<I> I	instance(Object beanId, Factory<I> factory, Request<I> request)	Checks to see if this Scopelet is active and then returns a pre-existing or created-on-demand contextual instance suitable for the combination of identifier, Factory and Request.
boolean	remove(Object id)	Checks to see if this Scopelet is active and then removes any contextual instance stored under the supplied id, returning true if and only if removal actually took place.

Methods inherited from class org.microbean.scopelet.Scopelet

active, bean, closed, containsId, create, destroys, equals, get, governedBy, governingScopeId, hashCode, id, instance, scopeId, singleton

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.microbean.bean.Aggregate

assign, dependencies

Methods inherited from interface org.microbean.bean.Factory

describeConstable, destroy

Constructor Details

MapBackedScopelet

protected MapBackedScopelet(NamedAttributeMap<?> scopeId)

Creates a new MapBackedScopelet.

Parameters:

scopeId - a NamedAttributeMap identifying the scope this MapBackedScopelet serves; must not be null

Throws:

NullPointerException - if scopeId is null

See Also:

• Scopelet(NamedAttributeMap)

Method Details

instance

public <I> I instance(Object beanId,
 Factory<I> factory,
 Request<I> request)

Description copied from class: Scopelet

Checks to see if this Scopelet is active and then returns a pre-existing or created-on-demand contextual instance suitable for the combination of identifier, Factory and Request.

Specified by:

instance in class Scopelet<M extends MapBackedScopelet<M>>

Type Parameters:

I - the type of contextual instance

Parameters:

beanId - an identifier that can identify a contextual instance; may be null

factory - a Factory; may be null

request - a Request, typically the one in effect that is causing this method to be invoked in the first place; may be null

Returns:

a contextual instance, possibly pre-existing, or possibly created just in time, or null

remove

public boolean remove(Object id)

Description copied from class: Scopelet

Checks to see if this Scopelet is active and then removes any contextual instance stored under the supplied id, returning true if and only if removal actually took place.

The default implementation of this method always returns false. Subclasses are encouraged to override it as appropriate.

Overrides:

remove in class Scopelet<M extends MapBackedScopelet<M>>

Parameters:

id - an identifier; may be null

Returns:

true if and only if removal actually occurred

close

public void close()

Description copied from class: Scopelet

Irrevocably closes this Scopelet, and, by doing so, notionally makes it irrevocably inactive.

Specified by:

close in interface AutoCloseable

Overrides:

close in class Scopelet<M extends MapBackedScopelet<M>>

See Also:

• Scopelet.closed()
• Scopelet.active()