io.micronaut.context

Class DefaultBeanContext

java.lang.Object

io.micronaut.context.DefaultBeanContext

All Implemented Interfaces:

BeanContext, BeanDefinitionRegistry, BeanLocator, ApplicationEventPublisher, ExecutionHandleLocator, LifeCycle<BeanContext>, AnnotationMetadataResolver, AttributeHolder, MutableAttributeHolder, java.io.Closeable, java.lang.AutoCloseable

Direct Known Subclasses:

DefaultApplicationContext

public class DefaultBeanContext
extends java.lang.Object
implements BeanContext

The default context implementations.

Since:

1.0

Author:

Graeme Rocher

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.concurrent.atomic.AtomicBoolean	initializing
protected static org.slf4j.Logger	LOG
protected static org.slf4j.Logger	LOG_LIFECYCLE
protected java.util.concurrent.atomic.AtomicBoolean	running
protected java.util.concurrent.atomic.AtomicBoolean	terminating

Fields inherited from interface io.micronaut.context.ExecutionHandleLocator

EMPTY

Fields inherited from interface io.micronaut.core.annotation.AnnotationMetadataResolver

DEFAULT

Constructor Summary

Constructors

Constructor and Description
DefaultBeanContext() Construct a new bean context using the same classloader that loaded this DefaultBeanContext class.
DefaultBeanContext(BeanContextConfiguration contextConfiguration) Creates a new bean context with the given configuration.
DefaultBeanContext(java.lang.ClassLoader classLoader) Construct a new bean context with the given class loader.
DefaultBeanContext(ClassPathResourceLoader resourceLoader) Construct a new bean context with the given class loader.

Method Summary

