public abstract class AbstractBeanFactory extends FactoryBeanRegistrySupport implements ConfigurableBeanFactory
BeanFactory
implementations, providing the full capabilities of the
ConfigurableBeanFactory SPI.
Does not assume a listable bean factory: can therefore also be used
as base class for bean factory implementations which obtain bean definitions
from some backend resource (where bean definition access is an expensive operation).
This class provides a singleton cache (through its base class
DefaultSingletonBeanRegistry,
singleton/prototype determination, FactoryBean
handling, aliases, bean definition merging for child bean definitions,
and bean destruction (DisposableBean
interface, custom destroy methods). Furthermore, it can manage a bean factory
hierarchy (delegating to the parent in case of an unknown bean), through implementing
the HierarchicalBeanFactory interface.
The main template methods to be implemented by subclasses are
getBeanDefinition(java.lang.String) and createBean(java.lang.String, org.springframework.beans.factory.support.RootBeanDefinition, java.lang.Object[]), retrieving a bean definition
for a given bean name and creating a bean instance for a given bean definition,
respectively. Default implementations of those operations can be found in
DefaultListableBeanFactory and AbstractAutowireCapableBeanFactory.
getBeanDefinition(java.lang.String),
createBean(java.lang.String, org.springframework.beans.factory.support.RootBeanDefinition, java.lang.Object[]),
AbstractAutowireCapableBeanFactory.createBean(java.lang.Class<T>),
DefaultListableBeanFactory.getBeanDefinition(java.lang.String)SCOPE_PROTOTYPE, SCOPE_SINGLETONFACTORY_BEAN_PREFIX| 构造器和说明 |
|---|
AbstractBeanFactory()
Create a new AbstractBeanFactory.
|
AbstractBeanFactory(BeanFactory parentBeanFactory)
Create a new AbstractBeanFactory with the given parent.
|
| 限定符和类型 | 方法和说明 |
|---|---|
void |
addBeanPostProcessor(BeanPostProcessor beanPostProcessor)
Add a new BeanPostProcessor that will get applied to beans created
by this factory.
|
void |
addEmbeddedValueResolver(org.springframework.util.StringValueResolver valueResolver)
Add a String resolver for embedded values such as annotation attributes.
|
void |
addPropertyEditorRegistrar(PropertyEditorRegistrar registrar)
Add a PropertyEditorRegistrar to be applied to all bean creation processes.
|
protected void |
afterPrototypeCreation(String beanName)
Callback after prototype creation.
|
protected void |
beforePrototypeCreation(String beanName)
Callback before prototype creation.
|
protected void |
checkMergedBeanDefinition(RootBeanDefinition mbd,
String beanName,
Object[] args)
Check the given merged bean definition,
potentially throwing validation exceptions.
|
protected void |
cleanupAfterBeanCreationFailure(String beanName)
Perform appropriate cleanup of cached metadata after bean creation failed.
|
protected void |
clearMergedBeanDefinition(String beanName)
Remove the merged bean definition for the specified bean,
recreating it on next access.
|
void |
clearMetadataCache()
Clear the merged bean definition cache, removing entries for beans
which are not considered eligible for full metadata caching yet.
|
boolean |
containsBean(String name)
判断我们的容器中是否包含了当前的bean对象
|
protected abstract boolean |
containsBeanDefinition(String beanName)
Check if this bean factory contains a bean definition with the given name.
|
boolean |
containsLocalBean(String name)
本地工厂是否包含这个Bean 忽略其他所有父工厂
|
void |
copyConfigurationFrom(ConfigurableBeanFactory otherFactory)
Copy all relevant configuration from the given other factory.
|
void |
copyRegisteredEditorsTo(PropertyEditorRegistry registry)
Initialize the given PropertyEditorRegistry with the custom editors
that have been registered with this BeanFactory.
|
protected abstract Object |
createBean(String beanName,
RootBeanDefinition mbd,
Object[] args)
该方法定义在 AbstractBeanFactory 中,其含义是根据给定的 BeanDefinition 和 args 实例化一个 Bean 对象。
|
void |
destroyBean(String beanName,
Object beanInstance)
Destroy the given bean instance (usually a prototype instance
obtained from this factory) according to its bean definition.
|
protected void |
destroyBean(String beanName,
Object bean,
RootBeanDefinition mbd)
Destroy the given bean instance (usually a prototype instance
obtained from this factory) according to the given bean definition.
|
void |
destroyScopedBean(String beanName)
Destroy the specified scoped bean in the current target scope, if any.
|
protected <T> T |
doGetBean(String name,
Class<T> requiredType,
Object[] args,
boolean typeCheckOnly)
返回bean的实例,该实例可能是单例bean 也有可能是原型的bean
|
protected Object |
evaluateBeanDefinitionString(String value,
BeanDefinition beanDefinition)
Evaluate the given String as contained in a bean definition,
potentially resolving it as an expression.
|
AccessControlContext |
getAccessControlContext()
Delegate the creation of the access control context to the
SecurityContextProvider. |
String[] |
getAliases(String name)
获取bean的所有的别名
Will ask the parent factory if the bean cannot be found in this factory instance.
|
Object |
getBean(String name)
该方法是一个空壳方法,没有任何的实现逻辑 真正的逻辑调用在doGetBean()中
该接口是实现了BeanFactory的getBean(String name)接口
|
<T> T |
getBean(String name,
Class<T> requiredType)
通过bean 去容器中获取一个bean对象
|
<T> T |
getBean(String name,
Class<T> requiredType,
Object... args)
Return an instance, which may be shared or independent, of the specified bean.
|
Object |
getBean(String name,
Object... args)
通过bean 去容器中获取一个bean对象
|
ClassLoader |
getBeanClassLoader()
Return this factory's class loader for loading bean classes
(only
null if even the system ClassLoader isn't accessible). |
protected abstract BeanDefinition |
getBeanDefinition(String beanName)
Return the bean definition for the given bean name.
|
BeanExpressionResolver |
getBeanExpressionResolver()
Return the resolution strategy for expressions in bean definition values.
|
int |
getBeanPostProcessorCount()
Return the current number of registered BeanPostProcessors, if any.
|
List<BeanPostProcessor> |
getBeanPostProcessors()
Return the list of BeanPostProcessors that will get applied
to beans created with this factory.
|
org.springframework.core.convert.ConversionService |
getConversionService()
Return the associated ConversionService, if any.
|
Map<Class<?>,Class<? extends PropertyEditor>> |
getCustomEditors()
Return the map of custom editors, with Classes as keys and PropertyEditor classes as values.
|
protected TypeConverter |
getCustomTypeConverter()
Return the custom TypeConverter to use, if any.
|
BeanDefinition |
getMergedBeanDefinition(String name)
Return a 'merged' BeanDefinition for the given bean name,
merging a child bean definition with its parent if necessary.
|
protected RootBeanDefinition |
getMergedBeanDefinition(String beanName,
BeanDefinition bd)
Return a RootBeanDefinition for the given top-level bean, by merging with
the parent if the given bean's definition is a child bean definition.
|
protected RootBeanDefinition |
getMergedBeanDefinition(String beanName,
BeanDefinition bd,
BeanDefinition containingBd)
Return a RootBeanDefinition for the given bean, by merging with the
parent if the given bean's definition is a child bean definition.
|
protected RootBeanDefinition |
getMergedLocalBeanDefinition(String beanName)
Return a merged RootBeanDefinition, traversing the parent bean definition
if the specified bean corresponds to a child bean definition.
|
protected Object |
getObjectForBeanInstance(Object beanInstance,
String name,
String beanName,
RootBeanDefinition mbd)
Get the object for the given bean instance, either the bean
instance itself or its created object in case of a FactoryBean.
|
BeanFactory |
getParentBeanFactory()
返回本Bean工厂的父工厂
|
Set<PropertyEditorRegistrar> |
getPropertyEditorRegistrars()
Return the set of PropertyEditorRegistrars.
|
Scope |
getRegisteredScope(String scopeName)
Return the Scope implementation for the given scope name, if any.
|
String[] |
getRegisteredScopeNames()
Return the names of all currently registered scopes.
|
ClassLoader |
getTempClassLoader()
Return the temporary ClassLoader to use for type matching purposes,
if any.
|
Class<?> |
getType(String name)
通过beanName获取对应bean的class类型
|
TypeConverter |
getTypeConverter()
Obtain a type converter as used by this BeanFactory.
|
protected Class<?> |
getTypeForFactoryBean(String beanName,
RootBeanDefinition mbd)
Determine the bean type for the given FactoryBean definition, as far as possible.
|
protected boolean |
hasBeanCreationStarted()
Check whether this factory's bean creation phase already started,
i.e. whether any bean has been marked as created in the meantime.
|
protected boolean |
hasDestructionAwareBeanPostProcessors()
Return whether this factory holds a DestructionAwareBeanPostProcessor
that will get applied to singleton beans on shutdown.
|
boolean |
hasEmbeddedValueResolver()
Determine whether an embedded value resolver has been registered with this
bean factory, to be applied through
ConfigurableBeanFactory.resolveEmbeddedValue(String). |
protected boolean |
hasInstantiationAwareBeanPostProcessors()
Return whether this factory holds a InstantiationAwareBeanPostProcessor
that will get applied to singleton beans on shutdown.
|
protected void |
initBeanWrapper(BeanWrapper bw)
Initialize the given BeanWrapper with the custom editors registered
with this factory.
|
boolean |
isActuallyInCreation(String beanName) |
protected boolean |
isBeanEligibleForMetadataCaching(String beanName)
Determine whether the specified bean is eligible for having
its bean definition metadata cached.
|
boolean |
isBeanNameInUse(String beanName)
Determine whether the given bean name is already in use within this factory,
i.e. whether there is a local bean or alias registered under this name or
an inner bean created with this name.
|
boolean |
isCacheBeanMetadata()
Return whether to cache bean metadata such as given bean definitions
(in merged fashion) and resolved bean classes.
|
boolean |
isFactoryBean(String name)
Determine whether the bean with the given name is a FactoryBean.
|
protected boolean |
isFactoryBean(String beanName,
RootBeanDefinition mbd)
Check whether the given bean is defined as a
FactoryBean. |
boolean |
isPrototype(String name)
是不是原型的
|
protected boolean |
isPrototypeCurrentlyInCreation(String beanName)
Return whether the specified prototype bean is currently in creation
(within the current thread).
|
boolean |
isSingleton(String name)
判断当前的bean是不是单例的
|
boolean |
isTypeMatch(String name,
Class<?> typeToMatch)
是不是匹配的类型
|
boolean |
isTypeMatch(String name,
org.springframework.core.ResolvableType typeToMatch)
是不是匹配的类型
Will ask the parent factory if the bean cannot be found in this factory instance.
|
protected void |
markBeanAsCreated(String beanName)
Mark the specified bean as already created (or about to be created).
|
protected String |
originalBeanName(String name)
获取原始bean的name
|
protected Class<?> |
predictBeanType(String beanName,
RootBeanDefinition mbd,
Class<?>... typesToMatch)
Predict the eventual bean type (of the processed bean instance) for the
specified bean.
|
void |
registerCustomEditor(Class<?> requiredType,
Class<? extends PropertyEditor> propertyEditorClass)
Register the given custom property editor for all properties of the
given type.
|
protected void |
registerCustomEditors(PropertyEditorRegistry registry)
Initialize the given PropertyEditorRegistry with the custom editors
that have been registered with this BeanFactory.
|
protected void |
registerDisposableBeanIfNecessary(String beanName,
Object bean,
RootBeanDefinition mbd)
Add the given bean to the list of disposable beans in this factory,
registering its DisposableBean interface and/or the given destroy method
to be called on factory shutdown (if applicable).
|
void |
registerScope(String scopeName,
Scope scope)
Register the given scope, backed by the given Scope implementation.
|
protected boolean |
removeSingletonIfCreatedForTypeCheckOnly(String beanName)
Remove the singleton instance (if any) for the given bean name,
but only if it hasn't been used for other purposes than type checking.
|
protected boolean |
requiresDestruction(Object bean,
RootBeanDefinition mbd)
Determine whether the given bean requires destruction on shutdown.
|
protected Class<?> |
resolveBeanClass(RootBeanDefinition mbd,
String beanName,
Class<?>... typesToMatch)
Resolve the bean class for the specified bean definition,
resolving a bean class name into a Class reference (if necessary)
and storing the resolved Class in the bean definition for further use.
|
String |
resolveEmbeddedValue(String value)
Resolve the given embedded value, e.g. an annotation attribute.
|
void |
setBeanClassLoader(ClassLoader beanClassLoader)
Set the class loader to use for loading bean classes.
|
void |
setBeanExpressionResolver(BeanExpressionResolver resolver)
Specify the resolution strategy for expressions in bean definition values.
|
void |
setCacheBeanMetadata(boolean cacheBeanMetadata)
Set whether to cache bean metadata such as given bean definitions
(in merged fashion) and resolved bean classes.
|
void |
setConversionService(org.springframework.core.convert.ConversionService conversionService)
Specify a Spring 3.0 ConversionService to use for converting
property values, as an alternative to JavaBeans PropertyEditors.
|
void |
setParentBeanFactory(BeanFactory parentBeanFactory)
Set the parent of this bean factory.
|
void |
setSecurityContextProvider(SecurityContextProvider securityProvider)
Set the security context provider for this bean factory.
|
void |
setTempClassLoader(ClassLoader tempClassLoader)
Specify a temporary ClassLoader to use for type matching purposes.
|
void |
setTypeConverter(TypeConverter typeConverter)
Set a custom type converter that this BeanFactory should use for converting
bean property values, constructor argument values, etc.
|
protected String |
transformedBeanName(String name)
解析别名
|
clearSingletonCache, getCachedObjectForFactoryBean, getFactoryBean, getObjectFromFactoryBean, getTypeForFactoryBean, postProcessObjectFromFactoryBean, removeSingletonaddSingleton, addSingletonFactory, afterSingletonCreation, beforeSingletonCreation, containsSingleton, destroyBean, destroySingleton, destroySingletons, getDependenciesForBean, getDependentBeans, getSingleton, getSingleton, getSingleton, getSingletonCount, getSingletonMutex, getSingletonNames, hasDependentBean, isCurrentlyInCreation, isDependent, isSingletonCurrentlyInCreation, onSuppressedException, registerContainedBean, registerDependentBean, registerDisposableBean, registerSingleton, setCurrentlyInCreationallowAliasOverriding, canonicalName, checkForAliasCircle, hasAlias, isAlias, registerAlias, removeAlias, resolveAliasesclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitdestroySingletons, getDependenciesForBean, getDependentBeans, isCurrentlyInCreation, registerAlias, registerDependentBean, resolveAliases, setCurrentlyInCreationgetBean, getBeancontainsSingleton, getSingleton, getSingletonCount, getSingletonMutex, getSingletonNames, registerSingletonpublic AbstractBeanFactory()
public AbstractBeanFactory(@Nullable
BeanFactory parentBeanFactory)
parentBeanFactory - parent bean factory, or null if nonegetBean(java.lang.String)public Object getBean(String name) throws BeansException
getBean 在接口中 BeanFactoryname - bean的名称 该名称也有可能是bean的alies(别名)BeansExceptionNoSuchBeanDefinitionException - 抛出的异常,容器中没有该bean的定义public <T> T getBean(String name, @Nullable Class<T> requiredType) throws BeansException
BeanFactorygetBean 在接口中 BeanFactoryname - 名称(有可能是bean的真正的名称 也有可能是工厂bean的名称 也有可能是bean的别名)requiredType - 去容器中获取Bean的class类型 可以是实现的接口和父类NoSuchBeanDefinitionException - 抛出的异常,容器中没有该bean的定义BeanNotOfRequiredTypeException - 容器中没有指定class类型的beanBeansException - bean还没有被创建public Object getBean(String name, Object... args) throws BeansException
BeanFactorygetBean 在接口中 BeanFactoryname - 名称(有可能是bean的真正的名称 也有可能是工厂bean的名称 也有可能是bean的别名)args - 这个是用于指定传入获取bean的构造函数的参数,通过传入该参数,那么就可以明确的知道去调用哪个构造函数是实例化对象NoSuchBeanDefinitionException - 抛出的异常,容器中没有该bean的定义BeanDefinitionStoreException - 主要用于多例模式下的构造器创建????暂时没理解BeansException - bean还没有被创建public <T> T getBean(String name, @Nullable Class<T> requiredType, @Nullable Object... args) throws BeansException
name - the name of the bean to retrieverequiredType - the required type of the bean to retrieveargs - arguments to use when creating a bean instance using explicit arguments
(only applied when creating a new instance as opposed to retrieving an existing one)BeansException - if the bean could not be createdprotected <T> T doGetBean(String name, @Nullable Class<T> requiredType, @Nullable Object[] args, boolean typeCheckOnly) throws BeansException
name - bean的名称 也有可能是bean的别名requiredType - 需要获取bean的类型args - 通过该参数传递进来,到调用构造方法时候发现有多个构造方法,我们就可以通过该参数来指定想要的构造方法了
不需要去推断构造方法(因为推断构造方法很耗时)typeCheckOnly - 判断当前的bean是不是一个检查类型的bean 这类型用的很少.BeansException - 如何bean不能被创建 那么就回抛出异常public boolean containsBean(String name)
BeanFactorycontainsBean 在接口中 BeanFactoryname - the name of the bean to querypublic boolean isSingleton(String name) throws NoSuchBeanDefinitionException
BeanFactoryisSingleton 在接口中 BeanFactoryname - the name of the bean to queryNoSuchBeanDefinitionException - if there is no bean with the given nameBeanFactory.getBean(java.lang.String),
BeanFactory.isPrototype(java.lang.String)public boolean isPrototype(String name) throws NoSuchBeanDefinitionException
BeanFactoryisPrototype 在接口中 BeanFactoryname - the name of the bean to queryNoSuchBeanDefinitionException - if there is no bean with the given nameBeanFactory.getBean(java.lang.String),
BeanFactory.isSingleton(java.lang.String)public boolean isTypeMatch(String name, org.springframework.core.ResolvableType typeToMatch) throws NoSuchBeanDefinitionException
BeanFactoryisTypeMatch 在接口中 BeanFactoryname - the name of the bean to querytypeToMatch - the type to match against (as a ResolvableType)true if the bean type matches,
false if it doesn't match or cannot be determined yetNoSuchBeanDefinitionException - if there is no bean with the given nameBeanFactory.getBean(java.lang.String),
BeanFactory.getType(java.lang.String)public boolean isTypeMatch(String name, @Nullable Class<?> typeToMatch) throws NoSuchBeanDefinitionException
BeanFactoryisTypeMatch 在接口中 BeanFactoryname - the name of the bean to querytypeToMatch - the type to match against (as a Class)true if the bean type matches,
false if it doesn't match or cannot be determined yetNoSuchBeanDefinitionException - if there is no bean with the given nameBeanFactory.getBean(java.lang.String),
BeanFactory.getType(java.lang.String)@Nullable public Class<?> getType(String name) throws NoSuchBeanDefinitionException
BeanFactorygetType 在接口中 BeanFactoryname - the name of the bean to querynull if not determinableNoSuchBeanDefinitionException - if there is no bean with the given nameBeanFactory.getBean(java.lang.String),
BeanFactory.isTypeMatch(java.lang.String, org.springframework.core.ResolvableType)public String[] getAliases(String name)
BeanFactoryWill ask the parent factory if the bean cannot be found in this factory instance.
getAliases 在接口中 BeanFactorygetAliases 在接口中 org.springframework.core.AliasRegistrygetAliases 在类中 org.springframework.core.SimpleAliasRegistryname - the bean name to check for aliasesBeanFactory.getBean(java.lang.String)@Nullable public BeanFactory getParentBeanFactory()
HierarchicalBeanFactorygetParentBeanFactory 在接口中 HierarchicalBeanFactorypublic boolean containsLocalBean(String name)
HierarchicalBeanFactorycontainsLocalBean 在接口中 HierarchicalBeanFactoryname - the name of the bean to queryBeanFactory.containsBean(java.lang.String)public void setParentBeanFactory(@Nullable
BeanFactory parentBeanFactory)
ConfigurableBeanFactoryNote that the parent cannot be changed: It should only be set outside a constructor if it isn't available at the time of factory instantiation.
setParentBeanFactory 在接口中 ConfigurableBeanFactoryparentBeanFactory - the parent BeanFactoryHierarchicalBeanFactory.getParentBeanFactory()public void setBeanClassLoader(@Nullable
ClassLoader beanClassLoader)
ConfigurableBeanFactoryNote that this class loader will only apply to bean definitions that do not carry a resolved bean class yet. This is the case as of Spring 2.0 by default: Bean definitions only carry bean class names, to be resolved once the factory processes the bean definition.
setBeanClassLoader 在接口中 ConfigurableBeanFactorybeanClassLoader - the class loader to use,
or null to suggest the default class loader@Nullable public ClassLoader getBeanClassLoader()
ConfigurableBeanFactorynull if even the system ClassLoader isn't accessible).getBeanClassLoader 在接口中 ConfigurableBeanFactoryClassUtils.forName(String, ClassLoader)public void setTempClassLoader(@Nullable
ClassLoader tempClassLoader)
ConfigurableBeanFactoryA temporary ClassLoader is usually just specified if load-time weaving is involved, to make sure that actual bean classes are loaded as lazily as possible. The temporary loader is then removed once the BeanFactory completes its bootstrap phase.
setTempClassLoader 在接口中 ConfigurableBeanFactory@Nullable public ClassLoader getTempClassLoader()
ConfigurableBeanFactorygetTempClassLoader 在接口中 ConfigurableBeanFactorypublic void setCacheBeanMetadata(boolean cacheBeanMetadata)
ConfigurableBeanFactoryTurn this flag off to enable hot-refreshing of bean definition objects and in particular bean classes. If this flag is off, any creation of a bean instance will re-query the bean class loader for newly resolved classes.
setCacheBeanMetadata 在接口中 ConfigurableBeanFactorypublic boolean isCacheBeanMetadata()
ConfigurableBeanFactoryisCacheBeanMetadata 在接口中 ConfigurableBeanFactorypublic void setBeanExpressionResolver(@Nullable
BeanExpressionResolver resolver)
ConfigurableBeanFactoryThere is no expression support active in a BeanFactory by default. An ApplicationContext will typically set a standard expression strategy here, supporting "#{...}" expressions in a Unified EL compatible style.
@Nullable public BeanExpressionResolver getBeanExpressionResolver()
ConfigurableBeanFactorypublic void setConversionService(@Nullable
org.springframework.core.convert.ConversionService conversionService)
ConfigurableBeanFactorysetConversionService 在接口中 ConfigurableBeanFactory@Nullable public org.springframework.core.convert.ConversionService getConversionService()
ConfigurableBeanFactorygetConversionService 在接口中 ConfigurableBeanFactorypublic void addPropertyEditorRegistrar(PropertyEditorRegistrar registrar)
ConfigurableBeanFactorySuch a registrar creates new PropertyEditor instances and registers them
on the given registry, fresh for each bean creation attempt. This avoids
the need for synchronization on custom editors; hence, it is generally
preferable to use this method instead of ConfigurableBeanFactory.registerCustomEditor(java.lang.Class<?>, java.lang.Class<? extends java.beans.PropertyEditor>).
addPropertyEditorRegistrar 在接口中 ConfigurableBeanFactoryregistrar - the PropertyEditorRegistrar to registerpublic Set<PropertyEditorRegistrar> getPropertyEditorRegistrars()
public void registerCustomEditor(Class<?> requiredType, Class<? extends PropertyEditor> propertyEditorClass)
ConfigurableBeanFactoryNote that this method will register a shared custom editor instance;
access to that instance will be synchronized for thread-safety. It is
generally preferable to use ConfigurableBeanFactory.addPropertyEditorRegistrar(org.springframework.beans.PropertyEditorRegistrar) instead
of this method, to avoid for the need for synchronization on custom editors.
registerCustomEditor 在接口中 ConfigurableBeanFactoryrequiredType - type of the propertypropertyEditorClass - the PropertyEditor class to registerpublic void copyRegisteredEditorsTo(PropertyEditorRegistry registry)
ConfigurableBeanFactorycopyRegisteredEditorsTo 在接口中 ConfigurableBeanFactoryregistry - the PropertyEditorRegistry to initializepublic Map<Class<?>,Class<? extends PropertyEditor>> getCustomEditors()
public void setTypeConverter(TypeConverter typeConverter)
ConfigurableBeanFactoryThis will override the default PropertyEditor mechanism and hence make any custom editors or custom editor registrars irrelevant.
@Nullable protected TypeConverter getCustomTypeConverter()
null if none specifiedpublic TypeConverter getTypeConverter()
ConfigurableBeanFactoryIf the default PropertyEditor mechanism is active, the returned TypeConverter will be aware of all custom editors that have been registered.
getTypeConverter 在接口中 ConfigurableBeanFactorypublic void addEmbeddedValueResolver(org.springframework.util.StringValueResolver valueResolver)
ConfigurableBeanFactoryaddEmbeddedValueResolver 在接口中 ConfigurableBeanFactoryvalueResolver - the String resolver to apply to embedded valuespublic boolean hasEmbeddedValueResolver()
ConfigurableBeanFactoryConfigurableBeanFactory.resolveEmbeddedValue(String).@Nullable public String resolveEmbeddedValue(@Nullable String value)
ConfigurableBeanFactoryresolveEmbeddedValue 在接口中 ConfigurableBeanFactoryvalue - the value to resolvepublic void addBeanPostProcessor(BeanPostProcessor beanPostProcessor)
ConfigurableBeanFactoryNote: Post-processors submitted here will be applied in the order of
registration; any ordering semantics expressed through implementing the
Ordered interface will be ignored. Note
that autodetected post-processors (e.g. as beans in an ApplicationContext)
will always be applied after programmatically registered ones.
addBeanPostProcessor 在接口中 ConfigurableBeanFactorybeanPostProcessor - the post-processor to registerpublic int getBeanPostProcessorCount()
ConfigurableBeanFactorypublic List<BeanPostProcessor> getBeanPostProcessors()
protected boolean hasInstantiationAwareBeanPostProcessors()
protected boolean hasDestructionAwareBeanPostProcessors()
public void registerScope(String scopeName, Scope scope)
ConfigurableBeanFactoryregisterScope 在接口中 ConfigurableBeanFactoryscopeName - the scope identifierscope - the backing Scope implementationpublic String[] getRegisteredScopeNames()
ConfigurableBeanFactoryThis will only return the names of explicitly registered scopes. Built-in scopes such as "singleton" and "prototype" won't be exposed.
getRegisteredScopeNames 在接口中 ConfigurableBeanFactoryConfigurableBeanFactory.registerScope(java.lang.String, org.springframework.beans.factory.config.Scope)@Nullable public Scope getRegisteredScope(String scopeName)
ConfigurableBeanFactoryThis will only return explicitly registered scopes. Built-in scopes such as "singleton" and "prototype" won't be exposed.
getRegisteredScope 在接口中 ConfigurableBeanFactoryscopeName - the name of the scopenull if noneConfigurableBeanFactory.registerScope(java.lang.String, org.springframework.beans.factory.config.Scope)public void setSecurityContextProvider(SecurityContextProvider securityProvider)
public AccessControlContext getAccessControlContext()
SecurityContextProvider.getAccessControlContext 在接口中 ConfigurableBeanFactorygetAccessControlContext 在类中 FactoryBeanRegistrySupportnull)AccessController.getContext()public void copyConfigurationFrom(ConfigurableBeanFactory otherFactory)
ConfigurableBeanFactoryShould include all standard configuration settings as well as BeanPostProcessors, Scopes, and factory-specific internal settings. Should not include any metadata of actual bean definitions, such as BeanDefinition objects and bean name aliases.
copyConfigurationFrom 在接口中 ConfigurableBeanFactoryotherFactory - the other BeanFactory to copy frompublic BeanDefinition getMergedBeanDefinition(String name) throws BeansException
This getMergedBeanDefinition considers bean definition
in ancestors as well.
getMergedBeanDefinition 在接口中 ConfigurableBeanFactoryname - the name of the bean to retrieve the merged definition for
(may be an alias)NoSuchBeanDefinitionException - if there is no bean with the given nameBeanDefinitionStoreException - in case of an invalid bean definitionBeansExceptionpublic boolean isFactoryBean(String name) throws NoSuchBeanDefinitionException
ConfigurableBeanFactoryisFactoryBean 在接口中 ConfigurableBeanFactoryname - the name of the bean to checkfalse means the bean exists but is not a FactoryBean)NoSuchBeanDefinitionException - if there is no bean with the given namepublic boolean isActuallyInCreation(String beanName)
protected boolean isPrototypeCurrentlyInCreation(String beanName)
beanName - the name of the beanprotected void beforePrototypeCreation(String beanName)
The default implementation register the prototype as currently in creation.
beanName - the name of the prototype about to be createdisPrototypeCurrentlyInCreation(java.lang.String)protected void afterPrototypeCreation(String beanName)
The default implementation marks the prototype as not in creation anymore.
beanName - the name of the prototype that has been createdisPrototypeCurrentlyInCreation(java.lang.String)public void destroyBean(String beanName, Object beanInstance)
ConfigurableBeanFactoryAny exception that arises during destruction should be caught and logged instead of propagated to the caller of this method.
destroyBean 在接口中 ConfigurableBeanFactorybeanName - the name of the bean definitionbeanInstance - the bean instance to destroyprotected void destroyBean(String beanName, Object bean, RootBeanDefinition mbd)
beanName - the name of the bean definitionbean - the bean instance to destroymbd - the merged bean definitionpublic void destroyScopedBean(String beanName)
ConfigurableBeanFactoryAny exception that arises during destruction should be caught and logged instead of propagated to the caller of this method.
destroyScopedBean 在接口中 ConfigurableBeanFactorybeanName - the name of the scoped beanprotected String transformedBeanName(String name)
name - bean的名称(可能包含工厂Bean的&,或者是别名)protected String originalBeanName(String name)
name - the user-specified nameprotected void initBeanWrapper(BeanWrapper bw)
The default implementation delegates to registerCustomEditors(org.springframework.beans.PropertyEditorRegistry).
Can be overridden in subclasses.
bw - the BeanWrapper to initializeprotected void registerCustomEditors(PropertyEditorRegistry registry)
To be called for BeanWrappers that will create and populate bean instances, and for SimpleTypeConverter used for constructor argument and factory method type conversion.
registry - the PropertyEditorRegistry to initializeprotected RootBeanDefinition getMergedLocalBeanDefinition(String beanName) throws BeansException
beanName - the name of the bean to retrieve the merged definition forNoSuchBeanDefinitionException - if there is no bean with the given nameBeanDefinitionStoreException - in case of an invalid bean definitionBeansExceptionprotected RootBeanDefinition getMergedBeanDefinition(String beanName, BeanDefinition bd) throws BeanDefinitionStoreException
beanName - the name of the bean definitionbd - the original bean definition (Root/ChildBeanDefinition)BeanDefinitionStoreException - in case of an invalid bean definitionprotected RootBeanDefinition getMergedBeanDefinition(String beanName, BeanDefinition bd, @Nullable BeanDefinition containingBd) throws BeanDefinitionStoreException
beanName - the name of the bean definitionbd - the original bean definition (Root/ChildBeanDefinition)containingBd - the containing bean definition in case of inner bean,
or null in case of a top-level beanBeanDefinitionStoreException - in case of an invalid bean definitionprotected void checkMergedBeanDefinition(RootBeanDefinition mbd, String beanName, @Nullable Object[] args) throws BeanDefinitionStoreException
mbd - the merged bean definition to checkbeanName - the name of the beanargs - the arguments for bean creation, if anyBeanDefinitionStoreException - in case of validation failureprotected void clearMergedBeanDefinition(String beanName)
beanName - the bean name to clear the merged definition forpublic void clearMetadataCache()
Typically triggered after changes to the original bean definitions,
e.g. after applying a BeanFactoryPostProcessor. Note that metadata
for beans which have already been created at this point will be kept around.
@Nullable protected Class<?> resolveBeanClass(RootBeanDefinition mbd, String beanName, Class<?>... typesToMatch) throws CannotLoadBeanClassException
mbd - the merged bean definition to determine the class forbeanName - the name of the bean (for error handling purposes)typesToMatch - the types to match in case of internal type matching purposes
(also signals that the returned Class will never be exposed to application code)null if none)CannotLoadBeanClassException - if we failed to load the class@Nullable protected Object evaluateBeanDefinitionString(@Nullable String value, @Nullable BeanDefinition beanDefinition)
value - the value to checkbeanDefinition - the bean definition that the value comes fromsetBeanExpressionResolver(org.springframework.beans.factory.config.BeanExpressionResolver)@Nullable protected Class<?> predictBeanType(String beanName, RootBeanDefinition mbd, Class<?>... typesToMatch)
getType(java.lang.String) and isTypeMatch(java.lang.String, org.springframework.core.ResolvableType).
Does not need to handle FactoryBeans specifically, since it is only
supposed to operate on the raw bean type.
This implementation is simplistic in that it is not able to handle factory methods and InstantiationAwareBeanPostProcessors. It only predicts the bean type correctly for a standard bean. To be overridden in subclasses, applying more sophisticated type detection.
beanName - the name of the beanmbd - the merged bean definition to determine the type fortypesToMatch - the types to match in case of internal type matching purposes
(also signals that the returned Class will never be exposed to application code)null if not predictableprotected boolean isFactoryBean(String beanName, RootBeanDefinition mbd)
FactoryBean.beanName - the name of the beanmbd - the corresponding bean definition@Nullable protected Class<?> getTypeForFactoryBean(String beanName, RootBeanDefinition mbd)
The default implementation creates the FactoryBean via getBean
to call its getObjectType method. Subclasses are encouraged to optimize
this, typically by just instantiating the FactoryBean but not populating it yet,
trying whether its getObjectType method already returns a type.
If no type found, a full FactoryBean creation as performed by this implementation
should be used as fallback.
beanName - the name of the beanmbd - the merged bean definition for the beannull otherwiseFactoryBean.getObjectType(),
getBean(String)protected void markBeanAsCreated(String beanName)
This allows the bean factory to optimize its caching for repeated creation of the specified bean.
beanName - the name of the beanprotected void cleanupAfterBeanCreationFailure(String beanName)
beanName - the name of the beanprotected boolean isBeanEligibleForMetadataCaching(String beanName)
beanName - the name of the beantrue if the bean's metadata may be cached
at this point alreadyprotected boolean removeSingletonIfCreatedForTypeCheckOnly(String beanName)
beanName - the name of the beantrue if actually removed, false otherwiseprotected boolean hasBeanCreationStarted()
markBeanAsCreated(java.lang.String)protected Object getObjectForBeanInstance(Object beanInstance, String name, String beanName, @Nullable RootBeanDefinition mbd)
beanInstance - the shared bean instancename - name that may include factory dereference prefixbeanName - the canonical bean namembd - the merged bean definitionpublic boolean isBeanNameInUse(String beanName)
beanName - the name to checkprotected boolean requiresDestruction(Object bean, RootBeanDefinition mbd)
The default implementation checks the DisposableBean interface as well as a specified destroy method and registered DestructionAwareBeanPostProcessors.
bean - the bean instance to checkmbd - the corresponding bean definitionDisposableBean,
AbstractBeanDefinition.getDestroyMethodName(),
DestructionAwareBeanPostProcessorprotected void registerDisposableBeanIfNecessary(String beanName, Object bean, RootBeanDefinition mbd)
beanName - the name of the beanbean - the bean instancembd - the bean definition for the beanAbstractBeanDefinition.isSingleton(),
AbstractBeanDefinition.getDependsOn(),
DefaultSingletonBeanRegistry.registerDisposableBean(java.lang.String, org.springframework.beans.factory.DisposableBean),
DefaultSingletonBeanRegistry.registerDependentBean(java.lang.String, java.lang.String)protected abstract boolean containsBeanDefinition(String beanName)
containsBean when no cached singleton instance is found.
Depending on the nature of the concrete bean factory implementation, this operation might be expensive (for example, because of directory lookups in external registries). However, for listable bean factories, this usually just amounts to a local hash lookup: The operation is therefore part of the public interface there. The same implementation can serve for both this template method and the public interface method in that case.
beanName - the name of the bean to look forcontainsBean(java.lang.String),
ListableBeanFactory.containsBeanDefinition(java.lang.String)protected abstract BeanDefinition getBeanDefinition(String beanName) throws BeansException
Depending on the nature of the concrete bean factory implementation, this operation might be expensive (for example, because of directory lookups in external registries). However, for listable bean factories, this usually just amounts to a local hash lookup: The operation is therefore part of the public interface there. The same implementation can serve for both this template method and the public interface method in that case.
beanName - the name of the bean to find a definition fornull)NoSuchBeanDefinitionException - if the bean definition cannot be resolvedBeansException - in case of errorsRootBeanDefinition,
ChildBeanDefinition,
ConfigurableListableBeanFactory.getBeanDefinition(java.lang.String)protected abstract Object createBean(String beanName, RootBeanDefinition mbd, @Nullable Object[] args) throws BeanCreationException
All bean retrieval methods delegate to this method for actual bean creation.
beanName - bean的名称mbd - 已经合并了父类属性的(如果有的话)BeanDefinition 对象。args - 用于构造函数或者工厂方法创建 Bean 实例对象的参数。BeanCreationException