程序包 cn.taketoday.context.support

类 AbstractRefreshableApplicationContext

java.lang.Object

cn.taketoday.core.io.DefaultResourceLoader

cn.taketoday.context.support.AbstractApplicationContext

cn.taketoday.context.support.AbstractRefreshableApplicationContext

所有已实现的接口:

BeanFactory, HierarchicalBeanFactory, BeanDefinitionRegistry, DependencyInjectorProvider, ApplicationContext, ApplicationEventPublisher, ConfigurableApplicationContext, Lifecycle, MessageSource, cn.taketoday.core.AliasRegistry, cn.taketoday.core.env.EnvironmentCapable, cn.taketoday.core.io.PatternResourceLoader, cn.taketoday.core.io.ResourceLoader, Closeable, AutoCloseable

直接已知子类:

AbstractRefreshableConfigApplicationContext

public abstract class AbstractRefreshableApplicationContext
extends AbstractApplicationContext
implements BeanDefinitionRegistry

Base class for ApplicationContext implementations which are supposed to support multiple calls to AbstractApplicationContext.refresh(), creating a new internal bean factory instance every time. Typically (but not necessarily), such a context will be driven by a set of config locations to load bean definitions from.

The only method to be implemented by subclasses is loadBeanDefinitions(cn.taketoday.beans.factory.support.StandardBeanFactory), which gets invoked on each refresh. A concrete implementation is supposed to load bean definitions into the given StandardBeanFactory, typically delegating to one or more specific bean definition readers.

Note that there is a similar base class for WebApplicationContexts. cn.taketoday.web.context.support.AbstractRefreshableWebApplicationContext provides the same subclassing strategy, but additionally pre-implements all context functionality for web environments. There is also a pre-defined way to receive config locations for a web context.

从以下版本开始:

4.0 2022/2/20 17:36

作者:

Juergen Hoeller, Chris Beams, Harry Yang

另请参阅:

• loadBeanDefinitions(cn.taketoday.beans.factory.support.StandardBeanFactory)
• StandardBeanFactory
• cn.taketoday.web.context.support.AbstractRefreshableWebApplicationContext

嵌套类概要

从类继承的嵌套类/接口 cn.taketoday.core.io.DefaultResourceLoader

cn.taketoday.core.io.DefaultResourceLoader.ClassPathContextResource

从接口继承的嵌套类/接口 cn.taketoday.context.ApplicationContext

ApplicationContext.State

字段概要

从类继承的字段 cn.taketoday.context.support.AbstractApplicationContext

APPLICATION_EVENT_MULTICASTER_BEAN_NAME, LIFECYCLE_PROCESSOR_BEAN_NAME, log, MESSAGE_SOURCE_BEAN_NAME

从接口继承的字段 cn.taketoday.context.ApplicationContext

APPLICATION_NAME

从接口继承的字段 cn.taketoday.beans.factory.BeanFactory

FACTORY_BEAN_PREFIX

从接口继承的字段 cn.taketoday.context.ConfigurableApplicationContext

CONFIG_LOCATION_DELIMITERS, CONVERSION_SERVICE_BEAN_NAME, LOAD_TIME_WEAVER_BEAN_NAME, SHUTDOWN_HOOK_THREAD_NAME

从接口继承的字段 cn.taketoday.core.io.PatternResourceLoader

CLASSPATH_ALL_URL_PREFIX

从接口继承的字段 cn.taketoday.core.io.ResourceLoader

CLASSPATH_URL_PREFIX

构造器概要

构造器

构造器	说明
AbstractRefreshableApplicationContext()	Create a new AbstractRefreshableApplicationContext with no parent.
AbstractRefreshableApplicationContext(ApplicationContext parent)	Create a new AbstractRefreshableApplicationContext with the given parent context.

方法概要