Modifier and Type	Method and Description
<T> boolean	containsBean(java.lang.Class<T> beanType, Qualifier<T> qualifier) Return whether the bean of the given type is contained within this context.
protected <T> T	createBean(BeanResolutionContext resolutionContext, java.lang.Class<T> beanType, Qualifier<T> qualifier) Creates a bean.
<T> T	createBean(java.lang.Class<T> beanType, Qualifier<T> qualifier) Creates a new instance of the given bean performing dependency injection and returning a new instance.
<T> T	createBean(java.lang.Class<T> beanType, Qualifier<T> qualifier, java.util.Map<java.lang.String,java.lang.Object> argumentValues) Creates a new instance of the given bean performing dependency injection and returning a new instance.
<T> T	createBean(java.lang.Class<T> beanType, Qualifier<T> qualifier, java.lang.Object... args) Creates a new instance of the given bean performing dependency injection and returning a new instance.
MethodExecutionHandle<?,java.lang.Object>	createExecutionHandle(BeanDefinition<? extends java.lang.Object> beanDefinition, ExecutableMethod<java.lang.Object,?> method) Create an execution handle for the given bean definition and method.
<T> T	destroyBean(java.lang.Class<T> beanType) Destroys the bean for the given type causing it to be re-created.
protected <T> T	doCreateBean(BeanResolutionContext resolutionContext, BeanDefinition<T> definition, java.lang.Class<T> beanType, Qualifier<T> qualifier, java.lang.Object... args)
protected <T> T	doCreateBean(BeanResolutionContext resolutionContext, BeanDefinition<T> beanDefinition, Qualifier<T> qualifier, boolean isSingleton, java.util.Map<java.lang.String,java.lang.Object> argumentValues) Execution the creation of a bean.
<T> java.util.Optional<T>	findBean(BeanResolutionContext resolutionContext, java.lang.Class<T> beanType, Qualifier<T> qualifier) Find an optional bean of the given type and qualifier.
<T> java.util.Optional<T>	findBean(java.lang.Class<T> beanType, Qualifier<T> qualifier) Finds a Bean for the given type and qualifier.
protected <T> java.util.Collection<BeanDefinition<T>>	findBeanCandidates(BeanResolutionContext resolutionContext, java.lang.Class<T> beanType, BeanDefinition<?> filter, boolean filterProxied) Find bean candidates for the given type.
protected <T> java.util.Collection<BeanDefinition<T>>	findBeanCandidates(java.lang.Class<T> beanType, BeanDefinition<?> filter) Find bean candidates for the given type.
protected <T> java.util.Collection<BeanDefinition>	findBeanCandidatesForInstance(T instance) Find bean candidates for the given type.
java.util.Optional<BeanConfiguration>	findBeanConfiguration(java.lang.String configurationName) Obtain a bean configuration by name.
<T> java.util.Optional<BeanDefinition<T>>	findBeanDefinition(java.lang.Class<T> beanType, Qualifier<T> qualifier) Obtain a BeanDefinition for the given type.
<T> java.util.Optional<BeanRegistration<T>>	findBeanRegistration(T bean) Obtain a BeanDefinition for the given bean.
protected <T> BeanDefinition<T>	findConcreteCandidate(java.lang.Class<T> beanType, Qualifier<T> qualifier, java.util.Collection<BeanDefinition<T>> candidates) Fall back method to attempt to find a candidate for the given definitions.
<T,R> java.util.Optional<ExecutableMethod<T,R>>	findExecutableMethod(java.lang.Class<T> beanType, java.lang.String method, java.lang.Class[] arguments) Finds an optimized execution handle for invoking a bean method.
<T,R> java.util.Optional<MethodExecutionHandle<T,R>>	findExecutionHandle(java.lang.Class<T> beanType, Qualifier<?> qualifier, java.lang.String method, java.lang.Class... arguments) Finds an optimized execution handle for invoking a bean method.
<T,R> java.util.Optional<MethodExecutionHandle<T,R>>	findExecutionHandle(java.lang.Class<T> beanType, java.lang.String method, java.lang.Class... arguments) Finds an optimized execution handle for invoking a bean method.
<T,R> java.util.Optional<MethodExecutionHandle<T,R>>	findExecutionHandle(T bean, java.lang.String method, java.lang.Class[] arguments) Finds an optimized execution handle for invoking a bean method.
<T> java.util.Optional<BeanDefinition<T>>	findProxyBeanDefinition(java.lang.Class<T> beanType, Qualifier<T> qualifier) Obtain the original BeanDefinition for a ProxyBeanDefinition.
<T> java.util.Optional<BeanDefinition<T>>	findProxyTargetBeanDefinition(java.lang.Class<T> beanType, Qualifier<T> qualifier) Obtain the original BeanDefinition for a ProxyBeanDefinition.
<T,R> java.util.Optional<ExecutableMethod<T,R>>	findProxyTargetMethod(java.lang.Class<T> beanType, Qualifier<T> qualifier, java.lang.String method, java.lang.Class... arguments) Finds the original unproxied method for a ProxyBeanDefinition.
<T,R> java.util.Optional<ExecutableMethod<T,R>>	findProxyTargetMethod(java.lang.Class<T> beanType, java.lang.String method, java.lang.Class[] arguments) Finds the original unproxied method for a ProxyBeanDefinition.
protected <T> BeanRegistration<T>	getActiveBeanRegistration(BeanDefinition<T> beanDefinition, Qualifier qualifier) Find an active Singleton bean for the given definition and qualifier.
<T> java.util.Collection<BeanRegistration<T>>	getActiveBeanRegistrations(java.lang.Class<T> beanType) Find active Singleton beans for the given bean type.
java.util.Collection<BeanRegistration<?>>	getActiveBeanRegistrations(Qualifier<?> qualifier) Find active Singleton beans for the given qualifier.
java.util.Collection<BeanDefinition<?>>	getAllBeanDefinitions() Get all of the registered BeanDefinition.
java.util.Optional<java.lang.Object>	getAttribute(java.lang.CharSequence name) Obtain the value of an attribute on the HTTP method.
<T> java.util.Optional<T>	getAttribute(java.lang.CharSequence name, java.lang.Class<T> type) Obtain the value of an attribute on the HTTP method.
MutableConvertibleValues<java.lang.Object>	getAttributes() Overrides the default AttributeHolder.getAttributes() method to return a mutable object.
<T> T	getBean(BeanDefinition<T> definition) Obtains a Bean for the given bean definition.
<T> T	getBean(BeanResolutionContext resolutionContext, java.lang.Class<T> beanType) Get a bean of the given type.
<T> T	getBean(BeanResolutionContext resolutionContext, java.lang.Class<T> beanType, Qualifier<T> qualifier) Get a bean of the given type and qualifier.
<T> T	getBean(java.lang.Class<T> beanType) Obtains a Bean for the given type.
<T> T	getBean(java.lang.Class<T> beanType, Qualifier<T> qualifier) Obtains a Bean for the given type and qualifier.
java.util.Collection<BeanDefinitionReference<?>>	getBeanDefinitionReferences() Get all of the enabled BeanDefinitionReference.
<T> java.util.Collection<BeanDefinition<T>>	getBeanDefinitions(java.lang.Class<T> beanType) Obtain a BeanDefinition for the given type.
<T> java.util.Collection<BeanDefinition<T>>	getBeanDefinitions(java.lang.Class<T> beanType, Qualifier<T> qualifier) Obtain a BeanDefinition for the given type.
java.util.Collection<BeanDefinition<?>>	getBeanDefinitions(Qualifier<java.lang.Object> qualifier) Get all of the BeanDefinition for the given qualifier.
protected <T> javax.inject.Provider<T>	getBeanProvider(BeanResolutionContext resolutionContext, java.lang.Class<T> beanType) Get provided beans of the given type.
protected <T> javax.inject.Provider<T>	getBeanProvider(BeanResolutionContext resolutionContext, java.lang.Class<T> beanType, Qualifier<T> qualifier) Get a bean provider.
<T> java.util.Collection<BeanRegistration<T>>	getBeanRegistrations(java.lang.Class<T> beanType) Find and if necessary initialize Singleton beans for the given bean type, returning all the active registrations.
protected <T> java.util.Collection<T>	getBeansOfType(BeanResolutionContext resolutionContext, java.lang.Class<T> beanType) Get all beans of the given type.
protected <T> java.util.Collection<T>	getBeansOfType(BeanResolutionContext resolutionContext, java.lang.Class<T> beanType, Qualifier<T> qualifier) Get all beans of the given type and qualifier.
<T> java.util.Collection<T>	getBeansOfType(java.lang.Class<T> beanType) Get all beans of the given type.
<T> java.util.Collection<T>	getBeansOfType(java.lang.Class<T> beanType, Qualifier<T> qualifier) Get all beans of the given type.
BeanDefinitionValidator	getBeanValidator()
java.lang.ClassLoader	getClassLoader()
<T> T	getProxyTargetBean(java.lang.Class<T> beanType, Qualifier<T> qualifier) Resolves the proxy target for a given bean type.
protected void	initializeContext(java.util.List<BeanDefinitionReference> contextScopeBeans, java.util.List<BeanDefinitionReference> processedBeans, java.util.List<BeanDefinitionReference> parallelBeans) Initialize the context with the given Context scope beans.
protected void	initializeEventListeners() Initialize the event listeners.
protected <T> T	inject(BeanResolutionContext resolutionContext, BeanDefinition requestingBeanDefinition, T instance) Injects a bean.
<T> T	inject(T instance) Inject an existing instance.
protected void	invalidateCaches() Invalidates the bean caches.
boolean	isRunning()
protected void	processParallelBeans(java.util.List<BeanDefinitionReference> parallelBeans) Processes parallel bean definitions.
void	publishEvent(java.lang.Object event) Publish the given event.
java.util.concurrent.Future<java.lang.Void>	publishEventAsync(java.lang.Object event) Publish the given event.
<T> java.util.Optional<T>	refreshBean(BeanIdentifier identifier) Refresh the state of the given registered bean applying dependency injection and configuration wiring again.
protected void	registerConfiguration(BeanConfiguration configuration) Registers an active configuration.
<T> BeanContext	registerSingleton(java.lang.Class<T> type, T singleton, Qualifier<T> qualifier, boolean inject) Registers a new singleton bean at runtime.
<T> java.util.Optional<T>	removeAttribute(java.lang.CharSequence name, java.lang.Class<T> type) Remove an attribute.
protected java.lang.Iterable<BeanConfiguration>	resolveBeanConfigurations() Resolves the BeanConfiguration class instances.
protected java.util.List<BeanDefinitionReference>	resolveBeanDefinitionReferences() Resolves the BeanDefinitionReference class instances.
AnnotationMetadata	resolveMetadata(java.lang.Class<?> type) Resolve the AnnotationMetadata for the given type.
BeanContext	setAttribute(java.lang.CharSequence name, java.lang.Object value) Sets an attribute on the message.
BeanContext	start() The start method will read all bean definition classes found on the classpath and initialize any pre-required state.
BeanContext	stop() The close method will shut down the context calling PreDestroy hooks on loaded singletons.
protected <T> java.util.stream.Stream<T>	streamOfType(BeanResolutionContext resolutionContext, java.lang.Class<T> beanType, Qualifier<T> qualifier) Obtains a stream of beans of the given type and qualifier.
<T> java.util.stream.Stream<T>	streamOfType(java.lang.Class<T> beanType, Qualifier<T> qualifier) Obtain a stream of beans of the given type.
protected <T> java.util.Collection<BeanDefinition<T>>	transformIterables(BeanResolutionContext resolutionContext, java.util.Collection<BeanDefinition<T>> candidates, boolean filterProxied) Method that transforms iterable candidates if possible.

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.BeanContext

