public class GenericApplicationContext extends AbstractApplicationContext implements org.springframework.beans.factory.support.BeanDefinitionRegistry
DefaultListableBeanFactory
instance and does not assume a specific bean definition format. Implements
the BeanDefinitionRegistry
interface in order to allow for applying any bean definition readers to it.
Typical usage is to register a variety of bean definitions via the
BeanDefinitionRegistry
interface and then call AbstractApplicationContext.refresh() to initialize those beans
with application context semantics (handling
ApplicationContextAware, auto-detecting
BeanFactoryPostProcessors,
etc).
In contrast to other ApplicationContext implementations that create a new
internal BeanFactory instance for each refresh, the internal BeanFactory of
this context is available right from the start, to be able to register bean
definitions on it. AbstractApplicationContext.refresh() may only be called once.
Usage example:
GenericApplicationContext ctx = new GenericApplicationContext();
XmlBeanDefinitionReader xmlReader = new XmlBeanDefinitionReader(ctx);
xmlReader.loadBeanDefinitions(new ClassPathResource("applicationContext.xml"));
PropertiesBeanDefinitionReader propReader = new PropertiesBeanDefinitionReader(ctx);
propReader.loadBeanDefinitions(new ClassPathResource("otherBeans.properties"));
ctx.refresh();
MyBean myBean = (MyBean) ctx.getBean("myBean");
...
For the typical case of XML bean definitions, simply use
ClassPathXmlApplicationContext or FileSystemXmlApplicationContext,
which are easier to set up - but less flexible, since you can just use standard
resource locations for XML bean definitions, rather than mixing arbitrary bean
definition formats. The equivalent in a web environment is
org.springframework.web.context.support.XmlWebApplicationContext.
For custom application context implementations that are supposed to read
special bean definition formats in a refreshable manner, consider deriving
from the AbstractRefreshableApplicationContext base class.
registerBeanDefinition(java.lang.String, org.springframework.beans.factory.config.BeanDefinition),
AbstractApplicationContext.refresh(),
XmlBeanDefinitionReader,
PropertiesBeanDefinitionReaderAPPLICATION_EVENT_MULTICASTER_BEAN_NAME, LIFECYCLE_PROCESSOR_BEAN_NAME, logger, MESSAGE_SOURCE_BEAN_NAMEAPPLICATION_STARTUP_BEAN_NAME, CONFIG_LOCATION_DELIMITERS, CONVERSION_SERVICE_BEAN_NAME, ENVIRONMENT_BEAN_NAME, LOAD_TIME_WEAVER_BEAN_NAME, SHUTDOWN_HOOK_THREAD_NAME, SYSTEM_ENVIRONMENT_BEAN_NAME, SYSTEM_PROPERTIES_BEAN_NAME| Constructor and Description |
|---|
GenericApplicationContext()
Create a new GenericApplicationContext.
|
GenericApplicationContext(ApplicationContext parent)
Create a new GenericApplicationContext with the given parent.
|
GenericApplicationContext(org.springframework.beans.factory.support.DefaultListableBeanFactory beanFactory)
Create a new GenericApplicationContext with the given DefaultListableBeanFactory.
|
GenericApplicationContext(org.springframework.beans.factory.support.DefaultListableBeanFactory beanFactory,
ApplicationContext parent)
Create a new GenericApplicationContext with the given DefaultListableBeanFactory.
|
| Modifier and Type | Method and Description |
|---|---|
protected void |
cancelRefresh(org.springframework.beans.BeansException ex)
Cancel this context's refresh attempt, resetting the
active flag
after an exception got thrown. |
protected void |
closeBeanFactory()
Not much to do: We hold a single internal BeanFactory that will never
get released.
|
org.springframework.beans.factory.config.AutowireCapableBeanFactory |
getAutowireCapableBeanFactory()
Return this context's internal bean factory as AutowireCapableBeanFactory,
if already available.
|
org.springframework.beans.factory.config.BeanDefinition |
getBeanDefinition(String beanName) |
org.springframework.beans.factory.config.ConfigurableListableBeanFactory |
getBeanFactory()
Return the single internal BeanFactory held by this context
(as ConfigurableListableBeanFactory).
|
ClassLoader |
getClassLoader() |
org.springframework.beans.factory.support.DefaultListableBeanFactory |
getDefaultListableBeanFactory()
Return the underlying bean factory of this context,
available for registering bean definitions.
|
org.springframework.core.io.Resource |
getResource(String location)
This implementation delegates to this context's ResourceLoader if set,
falling back to the default superclass behavior else.
|
org.springframework.core.io.Resource[] |
getResources(String locationPattern)
This implementation delegates to this context's ResourceLoader if it
implements the ResourcePatternResolver interface, falling back to the
default superclass behavior else.
|
boolean |
isAlias(String beanName) |
boolean |
isBeanNameInUse(String beanName) |
protected void |
refreshBeanFactory()
Do nothing: We hold a single internal BeanFactory and rely on callers
to register beans through our public methods (or the BeanFactory's).
|
void |
registerAlias(String beanName,
String alias) |
<T> void |
registerBean(Class<T> beanClass,
org.springframework.beans.factory.config.BeanDefinitionCustomizer... customizers)
Register a bean from the given bean class, optionally customizing its
bean definition metadata (typically declared as a lambda expression).
|
<T> void |
registerBean(Class<T> beanClass,
Object... constructorArgs)
Register a bean from the given bean class, optionally providing explicit
constructor arguments for consideration in the autowiring process.
|
<T> void |
registerBean(Class<T> beanClass,
Supplier<T> supplier,
org.springframework.beans.factory.config.BeanDefinitionCustomizer... customizers)
Register a bean from the given bean class, using the given supplier for
obtaining a new instance (typically declared as a lambda expression or
method reference), optionally customizing its bean definition metadata
(again typically declared as a lambda expression).
|
<T> void |
registerBean(String beanName,
Class<T> beanClass,
org.springframework.beans.factory.config.BeanDefinitionCustomizer... customizers)
Register a bean from the given bean class, optionally customizing its
bean definition metadata (typically declared as a lambda expression).
|
<T> void |
registerBean(String beanName,
Class<T> beanClass,
Object... constructorArgs)
Register a bean from the given bean class, optionally providing explicit
constructor arguments for consideration in the autowiring process.
|
<T> void |
registerBean(String beanName,
Class<T> beanClass,
Supplier<T> supplier,
org.springframework.beans.factory.config.BeanDefinitionCustomizer... customizers)
Register a bean from the given bean class, using the given supplier for
obtaining a new instance (typically declared as a lambda expression or
method reference), optionally customizing its bean definition metadata
(again typically declared as a lambda expression).
|
void |
registerBeanDefinition(String beanName,
org.springframework.beans.factory.config.BeanDefinition beanDefinition) |
void |
removeAlias(String alias) |
void |
removeBeanDefinition(String beanName) |
void |
setAllowBeanDefinitionOverriding(boolean allowBeanDefinitionOverriding)
Set whether it should be allowed to override bean definitions by registering
a different definition with the same name, automatically replacing the former.
|
void |
setAllowCircularReferences(boolean allowCircularReferences)
Set whether to allow circular references between beans - and automatically
try to resolve them.
|
void |
setApplicationStartup(org.springframework.core.metrics.ApplicationStartup applicationStartup)
Set the
ApplicationStartup for this application context. |
void |
setClassLoader(ClassLoader classLoader)
Specify the ClassLoader to load class path resources and bean classes with.
|
void |
setParent(ApplicationContext parent)
Set the parent of this application context, also setting
the parent of the internal BeanFactory accordingly.
|
void |
setResourceLoader(org.springframework.core.io.ResourceLoader resourceLoader)
Set a ResourceLoader to use for this context.
|
addApplicationListener, addBeanFactoryPostProcessor, assertBeanFactoryActive, close, containsBean, containsBeanDefinition, containsLocalBean, createEnvironment, destroy, destroyBeans, doClose, findAnnotationOnBean, finishBeanFactoryInitialization, finishRefresh, getAliases, getApplicationListeners, getApplicationName, getApplicationStartup, getBean, getBean, getBean, getBean, getBean, getBeanDefinitionCount, getBeanDefinitionNames, getBeanFactoryPostProcessors, getBeanNamesForAnnotation, getBeanNamesForType, getBeanNamesForType, getBeanNamesForType, getBeanNamesForType, getBeanProvider, getBeanProvider, getBeanProvider, getBeanProvider, getBeansOfType, getBeansOfType, getBeansWithAnnotation, getDisplayName, getEnvironment, getId, getInternalParentBeanFactory, getInternalParentMessageSource, getMessage, getMessage, getMessage, getParent, getParentBeanFactory, getResourcePatternResolver, getStartupDate, getType, getType, initApplicationEventMulticaster, initLifecycleProcessor, initMessageSource, initPropertySources, invokeBeanFactoryPostProcessors, isActive, isPrototype, isRunning, isSingleton, isTypeMatch, isTypeMatch, obtainFreshBeanFactory, onClose, onRefresh, postProcessBeanFactory, prepareBeanFactory, prepareRefresh, publishEvent, publishEvent, publishEvent, refresh, registerBeanPostProcessors, registerListeners, registerShutdownHook, resetCommonCaches, setDisplayName, setEnvironment, setId, start, stop, toStringaddProtocolResolver, clearResourceCaches, getProtocolResolvers, getResourceByPath, getResourceCacheclone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, waitcontainsBeanDefinition, getBeanDefinitionCount, getBeanDefinitionNamesaddProtocolResolverpublic GenericApplicationContext()
public GenericApplicationContext(org.springframework.beans.factory.support.DefaultListableBeanFactory beanFactory)
beanFactory - the DefaultListableBeanFactory instance to use for this contextregisterBeanDefinition(java.lang.String, org.springframework.beans.factory.config.BeanDefinition),
AbstractApplicationContext.refresh()public GenericApplicationContext(@Nullable
ApplicationContext parent)
parent - the parent application contextregisterBeanDefinition(java.lang.String, org.springframework.beans.factory.config.BeanDefinition),
AbstractApplicationContext.refresh()public GenericApplicationContext(org.springframework.beans.factory.support.DefaultListableBeanFactory beanFactory,
ApplicationContext parent)
beanFactory - the DefaultListableBeanFactory instance to use for this contextparent - the parent application contextregisterBeanDefinition(java.lang.String, org.springframework.beans.factory.config.BeanDefinition),
AbstractApplicationContext.refresh()public void setParent(@Nullable
ApplicationContext parent)
setParent in interface ConfigurableApplicationContextsetParent in class AbstractApplicationContextparent - the parent contextConfigurableBeanFactory.setParentBeanFactory(org.springframework.beans.factory.BeanFactory)public void setApplicationStartup(org.springframework.core.metrics.ApplicationStartup applicationStartup)
ConfigurableApplicationContextApplicationStartup for this application context.
This allows the application context to record metrics during startup.
setApplicationStartup in interface ConfigurableApplicationContextsetApplicationStartup in class AbstractApplicationContextapplicationStartup - the new context event factorypublic void setAllowBeanDefinitionOverriding(boolean allowBeanDefinitionOverriding)
DefaultListableBeanFactory.setAllowBeanDefinitionOverriding(boolean)public void setAllowCircularReferences(boolean allowCircularReferences)
Default is "true". Turn this off to throw an exception when encountering a circular reference, disallowing them completely.
AbstractAutowireCapableBeanFactory.setAllowCircularReferences(boolean)public void setResourceLoader(org.springframework.core.io.ResourceLoader resourceLoader)
getResource calls to the given ResourceLoader.
If not set, default resource loading will apply.
The main reason to specify a custom ResourceLoader is to resolve resource paths (without URL prefix) in a specific fashion. The default behavior is to resolve such paths as class path locations. To resolve resource paths as file system locations, specify a FileSystemResourceLoader here.
You can also pass in a full ResourcePatternResolver, which will
be autodetected by the context and used for getResources
calls as well. Else, default resource pattern matching will apply.
getResource(java.lang.String),
DefaultResourceLoader,
FileSystemResourceLoader,
ResourcePatternResolver,
getResources(java.lang.String)public org.springframework.core.io.Resource getResource(String location)
getResource in interface org.springframework.core.io.ResourceLoadergetResource in class org.springframework.core.io.DefaultResourceLoadersetResourceLoader(org.springframework.core.io.ResourceLoader)public org.springframework.core.io.Resource[] getResources(String locationPattern) throws IOException
getResources in interface org.springframework.core.io.support.ResourcePatternResolvergetResources in class AbstractApplicationContextIOExceptionsetResourceLoader(org.springframework.core.io.ResourceLoader)public void setClassLoader(@Nullable
ClassLoader classLoader)
ConfigurableApplicationContextThis context class loader will be passed to the internal bean factory.
setClassLoader in interface ConfigurableApplicationContextsetClassLoader in class org.springframework.core.io.DefaultResourceLoaderDefaultResourceLoader(ClassLoader),
ConfigurableBeanFactory.setBeanClassLoader(java.lang.ClassLoader)@Nullable public ClassLoader getClassLoader()
getClassLoader in interface org.springframework.core.io.ResourceLoadergetClassLoader in class org.springframework.core.io.DefaultResourceLoaderprotected final void refreshBeanFactory()
throws IllegalStateException
refreshBeanFactory in class AbstractApplicationContextIllegalStateException - if already initialized and multiple refresh
attempts are not supportedregisterBeanDefinition(java.lang.String, org.springframework.beans.factory.config.BeanDefinition)protected void cancelRefresh(org.springframework.beans.BeansException ex)
AbstractApplicationContextactive flag
after an exception got thrown.cancelRefresh in class AbstractApplicationContextex - the exception that led to the cancellationprotected final void closeBeanFactory()
closeBeanFactory in class AbstractApplicationContextpublic final org.springframework.beans.factory.config.ConfigurableListableBeanFactory getBeanFactory()
getBeanFactory in interface ConfigurableApplicationContextgetBeanFactory in class AbstractApplicationContextnull)AbstractApplicationContext.refreshBeanFactory(),
AbstractApplicationContext.closeBeanFactory()public final org.springframework.beans.factory.support.DefaultListableBeanFactory getDefaultListableBeanFactory()
NOTE: You need to call AbstractApplicationContext.refresh() to initialize the
bean factory and its contained beans with application context semantics
(autodetecting BeanFactoryPostProcessors, etc).
public org.springframework.beans.factory.config.AutowireCapableBeanFactory getAutowireCapableBeanFactory()
throws IllegalStateException
AbstractApplicationContextgetAutowireCapableBeanFactory in interface ApplicationContextgetAutowireCapableBeanFactory in class AbstractApplicationContextIllegalStateException - if the context does not support the
AutowireCapableBeanFactory interface, or does not hold an
autowire-capable bean factory yet (e.g. if refresh() has
never been called), or if the context has been closed alreadyAbstractApplicationContext.getBeanFactory()public void registerBeanDefinition(String beanName, org.springframework.beans.factory.config.BeanDefinition beanDefinition) throws org.springframework.beans.factory.BeanDefinitionStoreException
registerBeanDefinition in interface org.springframework.beans.factory.support.BeanDefinitionRegistryorg.springframework.beans.factory.BeanDefinitionStoreExceptionpublic void removeBeanDefinition(String beanName) throws org.springframework.beans.factory.NoSuchBeanDefinitionException
removeBeanDefinition in interface org.springframework.beans.factory.support.BeanDefinitionRegistryorg.springframework.beans.factory.NoSuchBeanDefinitionExceptionpublic org.springframework.beans.factory.config.BeanDefinition getBeanDefinition(String beanName) throws org.springframework.beans.factory.NoSuchBeanDefinitionException
getBeanDefinition in interface org.springframework.beans.factory.support.BeanDefinitionRegistryorg.springframework.beans.factory.NoSuchBeanDefinitionExceptionpublic boolean isBeanNameInUse(String beanName)
isBeanNameInUse in interface org.springframework.beans.factory.support.BeanDefinitionRegistrypublic void registerAlias(String beanName, String alias)
registerAlias in interface org.springframework.core.AliasRegistrypublic void removeAlias(String alias)
removeAlias in interface org.springframework.core.AliasRegistrypublic boolean isAlias(String beanName)
isAlias in interface org.springframework.core.AliasRegistrypublic <T> void registerBean(Class<T> beanClass, Object... constructorArgs)
beanClass - the class of the beanconstructorArgs - custom argument values to be fed into Spring's
constructor resolution algorithm, resolving either all arguments or just
specific ones, with the rest to be resolved through regular autowiring
(may be null or empty)public <T> void registerBean(@Nullable
String beanName,
Class<T> beanClass,
Object... constructorArgs)
beanName - the name of the bean (may be null)beanClass - the class of the beanconstructorArgs - custom argument values to be fed into Spring's
constructor resolution algorithm, resolving either all arguments or just
specific ones, with the rest to be resolved through regular autowiring
(may be null or empty)public final <T> void registerBean(Class<T> beanClass, org.springframework.beans.factory.config.BeanDefinitionCustomizer... customizers)
beanClass - the class of the bean (resolving a public constructor
to be autowired, possibly simply the default constructor)customizers - one or more callbacks for customizing the factory's
BeanDefinition, e.g. setting a lazy-init or primary flagregisterBean(String, Class, Supplier, BeanDefinitionCustomizer...)public final <T> void registerBean(@Nullable
String beanName,
Class<T> beanClass,
org.springframework.beans.factory.config.BeanDefinitionCustomizer... customizers)
beanName - the name of the bean (may be null)beanClass - the class of the bean (resolving a public constructor
to be autowired, possibly simply the default constructor)customizers - one or more callbacks for customizing the factory's
BeanDefinition, e.g. setting a lazy-init or primary flagregisterBean(String, Class, Supplier, BeanDefinitionCustomizer...)public final <T> void registerBean(Class<T> beanClass, Supplier<T> supplier, org.springframework.beans.factory.config.BeanDefinitionCustomizer... customizers)
beanClass - the class of the beansupplier - a callback for creating an instance of the beancustomizers - one or more callbacks for customizing the factory's
BeanDefinition, e.g. setting a lazy-init or primary flagregisterBean(String, Class, Supplier, BeanDefinitionCustomizer...)public <T> void registerBean(@Nullable
String beanName,
Class<T> beanClass,
@Nullable
Supplier<T> supplier,
org.springframework.beans.factory.config.BeanDefinitionCustomizer... customizers)
This method can be overridden to adapt the registration mechanism for
all registerBean methods (since they all delegate to this one).
beanName - the name of the bean (may be null)beanClass - the class of the beansupplier - a callback for creating an instance of the bean (in case
of null, resolving a public constructor to be autowired instead)customizers - one or more callbacks for customizing the factory's
BeanDefinition, e.g. setting a lazy-init or primary flag