public interface BeanContext extends LifeCycle<BeanContext>, ExecutionHandleLocator, BeanLocator, BeanDefinitionRegistry, ApplicationEventPublisher, AnnotationMetadataResolver
The core BeanContext abstraction which allows for dependency injection of classes annotated with
Inject.
Apart of the standard javax.inject annotations for dependency injection, additional annotations within
the io.micronaut.context.annotation package allow control over configuration of the bean context.
DEFAULT| Modifier and Type | Method and Description |
|---|---|
static BeanContext |
build()
Build a
BeanContext. |
static BeanContext |
build(ClassLoader classLoader)
Build a
BeanContext. |
default <T> T |
createBean(Class<T> beanType)
Creates a new instance of the given bean performing dependency injection and returning a new instance.
|
default <T> T |
createBean(Class<T> beanType,
Map<String,Object> argumentValues)
Creates a new instance of the given bean performing dependency injection and returning a new instance.
|
default <T> T |
createBean(Class<T> beanType,
Object... args)
Creates a new instance of the given bean performing dependency injection and returning a new instance.
|
<T> T |
createBean(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(Class<T> beanType,
Qualifier<T> qualifier,
Map<String,Object> argumentValues)
Creates a new instance of the given bean performing dependency injection and returning a new instance.
|
<T> T |
createBean(Class<T> beanType,
Qualifier<T> qualifier,
Object... args)
Creates a new instance of the given bean performing dependency injection and returning a new instance.
|
<T> T |
destroyBean(Class<T> beanType)
Destroys the bean for the given type causing it to be re-created.
|
ClassLoader |
getClassLoader() |
<T> T |
inject(T instance)
Inject an existing instance.
|
<T> Optional<T> |
refreshBean(BeanIdentifier identifier)
Refresh the state of the given registered bean applying dependency injection and configuration wiring again.
|
default <T> BeanContext |
registerSingleton(Class<T> type,
T singleton)
Registers a new singleton bean at runtime.
|
default <T> BeanContext |
registerSingleton(Class<T> type,
T singleton,
Qualifier<T> qualifier)
Registers a new singleton bean at runtime.
|
<T> BeanContext |
registerSingleton(Class<T> type,
T singleton,
Qualifier<T> qualifier,
boolean inject)
Registers a new singleton bean at runtime.
|
default BeanContext |
registerSingleton(Object singleton)
Registers a new singleton bean at runtime.
|
default BeanContext |
registerSingleton(Object singleton,
boolean inject)
Registers a new singleton bean at runtime.
|
static BeanContext |
run()
Run the
BeanContext. |
static BeanContext |
run(ClassLoader classLoader)
Run the
BeanContext. |
close, isRunning, refresh, start, stopfindExecutableMethod, findExecutionHandle, findExecutionHandle, findExecutionHandle, findProxyTargetMethod, getExecutableMethod, getExecutionHandle, getExecutionHandle, getProxyTargetMethodfindBean, findBean, findOrInstantiateBean, getBean, getBean, getBeansOfType, getBeansOfType, getProxyTargetBean, streamOfType, streamOfTypecontainsBean, containsBean, findBeanConfiguration, findBeanDefinition, findBeanDefinition, findBeanRegistration, findProxyBeanDefinition, findProxyTargetBeanDefinition, getActiveBeanRegistrations, getActiveBeanRegistrations, getAllBeanDefinitions, getBeanDefinition, getBeanDefinition, getBeanDefinitionReferences, getBeanDefinitions, getBeanDefinitions, getBeanDefinitions, getBeanRegistrations, getProxyTargetBeanDefinitionpublishEventresolveMetadata, resolveMetadata<T> T inject(T instance)
T - The bean generic typeinstance - The instance to injectdefault <T> T createBean(Class<T> beanType)
Note that the instance returned is not saved as a singleton in the context.
T - The bean generic typebeanType - The bean type<T> T createBean(Class<T> beanType, Qualifier<T> qualifier)
Note that the instance returned is not saved as a singleton in the context.
T - The bean generic typebeanType - The bean typequalifier - The qualifier<T> T createBean(Class<T> beanType, Qualifier<T> qualifier, Map<String,Object> argumentValues)
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.
T - The bean generic typebeanType - The bean typequalifier - The qualifierargumentValues - The argument values<T> T createBean(Class<T> beanType, Qualifier<T> qualifier, Object... args)
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.
T - The bean generic typebeanType - The bean typequalifier - The qualifierargs - The argument valuesdefault <T> T createBean(Class<T> beanType, Object... args)
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.
T - The bean generic typebeanType - The bean typeargs - The argument valuesdefault <T> T createBean(Class<T> beanType, Map<String,Object> argumentValues)
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.
T - The bean generic typebeanType - The bean typeargumentValues - The argument values<T> T destroyBean(Class<T> beanType)
T - The concrete classbeanType - The bean type<T> Optional<T> refreshBean(BeanIdentifier identifier)
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
T - The concrete classidentifier - The BeanIdentifierOptional of the instance if it exists for the given registrationClassLoader getClassLoader()
<T> BeanContext registerSingleton(Class<T> type, T singleton, Qualifier<T> qualifier, boolean inject)
BeanDefinitionRegistryRegisters 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.
registerSingleton in interface BeanDefinitionRegistryT - The concrete typetype - The bean typesingleton - The singleton beanqualifier - The bean qualifierinject - Whether the singleton should be injected (defaults to true)default BeanContext registerSingleton(@Nonnull Object singleton)
BeanDefinitionRegistryRegisters 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.
registerSingleton in interface BeanDefinitionRegistrysingleton - The singleton beandefault <T> BeanContext registerSingleton(Class<T> type, T singleton, Qualifier<T> qualifier)
BeanDefinitionRegistryRegisters 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.
registerSingleton in interface BeanDefinitionRegistryT - The concrete typetype - The bean typesingleton - The singleton beanqualifier - The bean qualifierdefault <T> BeanContext registerSingleton(Class<T> type, T singleton)
BeanDefinitionRegistryRegisters 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.
registerSingleton in interface BeanDefinitionRegistryT - The concrete typetype - the bean typesingleton - The singleton beandefault BeanContext registerSingleton(Object singleton, boolean inject)
BeanDefinitionRegistryRegisters 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.
registerSingleton in interface BeanDefinitionRegistrysingleton - The singleton beaninject - Whether the singleton should be injected (defaults to true)static BeanContext run()
BeanContextstatic BeanContext build()
BeanContext.BeanContextstatic BeanContext run(ClassLoader classLoader)
classLoader - The classloader to useBeanContextstatic BeanContext build(ClassLoader classLoader)
BeanContext.classLoader - The classloader to useBeanContext