build, build, createBean, createBean, createBean, registerSingleton, registerSingleton, registerSingleton, registerSingleton, run, run

Methods inherited from interface io.micronaut.context.LifeCycle

close, refresh

Methods inherited from interface io.micronaut.context.ExecutionHandleLocator

getExecutableMethod, getExecutionHandle, getExecutionHandle, getProxyTargetMethod, getProxyTargetMethod

Methods inherited from interface io.micronaut.context.BeanLocator

findBean, findOrInstantiateBean, streamOfType

Methods inherited from interface io.micronaut.context.BeanDefinitionRegistry

containsBean, findBeanDefinition, getBeanDefinition, getBeanDefinition, getProxyTargetBeanDefinition

Methods inherited from interface io.micronaut.core.annotation.AnnotationMetadataResolver

resolveMetadata

Field Detail

LOG

protected static final org.slf4j.Logger LOG

LOG_LIFECYCLE

protected static final org.slf4j.Logger LOG_LIFECYCLE

running

protected final java.util.concurrent.atomic.AtomicBoolean running

initializing

protected final java.util.concurrent.atomic.AtomicBoolean initializing

terminating

protected final java.util.concurrent.atomic.AtomicBoolean terminating

Constructor Detail

DefaultBeanContext

public DefaultBeanContext()

Construct a new bean context using the same classloader that loaded this DefaultBeanContext class.

DefaultBeanContext

public DefaultBeanContext(@NonNull
                          java.lang.ClassLoader classLoader)

Construct a new bean context with the given class loader.

Parameters:

classLoader - The class loader

DefaultBeanContext

public DefaultBeanContext(@NonNull
                          ClassPathResourceLoader resourceLoader)

Construct a new bean context with the given class loader.

Parameters:

resourceLoader - The resource loader

DefaultBeanContext

public DefaultBeanContext(@NonNull
                          BeanContextConfiguration contextConfiguration)

Creates a new bean context with the given configuration.

Parameters:

contextConfiguration - The context configuration

Method Detail

isRunning

public boolean isRunning()

Specified by:

isRunning in interface LifeCycle<BeanContext>

Returns:

Whether the component is running

start

public BeanContext start()

The start method will read all bean definition classes found on the classpath and initialize any pre-required state.

Specified by:

start in interface LifeCycle<BeanContext>

Returns:

This lifecycle component

stop

public BeanContext stop()

The close method will shut down the context calling PreDestroy hooks on loaded singletons.

Specified by:

stop in interface LifeCycle<BeanContext>

Returns:

This lifecycle component

resolveMetadata

@NonNull
public AnnotationMetadata resolveMetadata(java.lang.Class<?> type)

Description copied from interface: AnnotationMetadataResolver

Resolve the AnnotationMetadata for the given type.

Specified by:

resolveMetadata in interface AnnotationMetadataResolver

Parameters:

type - The type

Returns:

The AnnotationMetadata

refreshBean

public <T> java.util.Optional<T> refreshBean(BeanIdentifier identifier)

Description copied from interface: BeanContext

Refresh the state of the given registered bean applying dependency injection and configuration wiring again.

Note that if the bean was produced by a Factory then this method will refresh the factory too

Specified by:

refreshBean in interface BeanContext

Type Parameters:

T - The concrete class

Parameters:

identifier - The BeanIdentifier

Returns:

An Optional of the instance if it exists for the given registration

getActiveBeanRegistrations

public java.util.Collection<BeanRegistration<?>> getActiveBeanRegistrations(Qualifier<?> qualifier)

Description copied from interface: BeanDefinitionRegistry

