Package io.micronaut.context

Class AbstractBeanResolutionContext

java.lang.Object

io.micronaut.context.AbstractBeanResolutionContext

All Implemented Interfaces:

BeanLocator, BeanResolutionContext, ConversionServiceProvider, ValueResolver<CharSequence>, AutoCloseable

Direct Known Subclasses:

DefaultBeanResolutionContext

@Internal
public abstract class AbstractBeanResolutionContext
extends Object
implements BeanResolutionContext

Default implementation of the BeanResolutionContext interface.

Since:

1.2.3

Author:

Graeme Rocher

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected static class	AbstractBeanResolutionContext.AbstractSegment<B,T>	Abstract class for a Segment.
static final class	AbstractBeanResolutionContext.AnnotationSegment<B>	A segment that represents annotation.
static final class	AbstractBeanResolutionContext.ConstructorArgumentSegment	A segment that represents a method argument.
static class	AbstractBeanResolutionContext.ConstructorSegment	A segment that represents a constructor.
static class	AbstractBeanResolutionContext.EventListenerSegment<B,T>	Represents a segment that is an event listener.
static final class	AbstractBeanResolutionContext.FieldSegment<B,T>	A segment that represents a field.
static final class	AbstractBeanResolutionContext.MethodArgumentSegment	A segment that represents a method argument.
static class	AbstractBeanResolutionContext.MethodSegment<B,T>	A segment that represents a method.

Nested classes/interfaces inherited from interface io.micronaut.context.BeanResolutionContext

BeanResolutionContext.Path, BeanResolutionContext.Segment<B,T>

Field Summary

Fields

Modifier and Type	Field	Description
protected final DefaultBeanContext	context
protected final BeanResolutionContext.Path	path
protected final BeanDefinition<?>	rootDefinition

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AbstractBeanResolutionContext(DefaultBeanContext context, BeanDefinition<?> rootDefinition)

Method Summary