修饰符和类型	方法	说明
protected void	assertBeanFactoryActive()	Overridden to turn it into a no-op: With AbstractRefreshableApplicationContext, getBeanFactory() serves a strong assertion for an active context anyway.
protected void	cancelRefresh(Exception ex)	Cancel this context's refresh attempt, after an exception got thrown.
protected final void	closeBeanFactory()	Subclasses must implement this method to release their internal bean factory.
boolean	containsBeanDefinition(Class<?> type)
boolean	containsBeanDefinition(Class<?> type, boolean equals)
boolean	containsBeanDefinition(String beanName)
boolean	containsBeanDefinition(String beanName, Class<?> type)
protected StandardBeanFactory	createBeanFactory()	Create an internal bean factory for this context.
protected BootstrapContext	createBootstrapContext()	Return the DefinitionLoadingContext to use for loading this context
protected void	customizeBeanFactory(StandardBeanFactory beanFactory)	Customize the internal bean factory used by this context.
List<String>	getAliasList(String name)
BeanDefinition	getBeanDefinition(Class<?> requiredType)
BeanDefinition	getBeanDefinition(String beanName)
int	getBeanDefinitionCount()
String[]	getBeanDefinitionNames()
Map<String,BeanDefinition>	getBeanDefinitions()
final StandardBeanFactory	getBeanFactory()	Subclasses must return their internal bean factory here.
protected final boolean	hasBeanFactory()	Determine whether this context currently holds a bean factory, i.e. has been refreshed at least once and not been closed yet.
boolean	isAlias(String name)
boolean	isAllowBeanDefinitionOverriding()
boolean	isBeanNameInUse(String beanName)
protected abstract void	loadBeanDefinitions(StandardBeanFactory beanFactory)	Load bean definitions into the given bean factory, typically through delegating to one or more bean definition readers.
protected final void	refreshBeanFactory()	This implementation performs an actual refresh of this context's underlying bean factory, shutting down the previous bean factory (if any) and initializing a fresh bean factory for the next phase of the context's lifecycle.
void	registerAlias(String name, String alias)
void	registerBeanDefinition(String beanName, BeanDefinition def)
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.

从类继承的方法 cn.taketoday.context.support.AbstractApplicationContext

addApplicationListener, addBeanFactoryPostProcessor, addFactoryPostProcessors, applyState, close, containsBean, containsLocalBean, createEnvironment, destroyBeans, doClose, findAnnotationOnBean, findAnnotationOnBean, findSynthesizedAnnotation, finishBeanFactoryInitialization, finishRefresh, formatStartupDate, getAliases, getAnnotatedBeans, getApplicationEventMulticaster, getApplicationListeners, getApplicationName, getAutowireCapableBeanFactory, getBean, getBean, getBean, getBean, getBean, getBeanNamesForAnnotation, getBeanNamesForType, getBeanNamesForType, getBeanNamesForType, getBeanNamesForType, getBeans, getBeansOfType, getBeansOfType, getBeansOfType, getBeansWithAnnotation, getBeansWithAnnotation, getBootstrapContext, getDisplayName, getEnvironment, getExpressionEvaluator, getFactoryPostProcessors, getId, getInjector, getInternalParentBeanFactory, getInternalParentMessageSource, getLifecycleProcessor, getMessage, getMessage, getMessage, getObjectSupplier, getObjectSupplier, getObjectSupplier, getObjectSupplier, getParent, getParentBeanFactory, getPatternResourceLoader, getResources, getStartupDate, getState, getType, getType, hasStarted, initApplicationEventMulticaster, initLifecycleProcessor, initMessageSource, initPropertySources, invokeBeanFactoryPostProcessors, isActive, isPrototype, isRunning, isSingleton, isTypeMatch, isTypeMatch, obtainBootstrapContext, obtainFreshBeanFactory, onClose, onRefresh, postProcessBeanFactory, prepareBeanFactory, prepareRefresh, publishEvent, publishEvent, refresh, registerApplicationListeners, registerBeanPostProcessors, registerFrameworkComponents, registerShutdownHook, removeApplicationListener, resetCommonCaches, scan, setBootstrapContext, setDisplayName, setEnvironment, setId, setLifecycleProcessor, setParent, start, stop, toString, unwrapFactory

从类继承的方法 cn.taketoday.core.io.DefaultResourceLoader

addProtocolResolver, clearResourceCaches, getClassLoader, getProtocolResolvers, getResource, getResourceByPath, getResourceCache, setClassLoader

从类继承的方法 java.lang.Object

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

从接口继承的方法 cn.taketoday.core.AliasRegistry

getAliases

从接口继承的方法 cn.taketoday.beans.factory.BeanFactory

getBeanNamesForType, unwrap

从接口继承的方法 cn.taketoday.context.ConfigurableApplicationContext

addProtocolResolver, setClassLoader

从接口继承的方法 cn.taketoday.core.io.PatternResourceLoader

getResourcesArray

从接口继承的方法 cn.taketoday.core.io.ResourceLoader

getClassLoader, getResource

构造器详细资料

AbstractRefreshableApplicationContext

public AbstractRefreshableApplicationContext()