Find active Singleton beans for the given qualifier. Note that this method can return multiple registrations for a given singleton bean instance since each bean may have multiple qualifiers.

Specified by:

getActiveBeanRegistrations in interface BeanDefinitionRegistry

Parameters:

qualifier - The qualifier

Returns:

The beans

getActiveBeanRegistrations

public <T> java.util.Collection<BeanRegistration<T>> getActiveBeanRegistrations(java.lang.Class<T> beanType)

Description copied from interface: BeanDefinitionRegistry

Find active Singleton beans for the given bean type. Note that this method can return multiple registrations for a given singleton bean instance since each bean may have multiple qualifiers.

Specified by:

getActiveBeanRegistrations in interface BeanDefinitionRegistry

Type Parameters:

T - The concrete type

Parameters:

beanType - The bean type

Returns:

The beans

getBeanRegistrations

public <T> java.util.Collection<BeanRegistration<T>> getBeanRegistrations(java.lang.Class<T> beanType)

Description copied from interface: BeanDefinitionRegistry

Find and if necessary initialize Singleton beans for the given bean type, returning all the active registrations. Note that this method can return multiple registrations for a given singleton bean instance since each bean may have multiple qualifiers.

Specified by:

getBeanRegistrations in interface BeanDefinitionRegistry

Type Parameters:

T - The concrete type

Parameters:

beanType - The bean type

Returns:

The beans

findBeanRegistration

public <T> java.util.Optional<BeanRegistration<T>> findBeanRegistration(T bean)

Description copied from interface: BeanDefinitionRegistry

Obtain a BeanDefinition for the given bean.

Specified by:

findBeanRegistration in interface BeanDefinitionRegistry

Type Parameters:

T - The concrete type

Parameters:

bean - The bean

Returns:

An Optional of the bean definition

findExecutionHandle

public <T,R> java.util.Optional<MethodExecutionHandle<T,R>> findExecutionHandle(java.lang.Class<T> beanType,
                                                                                java.lang.String method,
                                                                                java.lang.Class... arguments)

Description copied from interface: ExecutionHandleLocator

Finds an optimized execution handle for invoking a bean method. The execution handle may or may not be implemented by generated byte code.

Specified by:

findExecutionHandle in interface ExecutionHandleLocator

Type Parameters:

T - The target bean

R - The result type of the execution handle

Parameters:

beanType - The bean type

method - The method

arguments - The arguments

Returns:

The execution handle

createExecutionHandle

public MethodExecutionHandle<?,java.lang.Object> createExecutionHandle(BeanDefinition<? extends java.lang.Object> beanDefinition,
                                                                       ExecutableMethod<java.lang.Object,?> method)

Description copied from interface: ExecutionHandleLocator

Create an execution handle for the given bean definition and method.

Specified by:

createExecutionHandle in interface ExecutionHandleLocator

Parameters:

beanDefinition - The bean definition

method - The method

Returns:

The execution handle

findExecutionHandle

public <T,R> java.util.Optional<MethodExecutionHandle<T,R>> findExecutionHandle(java.lang.Class<T> beanType,
                                                                                Qualifier<?> qualifier,
                                                                                java.lang.String method,
                                                                                java.lang.Class... arguments)

Description copied from interface: ExecutionHandleLocator

Finds an optimized execution handle for invoking a bean method. The execution handle may or may not be implemented by generated byte code.

Specified by:

findExecutionHandle in interface ExecutionHandleLocator

Type Parameters:

T - The target bean

R - The result type of the execution handle

Parameters:

beanType - The bean type

qualifier - The bean qualifer

method - The method

arguments - The arguments

Returns:

The execution handle

findExecutableMethod

public <T,R> java.util.Optional<ExecutableMethod<T,R>> findExecutableMethod(java.lang.Class<T> beanType,
                                                                            java.lang.String method,
                                                                            java.lang.Class[] arguments)

Description copied from interface: ExecutionHandleLocator

Finds an optimized execution handle for invoking a bean method. The execution handle may or may not be implemented by generated byte code.

Specified by:

findExecutableMethod in interface ExecutionHandleLocator

Type Parameters:

T - The bean type class

R - The result type of the execution handle

Parameters:

beanType - The bean type

method - The method

arguments - The arguments

Returns:

The execution handle

findExecutionHandle

public <T,R> java.util.Optional<MethodExecutionHandle<T,R>> findExecutionHandle(T bean,
                                                                                java.lang.String method,
                                                                                java.lang.Class[] arguments)

Description copied from interface: ExecutionHandleLocator

Finds an optimized execution handle for invoking a bean method. The execution handle may or may not be implemented by generated byte code.

Specified by:

findExecutionHandle in interface ExecutionHandleLocator

Type Parameters:

T - The target bean

R - The result type of the execution handle

Parameters:

bean - The bean to invoke the method on

method - The method

arguments - The arguments

Returns:

The execution handle

registerSingleton

public <T> BeanContext registerSingleton(@NonNull
                                         java.lang.Class<T> type,
                                         @NonNull
                                         T singleton,
                                         Qualifier<T> qualifier,
                                         boolean inject)

Description copied from interface: BeanDefinitionRegistry

Registers a new singleton bean at runtime. This method expects that the bean definition data will have been compiled ahead of time.

If bean definition data is found the method will perform dependency injection on the instance followed by invoking any PostConstruct hooks.

If no bean definition data is found the bean is registered as is.

Specified by:

registerSingleton in interface BeanContext

Specified by:

registerSingleton in interface BeanDefinitionRegistry

Type Parameters:

T - The concrete type

Parameters:

type - The bean type

singleton - The singleton bean

qualifier - The bean qualifier

inject - Whether the singleton should be injected (defaults to true)

Returns:

This bean context