Modifier and Type	Method	Description
<T> void	addDependentBean(BeanRegistration<T> beanRegistration)	Adds a dependent bean to the resolution context.
void	copyStateFrom(@NonNull AbstractBeanResolutionContext context)	Copy the state from a previous resolution context.
void	destroyInjectScopedBeans()	Call back to destroy any InjectScope beans.
<T> @NonNull Optional<T>	findBean(@NonNull Argument<T> beanType, @Nullable Qualifier<T> qualifier)	Finds a Bean for the given type and qualifier.
<T> Optional<T>	findBean(Class<T> beanType, Qualifier<T> qualifier)	Finds a Bean for the given type and qualifier.
final <T> Collection<BeanDefinition<T>>	findBeanDefinitions(@NonNull Argument<T> argument, BeanDefinition<?> bd)
<T> Optional<T>	get(CharSequence name, ArgumentConversionContext<T> conversionContext)	Resolve the given property for the given name.
<T> Optional<T>	get(CharSequence name, Class<T> requiredType)	Resolve the given property for the given name.
@NonNull List<BeanRegistration<?>>	getAndResetDependentBeans()
BeanRegistration<?>	getAndResetDependentFactoryBean()
final Object	getAttribute(CharSequence key)
Map<CharSequence,Object>	getAttributes()	Get the map representing current attributes.
<T> T	getBean(@NonNull Argument<T> beanType, @Nullable Qualifier<T> qualifier)	Obtains a Bean for the given type and qualifier.
<T> T	getBean(BeanDefinition<T> definition)	Obtains a Bean for the given bean definition.
<T> T	getBean(Class<T> beanType, Qualifier<T> qualifier)	Obtains a Bean for the given type and qualifier.
final <T> BeanRegistration<T>	getBeanRegistration(Argument<T> argument, Qualifier<T> qualifier)
<T> @NonNull Collection<BeanRegistration<T>>	getBeanRegistrations(@NonNull Argument<T> beanType, @Nullable Qualifier<T> qualifier)	Obtains the bean registrations for the given type and qualifier.
<T> @NonNull Collection<T>	getBeansOfType(@NonNull Argument<T> beanType, @Nullable Qualifier<T> qualifier)	Get all beans of the given type.
<T> Collection<T>	getBeansOfType(Argument<T> beanType)	Get all beans of the given type.
<T> Collection<T>	getBeansOfType(Class<T> beanType)	Get all beans of the given type.
<T> Collection<T>	getBeansOfType(Class<T> beanType, Qualifier<T> qualifier)	Get all beans of the given type.
ConfigurationPath	getConfigurationPath()
final BeanContext	getContext()
ConversionService	getConversionService()	Provides the conversion service.
@Nullable Qualifier<?>	getCurrentQualifier()
final BeanResolutionContext.Path	getPath()
PropertyResolver	getPropertyResolver()
<T> T	getProxyTargetBean(BeanDefinition<T> definition, Argument<T> beanType, Qualifier<T> qualifier)	Resolves the proxy target for a given proxy bean definition.
<T> T	getProxyTargetBean(Class<T> beanType, Qualifier<T> qualifier)	Resolves the proxy target for a given bean type.
final BeanDefinition	getRootDefinition()
<V> Map<String,V>	mapOfType(Argument<V> beanType, Qualifier<V> qualifier)	Obtain a map of beans of the given type where the key is the qualifier.
void	markDependentAsFactory()	Marks first dependent as factory.
List<BeanRegistration<?>>	popDependentBeans()
void	pushDependentBeans(List<BeanRegistration<?>> dependentBeans)	The push the current dependent beans that must be destroyed by an upstream bean.
final Object	removeAttribute(CharSequence key)	Remove the attribute for the given key.
Object	resolvePropertyValue(Argument<?> argument, String stringValue, String cliProperty, boolean isPlaceholder)	Resolve a property value.
final Object	setAttribute(CharSequence key, Object value)	Store a value within the context.
void	setAttributes(Map<CharSequence,Object> attributes)	Set new attributes map (The map is supposed to be mutable).
ConfigurationPath	setConfigurationPath(ConfigurationPath configurationPath)	Sets the configuration path.
void	setCurrentQualifier(@Nullable Qualifier<?> qualifier)	Sets the current qualifier.
<T> @NonNull Stream<T>	streamOfType(@NonNull Argument<T> beanType, @Nullable Qualifier<T> qualifier)	Obtain a stream of beans of the given type.
<T> Stream<T>	streamOfType(Class<T> beanType, Qualifier<T> qualifier)	Obtain a stream of beans of the given type.
void	valueResolved(Argument<?> argument, Qualifier<?> qualifier, String property, Object value)	Callback when a value is resolved in some other context.

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.micronaut.context.BeanLocator

findBean, findBean, findOrInstantiateBean, getBean, getBean, getProvider, getProvider, getProvider, getProvider, getProxyTargetBean, mapOfType, mapOfType, mapOfType, streamOfType, streamOfType

Methods inherited from interface io.micronaut.context.BeanResolutionContext

addInFlightBean, close, copy, getInFlightBean, removeInFlightBean

Methods inherited from interface io.micronaut.core.value.ValueResolver

get, get

Field Details

context

protected final DefaultBeanContext context

rootDefinition

protected final BeanDefinition<?> rootDefinition

path

protected final BeanResolutionContext.Path path

Constructor Details

AbstractBeanResolutionContext

@Internal
protected AbstractBeanResolutionContext(DefaultBeanContext context,
 BeanDefinition<?> rootDefinition)

Parameters:

context - The bean context

rootDefinition - The bean root definition

Method Details

getConversionService

public ConversionService getConversionService()

Description copied from interface: ConversionServiceProvider

Provides the conversion service.

Specified by:

getConversionService in interface ConversionServiceProvider

Returns:

the conversion service

getPropertyResolver

public PropertyResolver getPropertyResolver()

Specified by:

getPropertyResolver in interface BeanResolutionContext

Returns:

The property resolver

getConfigurationPath

public ConfigurationPath getConfigurationPath()

Specified by:

getConfigurationPath in interface BeanResolutionContext

Returns:

The configuration path.

setConfigurationPath

public ConfigurationPath setConfigurationPath(ConfigurationPath configurationPath)

Description copied from interface: BeanResolutionContext

Sets the configuration path.

Specified by:

setConfigurationPath in interface BeanResolutionContext

Parameters:

configurationPath - The configuration path.

Returns:

The previous path

valueResolved

public void valueResolved(Argument<?> argument,
 Qualifier<?> qualifier,
 String property,
 Object value)

Description copied from interface: BeanResolutionContext

