io.micronaut.context

Interface BeanResolutionContext

All Superinterfaces:

AutoCloseable, ValueResolver<CharSequence>

All Known Implementing Classes:

AbstractBeanResolutionContext, DefaultBeanResolutionContext

@Internal
public interface BeanResolutionContext
extends ValueResolver<CharSequence>, AutoCloseable

Represents the resolution context for a current resolve of a given bean.

Since:

1.0

Author:

Graeme Rocher

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	BeanResolutionContext.Path Represents a path taken to resolve a bean definitions dependencies.
static interface	BeanResolutionContext.Segment<T> A segment in a path.

Method Summary

Modifier and Type	Method and Description
<T> void	addDependentBean(BeanIdentifier identifier, BeanDefinition<T> definition, T bean) Adds a dependent bean to the resolution context.
<T> void	addInFlightBean(BeanIdentifier beanIdentifier, T instance) Adds a bean that is created as part of the resolution.
default void	close()
BeanResolutionContext	copy() Copy current context to be used later.
void	destroyInjectScopedBeans() Call back to destroy any InjectScope beans.
default List<BeanRegistration<?>>	getAndResetDependentBeans()
Object	getAttribute(CharSequence key)
BeanContext	getContext()
Qualifier<?>	getCurrentQualifier()
<T> T	getInFlightBean(BeanIdentifier beanIdentifier) Obtains an inflight bean for the given identifier.
BeanResolutionContext.Path	getPath()
BeanDefinition	getRootDefinition()
Object	removeAttribute(CharSequence key) Remove the attribute for the given key.
void	removeInFlightBean(BeanIdentifier beanIdentifier) Removes a bean that is in the process of being created.
Object	setAttribute(CharSequence key, Object value) Store a value within the context.
void	setCurrentQualifier(Qualifier<?> qualifier) Sets the current qualifier.

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

get, get, get, get

Method Detail

close

default void close()

Specified by:

close in interface AutoCloseable

destroyInjectScopedBeans

void destroyInjectScopedBeans()

Call back to destroy any InjectScope beans.

Since:

3.1.0

See Also:

InjectScope

copy

BeanResolutionContext copy()

Copy current context to be used later.

Returns:

The bean resolution context

Since:

3.1.0

getContext

BeanContext getContext()

Returns:

The context

getRootDefinition

BeanDefinition getRootDefinition()

Returns:

The class requested at the root of this resolution context

getPath

BeanResolutionContext.Path getPath()

Returns:

The path that this resolution has taken so far

setAttribute

Object setAttribute(CharSequence key,
                    Object value)

Store a value within the context.

Parameters:

key - The key

value - The value

Returns:

The previous value or null

getAttribute

Object getAttribute(CharSequence key)

Parameters:

key - The key

Returns:

The attribute value

removeAttribute

Object removeAttribute(CharSequence key)

Remove the attribute for the given key.

Parameters:

key - the key

Returns:

The previous value

addInFlightBean

<T> void addInFlightBean(BeanIdentifier beanIdentifier,
                         T instance)

Adds a bean that is created as part of the resolution. This is used to store references to instances passed to BeanContext.inject(Object)

Type Parameters:

T - THe instance type

Parameters:

beanIdentifier - The bean identifier

instance - The instance

removeInFlightBean

void removeInFlightBean(BeanIdentifier beanIdentifier)

Removes a bean that is in the process of being created. This is used to store references to instances passed to BeanContext.inject(Object)

Parameters:

beanIdentifier - The bean identifier

getInFlightBean

@Nullable
<T> T getInFlightBean(BeanIdentifier beanIdentifier)

Obtains an inflight bean for the given identifier. An "In Flight" bean is one that is currently being created but has not finished construction and been registered as a singleton just yet. For example in the case whereby a bean as a PostConstruct method that also triggers bean resolution of the same bean.

Type Parameters:

T - The bean type

Parameters:

beanIdentifier - The bean identifier

Returns:

The bean

getCurrentQualifier

@Nullable
Qualifier<?> getCurrentQualifier()

Returns:

The current bean identifier

setCurrentQualifier

void setCurrentQualifier(@Nullable
                         Qualifier<?> qualifier)

Sets the current qualifier.

Parameters:

qualifier - The qualifier

addDependentBean

<T> void addDependentBean(BeanIdentifier identifier,
                          BeanDefinition<T> definition,
                          T bean)

Adds a dependent bean to the resolution context.

Type Parameters:

T - The generic type

Parameters:

identifier - The identifier

definition - The bean definition

bean - The bean

getAndResetDependentBeans

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

Returns:

The dependent beans that must be destroyed by an upstream bean