getClassLoader

public java.lang.ClassLoader getClassLoader()

Specified by:

getClassLoader in interface BeanContext

Returns:

The class loader used by this context

getBeanValidator

public BeanDefinitionValidator getBeanValidator()

Specified by:

getBeanValidator in interface BeanContext

Returns:

Get the configured bean validator, if any.

findBeanConfiguration

public java.util.Optional<BeanConfiguration> findBeanConfiguration(java.lang.String configurationName)

Description copied from interface: BeanDefinitionRegistry

Obtain a bean configuration by name.

Specified by:

findBeanConfiguration in interface BeanDefinitionRegistry

Parameters:

configurationName - The configuration name

Returns:

An optional with the configuration either present or not

findBeanDefinition

public <T> java.util.Optional<BeanDefinition<T>> findBeanDefinition(java.lang.Class<T> beanType,
                                                                    Qualifier<T> qualifier)

Description copied from interface: BeanDefinitionRegistry

Obtain a BeanDefinition for the given type.

Specified by:

findBeanDefinition in interface BeanDefinitionRegistry

Type Parameters:

T - The concrete type

Parameters:

beanType - The type

qualifier - The qualifier

Returns:

An Optional of the bean definition

getBeanDefinitions

public <T> java.util.Collection<BeanDefinition<T>> getBeanDefinitions(java.lang.Class<T> beanType)

Description copied from interface: BeanDefinitionRegistry

Obtain a BeanDefinition for the given type.

Specified by:

getBeanDefinitions in interface BeanDefinitionRegistry

Type Parameters:

T - The concrete type

Parameters:

beanType - The type

Returns:

An Optional of the bean definition

getBeanDefinitions

public <T> java.util.Collection<BeanDefinition<T>> getBeanDefinitions(java.lang.Class<T> beanType,
                                                                      Qualifier<T> qualifier)

Description copied from interface: BeanDefinitionRegistry

Obtain a BeanDefinition for the given type.

Specified by:

getBeanDefinitions in interface BeanDefinitionRegistry

Type Parameters:

T - The concrete type

Parameters:

beanType - The type

qualifier - The qualifier

Returns:

An Optional of the bean definition

containsBean

public <T> boolean containsBean(@NonNull
                                java.lang.Class<T> beanType,
                                Qualifier<T> qualifier)

Description copied from interface: BeanDefinitionRegistry

Return whether the bean of the given type is contained within this context.

Specified by:

containsBean in interface BeanDefinitionRegistry

Type Parameters:

T - The concrete type

Parameters:

beanType - The bean type

qualifier - The qualifier for the bean

Returns:

True if it is

getBean