Create a new AbstractRefreshableApplicationContext with no parent.

AbstractRefreshableApplicationContext

public AbstractRefreshableApplicationContext(@Nullable
 ApplicationContext parent)

Create a new AbstractRefreshableApplicationContext with the given parent context.

参数:

parent - the parent context

方法详细资料

createBootstrapContext

protected BootstrapContext createBootstrapContext()

从类复制的说明: AbstractApplicationContext

Return the DefinitionLoadingContext to use for loading this context

指定者:

createBootstrapContext 在类中 AbstractApplicationContext

返回:

the DefinitionLoadingContext for this context

setAllowBeanDefinitionOverriding

public 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. If not, an exception will be thrown. Default is "true".

另请参阅:

• StandardBeanFactory.setAllowBeanDefinitionOverriding(boolean)

setAllowCircularReferences

public void setAllowCircularReferences(boolean allowCircularReferences)

Set whether to allow circular references between beans - and automatically try to resolve them.

Default is "true". Turn this off to throw an exception when encountering a circular reference, disallowing them completely.

另请参阅:

• AbstractAutowireCapableBeanFactory.setAllowCircularReferences(boolean)

refreshBeanFactory

protected final void refreshBeanFactory()
                                 throws BeansException

This implementation performs an actual refresh of this context's underlying bean factory, shutting down the previous bean factory (if any) and initializing a fresh bean factory for the next phase of the context's lifecycle.

指定者:

refreshBeanFactory 在类中 AbstractApplicationContext

抛出:

BeansException - if initialization of the bean factory failed

cancelRefresh

protected void cancelRefresh(Exception ex)

从类复制的说明: AbstractApplicationContext

Cancel this context's refresh attempt, after an exception got thrown.

覆盖:

cancelRefresh 在类中 AbstractApplicationContext

参数:

ex - the exception that led to the cancellation

closeBeanFactory

protected final void closeBeanFactory()

从类复制的说明: AbstractApplicationContext

Subclasses must implement this method to release their internal bean factory. This method gets invoked by AbstractApplicationContext.close() after all other shutdown work.

Should never throw an exception but rather log shutdown failures.

覆盖:

closeBeanFactory 在类中 AbstractApplicationContext

hasBeanFactory

protected final boolean hasBeanFactory()

Determine whether this context currently holds a bean factory, i.e. has been refreshed at least once and not been closed yet.

getBeanFactory

public final StandardBeanFactory getBeanFactory()

从类复制的说明: AbstractApplicationContext

Subclasses must return their internal bean factory here. They should implement the lookup efficiently, so that it can be called repeatedly without a performance penalty.

Note: Subclasses should check whether the context is still active before returning the internal bean factory. The internal factory should generally be considered unavailable once the context has been closed.

指定者:

getBeanFactory 在接口中 ApplicationContext

指定者:

getBeanFactory 在接口中 ConfigurableApplicationContext

指定者:

getBeanFactory 在类中 AbstractApplicationContext

返回:

this application context's internal bean factory (never null)

另请参阅:

• AbstractApplicationContext.refreshBeanFactory()
• AbstractApplicationContext.closeBeanFactory()

assertBeanFactoryActive

protected void assertBeanFactoryActive()

Overridden to turn it into a no-op: With AbstractRefreshableApplicationContext, getBeanFactory() serves a strong assertion for an active context anyway.

覆盖:

assertBeanFactoryActive 在类中 AbstractApplicationContext

createBeanFactory

protected StandardBeanFactory createBeanFactory()

Create an internal bean factory for this context. Called for each AbstractApplicationContext.refresh() attempt.

The default implementation creates a StandardBeanFactory with the internal bean factory of this context's parent as parent bean factory. Can be overridden in subclasses, for example to customize StandardBeanFactory's settings.

返回:

the bean factory for this context

另请参阅:

• StandardBeanFactory.setAllowBeanDefinitionOverriding(boolean)
• StandardBeanFactory.setAllowEagerClassLoading(boolean)
• AbstractAutowireCapableBeanFactory.setAllowCircularReferences(boolean)
• AbstractAutowireCapableBeanFactory.setAllowRawInjectionDespiteWrapping(boolean)

customizeBeanFactory

protected void customizeBeanFactory(StandardBeanFactory beanFactory)

Customize the internal bean factory used by this context. Called for each AbstractApplicationContext.refresh() attempt.