Callback when a value is resolved in some other context.

Specified by:

valueResolved in interface BeanResolutionContext

Parameters:

argument - The argument

qualifier - The qualifier

property - The property

value - The value

resolvePropertyValue

public Object resolvePropertyValue(Argument<?> argument,
 String stringValue,
 String cliProperty,
 boolean isPlaceholder)

Description copied from interface: BeanResolutionContext

Resolve a property value.

Specified by:

resolvePropertyValue in interface BeanResolutionContext

Parameters:

argument - The argument

stringValue - The string value

cliProperty - The CLI property

isPlaceholder - Whether it is a place holder

Returns:

The resolved value

getBean

@NonNull
public <T> T getBean(@NonNull
 @NonNull Argument<T> beanType,
 @Nullable
 @Nullable Qualifier<T> qualifier)

Description copied from interface: BeanLocator

Obtains a Bean for the given type and qualifier.

Specified by:

getBean in interface BeanLocator

Type Parameters:

T - The bean type parameter

Parameters:

beanType - The potentially parameterized bean type

qualifier - The qualifier

Returns:

An instanceof said bean

See Also:

• Qualifiers

getBean

public <T> T getBean(Class<T> beanType,
 Qualifier<T> qualifier)

Description copied from interface: BeanLocator

Obtains a Bean for the given type and qualifier.

Specified by:

getBean in interface BeanLocator

Type Parameters:

T - The bean type parameter

Parameters:

beanType - The bean type

qualifier - The qualifier

Returns:

An instanceof said bean

See Also:

• Qualifiers

getBean

public <T> T getBean(BeanDefinition<T> definition)

Description copied from interface: BeanLocator

Obtains a Bean for the given bean definition.

Specified by:

getBean in interface BeanLocator

Type Parameters:

T - The bean type parameter

Parameters:

definition - The bean type

Returns:

An instanceof said bean

See Also:

• Qualifiers

getBeansOfType

@NonNull
public <T> @NonNull Collection<T> getBeansOfType(@NonNull
 @NonNull Argument<T> beanType,
 @Nullable
 @Nullable Qualifier<T> qualifier)

Description copied from interface: BeanLocator

Get all beans of the given type.

Specified by:

getBeansOfType in interface BeanLocator

Type Parameters:

T - The bean type parameter

Parameters:

beanType - The potenitally parameterized bean type

qualifier - The qualifier

Returns:

The found beans

getBeansOfType

public <T> Collection<T> getBeansOfType(Class<T> beanType)

Description copied from interface: BeanLocator

Get all beans of the given type.

Specified by:

getBeansOfType in interface BeanLocator

Type Parameters:

T - The bean type parameter

Parameters:

beanType - The bean type

Returns:

The found beans

getBeansOfType

public <T> Collection<T> getBeansOfType(Class<T> beanType,
 Qualifier<T> qualifier)

Description copied from interface: BeanLocator

Get all beans of the given type.

Specified by:

getBeansOfType in interface BeanLocator

Type Parameters:

T - The bean type parameter

Parameters:

beanType - The bean type

qualifier - The qualifier

Returns:

The found beans

streamOfType

@NonNull
public <T> @NonNull Stream<T> streamOfType(@NonNull
 @NonNull Argument<T> beanType,
 @Nullable
 @Nullable Qualifier<T> qualifier)

Description copied from interface: BeanLocator

Obtain a stream of beans of the given type.

Specified by:

streamOfType in interface BeanLocator

Type Parameters:

T - The bean concrete type

Parameters:

beanType - The potentially parameterized bean type

qualifier - The qualifier

Returns:

A stream of instances

See Also:

• Qualifiers

streamOfType

public <T> Stream<T> streamOfType(Class<T> beanType,
 Qualifier<T> qualifier)

Description copied from interface: BeanLocator

Obtain a stream of beans of the given type.

Specified by:

streamOfType in interface BeanLocator

Type Parameters:

T - The bean concrete type

Parameters:

beanType - The bean type

qualifier - The qualifier

Returns:

A stream of instances

See Also:

• Qualifiers

mapOfType

public <V> Map<String,V> mapOfType(Argument<V> beanType,
 Qualifier<V> qualifier)

Description copied from interface: BeanLocator

Obtain a map of beans of the given type where the key is the qualifier.