public <T> T getBean(java.lang.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(java.lang.Class<T> beanType)

Description copied from interface: BeanLocator

Obtains a Bean for the given type.

Specified by:

getBean in interface BeanLocator

Type Parameters:

T - The bean type parameter

Parameters:

beanType - The bean type

Returns:

An instanceof said bean

findBean

public <T> java.util.Optional<T> findBean(java.lang.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> java.util.Collection<T> getBeansOfType(java.lang.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> java.util.Collection<T> getBeansOfType(java.lang.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

public <T> java.util.stream.Stream<T> streamOfType(java.lang.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

streamOfType

protected <T> java.util.stream.Stream<T> streamOfType(BeanResolutionContext resolutionContext,
                                                      java.lang.Class<T> beanType,
                                                      Qualifier<T> qualifier)

Obtains a stream of beans of the given type and qualifier.

Type Parameters:

T - The bean concrete type

Parameters:

resolutionContext - The bean resolution context

beanType - The bean type

qualifier - The qualifier

Returns:

A stream

inject

@NonNull
public <T> T inject(@NonNull
                             T instance)

Description copied from interface: BeanContext

Inject an existing instance.

Specified by:

inject in interface BeanContext

Type Parameters:

T - The bean generic type

Parameters:

instance - The instance to inject

Returns:

The instance to inject

createBean

@NonNull
public <T> T createBean(@NonNull
                                 java.lang.Class<T> beanType,
                                 @Nullable
                                 Qualifier<T> qualifier)

Description copied from interface: BeanContext

Creates a new instance of the given bean performing dependency injection and returning a new instance.

Note that the instance returned is not saved as a singleton in the context.

Specified by:

createBean in interface BeanContext

Type Parameters:

T - The bean generic type

Parameters:

beanType - The bean type

qualifier - The qualifier

Returns:

The instance

createBean

@NonNull
public <T> T createBean(@NonNull
                                 java.lang.Class<T> beanType,
                                 @Nullable
                                 Qualifier<T> qualifier,
                                 @Nullable
                                 java.util.Map<java.lang.String,java.lang.Object> argumentValues)

Description copied from interface: BeanContext

Creates a new instance of the given bean performing dependency injection and returning a new instance.

If the bean defines any Parameter values then the values passed in the argumentValues parameter will be used

Note that the instance returned is not saved as a singleton in the context.

Specified by:

createBean in interface BeanContext

Type Parameters:

T - The bean generic type

Parameters:

beanType - The bean type

qualifier - The qualifier

argumentValues - The argument values

Returns:

The instance

createBean

@NonNull
public <T> T createBean(@NonNull
                                 java.lang.Class<T> beanType,
                                 @Nullable
                                 Qualifier<T> qualifier,
                                 @Nullable
                                 java.lang.Object... args)

Description copied from interface: BeanContext

Creates a new instance of the given bean performing dependency injection and returning a new instance.

If the bean defines any Parameter values then the values passed in the argumentValues parameter will be used

Note that the instance returned is not saved as a singleton in the context.

Specified by:

createBean in interface BeanContext

Type Parameters:

T - The bean generic type

Parameters:

beanType - The bean type

qualifier - The qualifier

args - The argument values

Returns:

The instance

doCreateBean

@NonNull
protected <T> T doCreateBean(@NonNull
                                      BeanResolutionContext resolutionContext,
                                      @NonNull
                                      BeanDefinition<T> definition,
                                      @NonNull
                                      java.lang.Class<T> beanType,
                                      @Nullable
                                      Qualifier<T> qualifier,
                                      @Nullable
                                      java.lang.Object... args)

Type Parameters:

T - the bean generic type

Parameters:

resolutionContext - The bean resolution context

definition - The bean definition

beanType - The bean type

qualifier - The qualifier

args - The argument values

Returns:

The instance

destroyBean

@Nullable
public <T> T destroyBean(@NonNull
                                   java.lang.Class<T> beanType)

Description copied from interface: BeanContext

Destroys the bean for the given type causing it to be re-created. If a singleton has been loaded it will be destroyed and removed from the context, otherwise null will be returned.

Specified by:

destroyBean in interface BeanContext

Type Parameters:

T - The concrete class

Parameters:

beanType - The bean type

Returns:

The destroy instance or null if no such bean exists

getActiveBeanRegistration

@Nullable
protected <T> BeanRegistration<T> getActiveBeanRegistration(BeanDefinition<T> beanDefinition,
                                                                      Qualifier qualifier)

Find an active Singleton bean for the given definition and qualifier.

Type Parameters:

T - The bean generic type

Parameters:

beanDefinition - The bean definition

qualifier - The qualifier

Returns:

The bean registration

createBean

@NonNull
protected <T> T createBean(@Nullable
                                    BeanResolutionContext resolutionContext,
                                    @NonNull
                                    java.lang.Class<T> beanType,
                                    @Nullable
                                    Qualifier<T> qualifier)

Creates a bean.

Type Parameters:

T - The bean generic type

Parameters:

resolutionContext - The bean resolution context

beanType - The bean type

qualifier - The qualifier

Returns:

The instance

inject

@NonNull
protected <T> T inject(@NonNull
                                BeanResolutionContext resolutionContext,
                                @Nullable
                                BeanDefinition requestingBeanDefinition,
                                @NonNull
                                T instance)

Injects a bean.

Type Parameters:

T - The instance type

Parameters:

resolutionContext - The bean resolution context

requestingBeanDefinition - The requesting bean definition

instance - The instance

Returns:

The instance

getBeansOfType

@NonNull
protected <T> java.util.Collection<T> getBeansOfType(@Nullable
                                                              BeanResolutionContext resolutionContext,
                                                              @NonNull
                                                              java.lang.Class<T> beanType)

Get all beans of the given type.

Type Parameters:

T - The bean type parameter

Parameters:

resolutionContext - The bean resolution context

beanType - The bean type

Returns:

The found beans

getBeansOfType

@NonNull
protected <T> java.util.Collection<T> getBeansOfType(@Nullable
                                                              BeanResolutionContext resolutionContext,
                                                              @NonNull
                                                              java.lang.Class<T> beanType,
                                                              @Nullable
                                                              Qualifier<T> qualifier)

Get all beans of the given type and qualifier.

Type Parameters:

T - The bean type parameter

Parameters:

resolutionContext - The bean resolution context

beanType - The bean type

qualifier - The qualifier

Returns:

The found beans

getBeanProvider

@NonNull
protected <T> javax.inject.Provider<T> getBeanProvider(@Nullable
                                                                BeanResolutionContext resolutionContext,
                                                                @NonNull
                                                                java.lang.Class<T> beanType)

Get provided beans of the given type.

Type Parameters:

T - The bean type parameter

Parameters:

resolutionContext - The bean resolution context

beanType - The bean type

Returns:

The found beans

getProxyTargetBean

@NonNull
public <T> T getProxyTargetBean(@NonNull
                                         java.lang.Class<T> beanType,
                                         @Nullable
                                         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

findProxyTargetMethod

@NonNull
public <T,R> java.util.Optional<ExecutableMethod<T,R>> findProxyTargetMethod(@NonNull
                                                                                      java.lang.Class<T> beanType,
                                                                                      @NonNull
                                                                                      java.lang.String method,
                                                                                      @NonNull
                                                                                      java.lang.Class[] arguments)

Description copied from interface: ExecutionHandleLocator

Finds the original unproxied method for a ProxyBeanDefinition.

Specified by:

findProxyTargetMethod in interface ExecutionHandleLocator

Type Parameters:

T - The bean type class

R - The result type of the execution handle

Parameters:

beanType - The bean type

method - The method

arguments - The arguments

Returns:

The execution handle

findProxyTargetMethod

public <T,R> java.util.Optional<ExecutableMethod<T,R>> findProxyTargetMethod(java.lang.Class<T> beanType,
                                                                             Qualifier<T> qualifier,
                                                                             java.lang.String method,
                                                                             java.lang.Class... arguments)

Description copied from interface: ExecutionHandleLocator

Finds the original unproxied method for a ProxyBeanDefinition.

Specified by:

findProxyTargetMethod in interface ExecutionHandleLocator

Type Parameters:

T - The bean type class

R - The result type of the execution handle

Parameters:

beanType - The bean type

qualifier - The qualifier

method - The method

arguments - The arguments

Returns:

The execution handle

findProxyTargetBeanDefinition

@NonNull
public <T> java.util.Optional<BeanDefinition<T>> findProxyTargetBeanDefinition(@NonNull
                                                                                        java.lang.Class<T> beanType,
                                                                                        @Nullable
                                                                                        Qualifier<T> qualifier)

Description copied from interface: BeanDefinitionRegistry

Obtain the original BeanDefinition for a ProxyBeanDefinition.

Specified by:

findProxyTargetBeanDefinition in interface BeanDefinitionRegistry

Type Parameters:

T - The concrete type

Parameters:

beanType - The type

qualifier - The qualifier

Returns:

An Optional of the bean definition

getBeanDefinitions

@NonNull
public java.util.Collection<BeanDefinition<?>> getBeanDefinitions(@Nullable
                                                                           Qualifier<java.lang.Object> qualifier)

Description copied from interface: BeanDefinitionRegistry

Get all of the BeanDefinition for the given qualifier.

Specified by:

getBeanDefinitions in interface BeanDefinitionRegistry

Parameters:

qualifier - The qualifer

Returns:

The bean definitions

getAllBeanDefinitions

@NonNull
public java.util.Collection<BeanDefinition<?>> getAllBeanDefinitions()

Description copied from interface: BeanDefinitionRegistry

Get all of the registered BeanDefinition.

Specified by:

getAllBeanDefinitions in interface BeanDefinitionRegistry

Returns:

The bean definitions

getBeanDefinitionReferences

@NonNull
public java.util.Collection<BeanDefinitionReference<?>> getBeanDefinitionReferences()

Description copied from interface: BeanDefinitionRegistry

Get all of the enabled BeanDefinitionReference.

Specified by:

getBeanDefinitionReferences in interface BeanDefinitionRegistry

Returns:

The bean definitions

getBean

@NonNull
public <T> T getBean(@Nullable
                              BeanResolutionContext resolutionContext,
                              @NonNull
                              java.lang.Class<T> beanType)

Get a bean of the given type.

Type Parameters:

T - The bean type parameter

Parameters:

resolutionContext - The bean context resolution

beanType - The bean type

Returns:

The found bean

getBean

@NonNull
public <T> T getBean(@NonNull
                              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

getBean

@NonNull
public <T> T getBean(@Nullable
                              BeanResolutionContext resolutionContext,
                              @NonNull
                              java.lang.Class<T> beanType,
                              @Nullable
                              Qualifier<T> qualifier)

Get a bean of the given type and qualifier.

Type Parameters:

T - The bean type parameter

Parameters:

resolutionContext - The bean context resolution

beanType - The bean type

qualifier - The qualifier

Returns:

The found bean

findBean

@NonNull
public <T> java.util.Optional<T> findBean(@Nullable
                                                   BeanResolutionContext resolutionContext,
                                                   @NonNull
                                                   java.lang.Class<T> beanType,
                                                   @Nullable
                                                   Qualifier<T> qualifier)

Find an optional bean of the given type and qualifier.

Type Parameters:

T - The bean type parameter

Parameters:

resolutionContext - The bean context resolution

beanType - The bean type

qualifier - The qualifier

Returns:

The found bean wrapped as an Optional

publishEvent

public void publishEvent(@NonNull
                         java.lang.Object event)

Description copied from interface: ApplicationEventPublisher

Publish the given event. The event will be published synchronously and only return once all listeners have consumed the event.

Specified by:

publishEvent in interface ApplicationEventPublisher

Parameters:

event - The event to publish

publishEventAsync

@NonNull
public java.util.concurrent.Future<java.lang.Void> publishEventAsync(@NonNull
                                                                              java.lang.Object event)

Description copied from interface: ApplicationEventPublisher

Publish the given event. The event will be published asynchronously. A future is returned that can be used to check whether the event completed successfully or not.

Specified by:

publishEventAsync in interface ApplicationEventPublisher

Parameters:

event - The event to publish

Returns:

A future that completes when the event is published

findProxyBeanDefinition

@NonNull
public <T> java.util.Optional<BeanDefinition<T>> findProxyBeanDefinition(@NonNull
                                                                                  java.lang.Class<T> beanType,
                                                                                  @Nullable
                                                                                  Qualifier<T> qualifier)

Description copied from interface: BeanDefinitionRegistry

Obtain the original BeanDefinition for a ProxyBeanDefinition.

Specified by:

findProxyBeanDefinition in interface BeanDefinitionRegistry

Type Parameters:

T - The concrete type

Parameters:

beanType - The type

qualifier - The qualifier

Returns:

An Optional of the bean definition

invalidateCaches

protected void invalidateCaches()

Invalidates the bean caches.

getBeanProvider

@NonNull
protected <T> javax.inject.Provider<T> getBeanProvider(@Nullable
                                                                BeanResolutionContext resolutionContext,
                                                                @NonNull
                                                                java.lang.Class<T> beanType,
                                                                @Nullable
                                                                Qualifier<T> qualifier)

Get a bean provider.

Type Parameters:

T - The bean type parameter

Parameters:

resolutionContext - The bean resolution context

beanType - The bean type

qualifier - The qualifier

Returns:

The bean provider

resolveBeanDefinitionReferences

@NonNull
protected java.util.List<BeanDefinitionReference> resolveBeanDefinitionReferences()

Resolves the BeanDefinitionReference class instances. Default implementation uses ServiceLoader pattern.

Returns:

The bean definition classes

resolveBeanConfigurations

@NonNull
protected java.lang.Iterable<BeanConfiguration> resolveBeanConfigurations()

Resolves the BeanConfiguration class instances. Default implementation uses ServiceLoader pattern.

Returns:

The bean definition classes

initializeEventListeners

protected void initializeEventListeners()

Initialize the event listeners.

initializeContext

protected void initializeContext(@NonNull
                                 java.util.List<BeanDefinitionReference> contextScopeBeans,
                                 @NonNull
                                 java.util.List<BeanDefinitionReference> processedBeans,
                                 @NonNull
                                 java.util.List<BeanDefinitionReference> parallelBeans)

Initialize the context with the given Context scope beans.

Parameters:

contextScopeBeans - The context scope beans

processedBeans - The beans that require ExecutableMethodProcessor handling

parallelBeans - The parallel bean definitions

findBeanCandidates

@NonNull
protected <T> java.util.Collection<BeanDefinition<T>> findBeanCandidates(@NonNull
                                                                                  java.lang.Class<T> beanType,
                                                                                  @Nullable
                                                                                  BeanDefinition<?> filter)

Find bean candidates for the given type.

Type Parameters:

T - The bean generic type

Parameters:

beanType - The bean type

filter - A bean definition to filter out

Returns:

The candidates

findBeanCandidates

@NonNull
protected <T> java.util.Collection<BeanDefinition<T>> findBeanCandidates(@Nullable
                                                                                  BeanResolutionContext resolutionContext,
                                                                                  @NonNull
                                                                                  java.lang.Class<T> beanType,
                                                                                  @Nullable
                                                                                  BeanDefinition<?> filter,
                                                                                  boolean filterProxied)

Find bean candidates for the given type.

Type Parameters:

T - The bean generic type

Parameters:

resolutionContext - The current resolution context

beanType - The bean type

filter - A bean definition to filter out

filterProxied - Whether to filter out bean proxy targets

Returns:

The candidates

transformIterables

protected <T> java.util.Collection<BeanDefinition<T>> transformIterables(BeanResolutionContext resolutionContext,
                                                                         java.util.Collection<BeanDefinition<T>> candidates,
                                                                         boolean filterProxied)

Method that transforms iterable candidates if possible.

Type Parameters:

T - The bean type

Parameters:

resolutionContext - The resolution context

candidates - The candidates.

filterProxied - Whether to filter proxied.

Returns:

The candidates

findBeanCandidatesForInstance

@NonNull
protected <T> java.util.Collection<BeanDefinition> findBeanCandidatesForInstance(@NonNull
                                                                                          T instance)

Find bean candidates for the given type.

Type Parameters:

T - The bean generic type

Parameters:

instance - The bean instance

Returns:

The candidates

registerConfiguration

protected void registerConfiguration(@NonNull
                                     BeanConfiguration configuration)

Registers an active configuration.

Parameters:

configuration - The configuration to register

doCreateBean

@Nullable
protected <T> T doCreateBean(@NonNull
                                       BeanResolutionContext resolutionContext,
                                       @NonNull
                                       BeanDefinition<T> beanDefinition,
                                       @Nullable
                                       Qualifier<T> qualifier,
                                       boolean isSingleton,
                                       @Nullable
                                       java.util.Map<java.lang.String,java.lang.Object> argumentValues)

Execution the creation of a bean. The returned value can be null if a factory method returned null.

Type Parameters:

T - The bean generic type

Parameters:

resolutionContext - The BeanResolutionContext

beanDefinition - The BeanDefinition

qualifier - The Qualifier

isSingleton - Whether the bean is a singleton

argumentValues - Any argument values passed to create the bean

Returns:

The created bean

findConcreteCandidate

@NonNull
protected <T> BeanDefinition<T> findConcreteCandidate(@NonNull
                                                               java.lang.Class<T> beanType,
                                                               @Nullable
                                                               Qualifier<T> qualifier,
                                                               @NonNull
                                                               java.util.Collection<BeanDefinition<T>> candidates)

Fall back method to attempt to find a candidate for the given definitions.

Type Parameters:

T - The generic time

Parameters:

beanType - The bean type

qualifier - The qualifier

candidates - The candidates

Returns:

The concrete bean definition

processParallelBeans

protected void processParallelBeans(java.util.List<BeanDefinitionReference> parallelBeans)

Processes parallel bean definitions.

Parameters:

parallelBeans - The parallel beans

getAttributes

@NonNull
public MutableConvertibleValues<java.lang.Object> getAttributes()

Description copied from interface: MutableAttributeHolder

Overrides the default AttributeHolder.getAttributes() method to return a mutable object.

Specified by:

getAttributes in interface AttributeHolder

Specified by:

getAttributes in interface MutableAttributeHolder

Returns:

The mutable attributes

getAttribute

@NonNull
public java.util.Optional<java.lang.Object> getAttribute(java.lang.CharSequence name)

Description copied from interface: AttributeHolder

Obtain the value of an attribute on the HTTP method.

Specified by:

getAttribute in interface AttributeHolder

Parameters:

name - The name of the attribute

Returns:

An Optional value

getAttribute

@NonNull
public <T> java.util.Optional<T> getAttribute(java.lang.CharSequence name,
                                                       java.lang.Class<T> type)

Description copied from interface: AttributeHolder

Obtain the value of an attribute on the HTTP method.

Specified by:

getAttribute in interface AttributeHolder

Type Parameters:

T - type Generic

Parameters:

name - The name of the attribute

type - The required type

Returns:

An Optional value

setAttribute

@NonNull
public BeanContext setAttribute(@NonNull
                                         java.lang.CharSequence name,
                                         @Nullable
                                         java.lang.Object value)

Description copied from interface: MutableAttributeHolder

Sets an attribute on the message.

Specified by:

setAttribute in interface MutableAttributeHolder

Parameters:

name - The name of the attribute

value - The value of the attribute

Returns:

This message

removeAttribute

@NonNull
public <T> java.util.Optional<T> removeAttribute(@NonNull
                                                          java.lang.CharSequence name,
                                                          @NonNull
                                                          java.lang.Class<T> type)

Description copied from interface: MutableAttributeHolder

Remove an attribute. Returning the old value if it is present.

Specified by:

removeAttribute in interface MutableAttributeHolder

Type Parameters:

T - type Generic

Parameters:

name - The name of the attribute

type - The required type

Returns:

An Optional value