The default implementation applies this context's "allowBeanDefinitionOverriding" and "allowCircularReferences" settings, if specified. Can be overridden in subclasses to customize any of StandardBeanFactory's settings.

参数:

beanFactory - the newly created bean factory for this context

另请参阅:

• StandardBeanFactory.setAllowBeanDefinitionOverriding(boolean)
• AbstractAutowireCapableBeanFactory.setAllowCircularReferences(boolean)
• AbstractAutowireCapableBeanFactory.setAllowRawInjectionDespiteWrapping(boolean)
• StandardBeanFactory.setAllowEagerClassLoading(boolean)

loadBeanDefinitions

protected abstract void loadBeanDefinitions(StandardBeanFactory beanFactory)
                                     throws BeansException,
IOException

Load bean definitions into the given bean factory, typically through delegating to one or more bean definition readers.

参数:

beanFactory - the bean factory to load bean definitions into

抛出:

BeansException - if parsing of the bean definitions failed

IOException - if loading of bean definition files failed

getBeanDefinitions

public Map<String,BeanDefinition> getBeanDefinitions()

指定者:

getBeanDefinitions 在接口中 BeanDefinitionRegistry

指定者:

getBeanDefinitions 在接口中 BeanFactory

覆盖:

getBeanDefinitions 在类中 AbstractApplicationContext

registerBeanDefinition

public void registerBeanDefinition(String beanName,
 BeanDefinition def)

指定者:

registerBeanDefinition 在接口中 BeanDefinitionRegistry

removeBeanDefinition

public void removeBeanDefinition(String beanName)

指定者:

removeBeanDefinition 在接口中 BeanDefinitionRegistry

getBeanDefinition

@Nullable
public BeanDefinition getBeanDefinition(String beanName)

指定者:

getBeanDefinition 在接口中 BeanDefinitionRegistry

指定者:

getBeanDefinition 在接口中 BeanFactory

覆盖:

getBeanDefinition 在类中 AbstractApplicationContext

getBeanDefinition

@Nullable
public BeanDefinition getBeanDefinition(Class<?> requiredType)

指定者:

getBeanDefinition 在接口中 BeanDefinitionRegistry

containsBeanDefinition

public boolean containsBeanDefinition(Class<?> type)

指定者:

containsBeanDefinition 在接口中 BeanDefinitionRegistry

containsBeanDefinition

public boolean containsBeanDefinition(Class<?> type,
 boolean equals)

指定者:

containsBeanDefinition 在接口中 BeanDefinitionRegistry

containsBeanDefinition

public boolean containsBeanDefinition(String beanName,
 Class<?> type)

指定者:

containsBeanDefinition 在接口中 BeanDefinitionRegistry

containsBeanDefinition

public boolean containsBeanDefinition(String beanName)

指定者:

containsBeanDefinition 在接口中 BeanDefinitionRegistry

指定者:

containsBeanDefinition 在接口中 BeanFactory

覆盖:

containsBeanDefinition 在类中 AbstractApplicationContext

getBeanDefinitionNames

public String[] getBeanDefinitionNames()

指定者:

getBeanDefinitionNames 在接口中 BeanDefinitionRegistry

指定者:

getBeanDefinitionNames 在接口中 BeanFactory

覆盖:

getBeanDefinitionNames 在类中 AbstractApplicationContext

getBeanDefinitionCount

public int getBeanDefinitionCount()

指定者:

getBeanDefinitionCount 在接口中 BeanDefinitionRegistry

指定者:

getBeanDefinitionCount 在接口中 BeanFactory

覆盖:

getBeanDefinitionCount 在类中 AbstractApplicationContext

isAllowBeanDefinitionOverriding

public boolean isAllowBeanDefinitionOverriding()

指定者:

isAllowBeanDefinitionOverriding 在接口中 BeanDefinitionRegistry

registerAlias

public void registerAlias(String name,
 String alias)

指定者:

registerAlias 在接口中 cn.taketoday.core.AliasRegistry

removeAlias

public void removeAlias(String alias)

指定者:

removeAlias 在接口中 cn.taketoday.core.AliasRegistry

isAlias

public boolean isAlias(String name)

指定者:

isAlias 在接口中 cn.taketoday.core.AliasRegistry

getAliasList

public List<String> getAliasList(String name)

指定者:

getAliasList 在接口中 cn.taketoday.core.AliasRegistry

isBeanNameInUse

public boolean isBeanNameInUse(String beanName)

指定者:

isBeanNameInUse 在接口中 BeanDefinitionRegistry