Specified by:

mapOfType in interface BeanLocator

Type Parameters:

V - The bean concrete type

Parameters:

beanType - The potentially parameterized bean type

qualifier - The qualifier

Returns:

A map of instances

See Also:

• Qualifiers

findBean

@NonNull
public <T> @NonNull Optional<T> findBean(@NonNull
 @NonNull Argument<T> beanType,
 @Nullable
 @Nullable Qualifier<T> qualifier)

Description copied from interface: BeanLocator

Finds a Bean for the given type and qualifier.

Specified by:

findBean in interface BeanLocator

Type Parameters:

T - The bean type parameter

Parameters:

beanType - The bean type

qualifier - The qualifier

Returns:

An instance of Optional that is either empty or containing the specified bean

See Also:

• Qualifiers

findBean

public <T> Optional<T> findBean(Class<T> beanType,
 Qualifier<T> qualifier)

Description copied from interface: BeanLocator

Finds a Bean for the given type and qualifier.

Specified by:

findBean in interface BeanLocator

Type Parameters:

T - The bean type parameter

Parameters:

beanType - The bean type

qualifier - The qualifier

Returns:

An instance of Optional that is either empty or containing the specified bean

See Also:

• Qualifiers

getBeansOfType

public <T> Collection<T> getBeansOfType(Argument<T> beanType)

Description copied from interface: BeanLocator

Get all beans of the given type.

Specified by:

getBeansOfType in interface BeanLocator

Type Parameters:

T - The bean type parameter

Parameters:

beanType - The potenitally parameterized bean type

Returns:

The found beans

getProxyTargetBean

public <T> T getProxyTargetBean(Class<T> beanType,
 Qualifier<T> qualifier)

Description copied from interface: BeanLocator

Resolves the proxy target for a given bean type. If the bean has no proxy then the original bean is returned.

Specified by:

getProxyTargetBean in interface BeanLocator

Type Parameters:

T - The generic type

Parameters:

beanType - The bean type

qualifier - The bean qualifier

Returns:

The proxied instance

getBeanRegistrations

@NonNull
public <T> @NonNull Collection<BeanRegistration<T>> getBeanRegistrations(@NonNull
 @NonNull Argument<T> beanType,
 @Nullable
 @Nullable Qualifier<T> qualifier)

Description copied from interface: BeanResolutionContext

Obtains the bean registrations for the given type and qualifier.

Specified by:

getBeanRegistrations in interface BeanResolutionContext

Type Parameters:

T - The generic type

Parameters:

beanType - The bean type

qualifier - The qualifier

Returns:

A collection of BeanRegistration

copyStateFrom

public void copyStateFrom(@NonNull
 @NonNull AbstractBeanResolutionContext context)

Copy the state from a previous resolution context.

Parameters:

context - The previous context

addDependentBean

public <T> void addDependentBean(BeanRegistration<T> beanRegistration)

Description copied from interface: BeanResolutionContext

Adds a dependent bean to the resolution context.

Specified by:

addDependentBean in interface BeanResolutionContext

Type Parameters:

T - The generic type

Parameters:

beanRegistration - The bean registration

destroyInjectScopedBeans

public void destroyInjectScopedBeans()

Description copied from interface: BeanResolutionContext

Call back to destroy any InjectScope beans.

Specified by:

destroyInjectScopedBeans in interface BeanResolutionContext

See Also:

• InjectScope

getAndResetDependentBeans

@NonNull
public @NonNull List<BeanRegistration<?>> getAndResetDependentBeans()

Specified by:

getAndResetDependentBeans in interface BeanResolutionContext

Returns:

The dependent beans that must be destroyed by an upstream bean

markDependentAsFactory

public void markDependentAsFactory()

Description copied from interface: BeanResolutionContext

Marks first dependent as factory. Dependent can be missing which means it's a singleton or scoped bean.

Specified by:

markDependentAsFactory in interface BeanResolutionContext

getAndResetDependentFactoryBean

public BeanRegistration<?> getAndResetDependentFactoryBean()

Specified by:

getAndResetDependentFactoryBean in interface BeanResolutionContext

Returns:

The dependent factory beans that was used to create the bean in context

popDependentBeans

public List<BeanRegistration<?>> popDependentBeans()

Specified by:

popDependentBeans in interface BeanResolutionContext

Returns:

The current dependent beans that must be destroyed by an upstream bean

pushDependentBeans

public void pushDependentBeans(List<BeanRegistration<?>> dependentBeans)

Description copied from interface: BeanResolutionContext

The push the current dependent beans that must be destroyed by an upstream bean.

Specified by:

pushDependentBeans in interface BeanResolutionContext

Parameters:

dependentBeans - Dependent beans collection that can be used to add more dependents

getContext

public final BeanContext getContext()

Specified by:

getContext in interface BeanResolutionContext

Returns:

The context

getRootDefinition

public final BeanDefinition getRootDefinition()

Specified by:

getRootDefinition in interface BeanResolutionContext

Returns:

The class requested at the root of this resolution context

getPath

public final BeanResolutionContext.Path getPath()

Specified by:

getPath in interface BeanResolutionContext

Returns:

The path that this resolution has taken so far

setAttribute

public final Object setAttribute(CharSequence key,
 Object value)

Description copied from interface: BeanResolutionContext

Store a value within the context.

Specified by:

setAttribute in interface BeanResolutionContext

Parameters:

key - The key

value - The value

Returns:

The previous value or null

getAttribute

public final Object getAttribute(CharSequence key)

Specified by:

getAttribute in interface BeanResolutionContext

Parameters:

key - The key

Returns:

The attribute value

removeAttribute

public final Object removeAttribute(CharSequence key)

Description copied from interface: BeanResolutionContext

Remove the attribute for the given key.

Specified by:

removeAttribute in interface BeanResolutionContext

Parameters:

key - the key

Returns:

The previous value

getAttributes

public Map<CharSequence,Object> getAttributes()

Description copied from interface: BeanResolutionContext

Get the map representing current attributes.

Specified by:

getAttributes in interface BeanResolutionContext

Returns:

All attributes

setAttributes

public void setAttributes(Map<CharSequence,Object> attributes)

Description copied from interface: BeanResolutionContext

Set new attributes map (The map is supposed to be mutable).

Specified by:

setAttributes in interface BeanResolutionContext

Parameters:

attributes - The attributes

getCurrentQualifier

@Nullable
public @Nullable Qualifier<?> getCurrentQualifier()

Specified by:

getCurrentQualifier in interface BeanResolutionContext

Returns:

The current bean identifier

setCurrentQualifier

public void setCurrentQualifier(@Nullable
 @Nullable Qualifier<?> qualifier)

Description copied from interface: BeanResolutionContext

Sets the current qualifier.

Specified by:

setCurrentQualifier in interface BeanResolutionContext

Parameters:

qualifier - The qualifier

get

public <T> Optional<T> get(CharSequence name,
 ArgumentConversionContext<T> conversionContext)

Description copied from interface: ValueResolver

Resolve the given property for the given name.

Specified by:

get in interface ValueResolver<CharSequence>

Type Parameters:

T - The concrete type

Parameters:

name - The name

conversionContext - The conversion context

Returns:

An optional containing the property value if it exists and is able to be converted

get

public <T> Optional<T> get(CharSequence name,
 Class<T> requiredType)

Description copied from interface: ValueResolver

Resolve the given property for the given name.

Specified by:

get in interface ValueResolver<CharSequence>

Type Parameters:

T - The concrete type

Parameters:

name - The name

requiredType - The required type

Returns:

An optional containing the property value if it exists and is able to be converted

findBeanDefinitions

public final <T> Collection<BeanDefinition<T>> findBeanDefinitions(@NonNull
 @NonNull Argument<T> argument,
 BeanDefinition<?> bd)

getBeanRegistration

public final <T> BeanRegistration<T> getBeanRegistration(Argument<T> argument,
 Qualifier<T> qualifier)

getProxyTargetBean

public <T> T getProxyTargetBean(BeanDefinition<T> definition,
 Argument<T> beanType,
 Qualifier<T> qualifier)

Description copied from interface: BeanResolutionContext

Resolves the proxy target for a given proxy bean definition. If the bean has no proxy then the original bean is returned.

Specified by:

getProxyTargetBean in interface BeanResolutionContext

Type Parameters:

T - The generic type

Parameters:

definition - The proxy bean definition

beanType - The bean type

qualifier - The bean qualifier

Returns:

The proxied instance