ConfigurableBeanFactory定義BeanFactory的配置.ConfigurableBeanFactory中定義了太多太多的api,比如類加載器,類型轉(zhuǎn)化,屬性編輯器,BeanPostProcessor,作用域,bean定義,處理bean依賴關(guān)系,合并其他ConfigurableBeanFactory,bean如何銷毀.

ConfigurableBeanFactory同時(shí)繼承了HierarchicalBeanFactory 和 SingletonBeanRegistry 這兩個(gè)接口，即同時(shí)繼承了分層和單例類注冊(cè)的功能。

具體：

1、2個(gè)靜態(tài)不可變常量分別代表單例類和原型類。

2、1個(gè)設(shè)置父工廠的方法，跟HierarchicalBeanFactory接口的getParentBeanFactory方法互補(bǔ)。

3、4個(gè)跟類加載器有關(guān)的方法：get/set工廠類加載器和get/set臨時(shí)類加載器。

4、2個(gè)設(shè)置、是否緩存元數(shù)據(jù)的方法（熱加載開(kāi)關(guān)）。

5、11個(gè)處理Bean注冊(cè)、加載等細(xì)節(jié)的方法，包括：Bean表達(dá)式分解器、轉(zhuǎn)換服務(wù)、屬性編輯登記員、屬性編輯器、屬性編輯注冊(cè)器、類型轉(zhuǎn)換器、嵌入式的字符串分解器

6、2個(gè)處理Bean后處理器的方法。

7、3個(gè)跟注冊(cè)范圍相關(guān)的方法。

8、1個(gè)返回安全訪問(wèn)上下文的方法、1個(gè)從其他的工廠復(fù)制相關(guān)的所有配置的方法。

9、2個(gè)跟Bean別名相關(guān)的方法、1個(gè)返回合并后的Bean定義的方法。

10、1個(gè)判斷是否為工廠Bean的方法、2個(gè)跟當(dāng)前Bean創(chuàng)建時(shí)機(jī)相關(guān)的方法。

11、3個(gè)跟Bean依賴相關(guān)的方法、3個(gè)銷毀Bean相關(guān)的方法。

總結(jié)：這個(gè)巨大的工廠接口，繼承自HierarchicalBeanFactory 和 SingletonBeanRegistry 這兩個(gè)接口，并額外獨(dú)有37個(gè)方法！！！（看的我都快瘋了…）這37個(gè)方法包含了工廠創(chuàng)建、注冊(cè)一個(gè)Bean的眾多細(xì)節(jié)。這個(gè)工廠名為ConfigurableBeanFactory，真是名不虛傳！統(tǒng)計(jì)一下此時(shí)的ConfigurableBeanFactory的方法數(shù)吧。自有的37個(gè)方法、HierarchicalBeanFactory的2個(gè)方法、SingletonBeanRegistry的5個(gè)方法、爺爺接口BeanFactory的10個(gè)方法，共有54個(gè)方法！雖然方法繁多，還算井井有條！

/*** Configuration interface to be implemented by most bean factories. Provides* facilities to configure a bean factory, in addition to the bean factory* client methods in the {@link org.springframework.beans.factory.BeanFactory}* interface.** <p>This bean factory interface is not meant to be used in normal application* code: Stick to {@link org.springframework.beans.factory.BeanFactory} or* {@link org.springframework.beans.factory.ListableBeanFactory} for typical* needs. This extended interface is just meant to allow for framework-internal* plug'n'play and for special access to bean factory configuration methods.** @author Juergen Hoeller* @since 03.11.2003* @see org.springframework.beans.factory.BeanFactory* @see org.springframework.beans.factory.ListableBeanFactory* @see ConfigurableListableBeanFactory*/ /*** 定義BeanFactory的配置.* * 這邊定義了太多太多的api,比如類加載器,類型轉(zhuǎn)化,屬性編輯器,BeanPostProcessor,作用域,bean定義,處理bean依賴關(guān)系,合并其他ConfigurableBeanFactory,bean如何銷毀.* * @author DemoTransfer* @since 4.3*/ public interface ConfigurableBeanFactory extends HierarchicalBeanFactory, SingletonBeanRegistry {//-------------------------------------------------------------------------// 定義了兩個(gè)作用域: 單例和原型.可以通過(guò)registerScope來(lái)添加.// SCOPE_SINGLETON,SCOPE_PROTOTYPE//-------------------------------------------------------------------------/*** Scope identifier for the standard singleton scope: "singleton".* Custom scopes can be added via {@code registerScope}.* @see #registerScope*/// 單例String SCOPE_SINGLETON = "singleton";/*** Scope identifier for the standard prototype scope: "prototype".* Custom scopes can be added via {@code registerScope}.* @see #registerScope*/// 原型String SCOPE_PROTOTYPE = "prototype";/*** Set the parent of this bean factory.* <p>Note 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.* @param parentBeanFactory the parent BeanFactory* @throws IllegalStateException if this factory is already associated with* a parent BeanFactory* @see #getParentBeanFactory()*/// 父容器設(shè)置.而且一旦設(shè)置了就不讓修改/** 搭配HierarchicalBeanFactory接口的getParentBeanFactory方法*/void setParentBeanFactory(BeanFactory parentBeanFactory) throws IllegalStateException;/*** Set the class loader to use for loading bean classes.* Default is the thread context class loader.* <p>Note 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.* @param beanClassLoader the class loader to use,* or {@code null} to suggest the default class loader*/// 類加載器設(shè)置與獲取.默認(rèn)使用當(dāng)前線程中的類加載器/** 設(shè)置、返回工廠的類加載器*/void setBeanClassLoader(ClassLoader beanClassLoader);/*** Return this factory's class loader for loading bean classes.*/// 類加載器設(shè)置與獲取.默認(rèn)使用當(dāng)前線程中的類加載器ClassLoader getBeanClassLoader();/*** Specify a temporary ClassLoader to use for type matching purposes.* Default is none, simply using the standard bean ClassLoader.* <p>A temporary ClassLoader is usually just specified if* <i>load-time weaving</i> 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.* @since 2.5*/// 為了類型匹配,搞個(gè)臨時(shí)類加載器.好在一般情況為null,使用上面定義的標(biāo)準(zhǔn)加載器/** 設(shè)置、返回一個(gè)臨時(shí)的類加載器*/void setTempClassLoader(ClassLoader tempClassLoader);/*** Return the temporary ClassLoader to use for type matching purposes,* if any.* @since 2.5*/// 為了類型匹配,搞個(gè)臨時(shí)類加載器.好在一般情況為null,使用上面定義的標(biāo)準(zhǔn)加載器ClassLoader getTempClassLoader();/*** Set whether to cache bean metadata such as given bean definitions* (in merged fashion) and resolved bean classes. Default is on.* <p>Turn 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.*/// 是否需要緩存bean metadata,比如bean difinition 和 解析好的classes.默認(rèn)開(kāi)啟緩存/** 設(shè)置、是否緩存元數(shù)據(jù)，如果false，那么每次請(qǐng)求實(shí)例，都會(huì)從類加載器重新加載（熱加載）*/void setCacheBeanMetadata(boolean cacheBeanMetadata);/*** Return whether to cache bean metadata such as given bean definitions* (in merged fashion) and resolved bean classes.*/// 是否需要緩存bean metadata,比如bean difinition 和 解析好的classes.默認(rèn)開(kāi)啟緩存// 是否緩存元數(shù)據(jù)boolean isCacheBeanMetadata();/*** Specify the resolution strategy for expressions in bean definition values.* <p>There 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.* @since 3.0*/// 定義用于解析bean definition的表達(dá)式解析器/** Bean表達(dá)式分解器*/void setBeanExpressionResolver(BeanExpressionResolver resolver);/*** Return the resolution strategy for expressions in bean definition values.* @since 3.0*/// 定義用于解析bean definition的表達(dá)式解析器BeanExpressionResolver getBeanExpressionResolver();/*** Specify a Spring 3.0 ConversionService to use for converting* property values, as an alternative to JavaBeans PropertyEditors.* @since 3.0*/// 類型轉(zhuǎn)化器/** 設(shè)置、返回一個(gè)轉(zhuǎn)換服務(wù)*/void setConversionService(ConversionService conversionService);/*** Return the associated ConversionService, if any.* @since 3.0*/// 類型轉(zhuǎn)化器ConversionService getConversionService();/*** Add a PropertyEditorRegistrar to be applied to all bean creation processes.* <p>Such 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 {@link #registerCustomEditor}.* @param registrar the PropertyEditorRegistrar to register*/// 屬性編輯器/** 設(shè)置屬性編輯登記員...*/void addPropertyEditorRegistrar(PropertyEditorRegistrar registrar);/*** Register the given custom property editor for all properties of the* given type. To be invoked during factory configuration.* <p>Note 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 {@link #addPropertyEditorRegistrar} instead* of this method, to avoid for the need for synchronization on custom editors.* @param requiredType type of the property* @param propertyEditorClass the {@link PropertyEditor} class to register*/// 屬性編輯器/** 注冊(cè)常用屬性編輯器*/void registerCustomEditor(Class<?> requiredType, Class<? extends PropertyEditor> propertyEditorClass);/*** Initialize the given PropertyEditorRegistry with the custom editors* that have been registered with this BeanFactory.* @param registry the PropertyEditorRegistry to initialize*/// 屬性編輯器/** 用工廠中注冊(cè)的通用的編輯器初始化指定的屬性編輯注冊(cè)器*/void copyRegisteredEditorsTo(PropertyEditorRegistry registry);/*** Set a custom type converter that this BeanFactory should use for converting* bean property values, constructor argument values, etc.* <p>This will override the default PropertyEditor mechanism and hence make* any custom editors or custom editor registrars irrelevant.* @see #addPropertyEditorRegistrar* @see #registerCustomEditor* @since 2.5*/// BeanFactory用來(lái)轉(zhuǎn)換bean屬性值或者參數(shù)值的自定義轉(zhuǎn)換器/** 設(shè)置、得到一個(gè)類型轉(zhuǎn)換器*/void setTypeConverter(TypeConverter typeConverter);/*** Obtain a type converter as used by this BeanFactory. This may be a fresh* instance for each call, since TypeConverters are usually <i>not</i> thread-safe.* <p>If the default PropertyEditor mechanism is active, the returned* TypeConverter will be aware of all custom editors that have been registered.* @since 2.5*/// BeanFactory用來(lái)轉(zhuǎn)換bean屬性值或者參數(shù)值的自定義轉(zhuǎn)換器TypeConverter getTypeConverter();/*** Add a String resolver for embedded values such as annotation attributes.* @param valueResolver the String resolver to apply to embedded values* @since 3.0*/// string值解析器(想起mvc中的ArgumentResolver了)/** 增加一個(gè)嵌入式的StringValueResolver*/void addEmbeddedValueResolver(StringValueResolver valueResolver);/*** Determine whether an embedded value resolver has been registered with this* bean factory, to be applied through {@link #resolveEmbeddedValue(String)}.* @since 4.3*/boolean hasEmbeddedValueResolver();/*** Resolve the given embedded value, e.g. an annotation attribute.* @param value the value to resolve* @return the resolved value (may be the original value as-is)* @since 3.0*/// string值解析器(想起mvc中的ArgumentResolver了)//分解指定的嵌入式的值String resolveEmbeddedValue(String value);/*** Add a new BeanPostProcessor that will get applied to beans created* by this factory. To be invoked during factory configuration.* <p>Note: Post-processors submitted here will be applied in the order of* registration; any ordering semantics expressed through implementing the* {@link org.springframework.core.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.* @param beanPostProcessor the post-processor to register*/// BeanPostProcessor用于增強(qiáng)bean初始化功能//設(shè)置一個(gè)Bean后處理器void addBeanPostProcessor(BeanPostProcessor beanPostProcessor);/*** Return the current number of registered BeanPostProcessors, if any.*///返回Bean后處理器的數(shù)量int getBeanPostProcessorCount();/*** Register the given scope, backed by the given Scope implementation.* @param scopeName the scope identifier* @param scope the backing Scope implementation*/// 作用域定義//注冊(cè)范圍void registerScope(String scopeName, Scope scope);/*** Return the names of all currently registered scopes.* <p>This will only return the names of explicitly registered scopes.* Built-in scopes such as "singleton" and "prototype" won't be exposed.* @return the array of scope names, or an empty array if none* @see #registerScope*/// 作用域定義//返回注冊(cè)的范圍名String[] getRegisteredScopeNames();/*** Return the Scope implementation for the given scope name, if any.* <p>This will only return explicitly registered scopes.* Built-in scopes such as "singleton" and "prototype" won't be exposed.* @param scopeName the name of the scope* @return the registered Scope implementation, or {@code null} if none* @see #registerScope*/// 作用域定義//返回指定的范圍Scope getRegisteredScope(String scopeName);/*** Provides a security access control context relevant to this factory.* @return the applicable AccessControlContext (never {@code null})* @since 3.0*/// 訪問(wèn)權(quán)限控制//返回本工廠的一個(gè)安全訪問(wèn)上下文AccessControlContext getAccessControlContext();/*** Copy all relevant configuration from the given other factory.* <p>Should 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.* @param otherFactory the other BeanFactory to copy from*/// 合并其他ConfigurableBeanFactory的配置,包括上面說(shuō)到的BeanPostProcessor,作用域等//從其他的工廠復(fù)制相關(guān)的所有配置void copyConfigurationFrom(ConfigurableBeanFactory otherFactory);/*** Given a bean name, create an alias. We typically use this method to* support names that are illegal within XML ids (used for bean names).* <p>Typically invoked during factory configuration, but can also be* used for runtime registration of aliases. Therefore, a factory* implementation should synchronize alias access.* @param beanName the canonical name of the target bean* @param alias the alias to be registered for the bean* @throws BeanDefinitionStoreException if the alias is already in use*/// bean定義處理// 注冊(cè)別名/** 給指定的Bean注冊(cè)別名*/void registerAlias(String beanName, String alias) throws BeanDefinitionStoreException;/*** Resolve all alias target names and aliases registered in this* factory, applying the given StringValueResolver to them.* <p>The value resolver may for example resolve placeholders* in target bean names and even in alias names.* @param valueResolver the StringValueResolver to apply* @since 2.5*/// bean定義處理//根據(jù)指定的StringValueResolver移除所有的別名void resolveAliases(StringValueResolver valueResolver);/*** Return a merged BeanDefinition for the given bean name,* merging a child bean definition with its parent if necessary.* Considers bean definitions in ancestor factories as well.* @param beanName the name of the bean to retrieve the merged definition for* @return a (potentially merged) BeanDefinition for the given bean* @throws NoSuchBeanDefinitionException if there is no bean definition with the given name* @since 2.5*/// bean定義處理// 合并bean定義,包括父容器的/** 返回指定Bean合并后的Bean定義*/BeanDefinition getMergedBeanDefinition(String beanName) throws NoSuchBeanDefinitionException;/*** Determine whether the bean with the given name is a FactoryBean.* @param name the name of the bean to check* @return whether the bean is a FactoryBean* ({@code false} means the bean exists but is not a FactoryBean)* @throws NoSuchBeanDefinitionException if there is no bean with the given name* @since 2.5*/// bean定義處理// 是否是FactoryBean類型//判斷指定Bean是否為一個(gè)工廠Beanboolean isFactoryBean(String name) throws NoSuchBeanDefinitionException;/*** Explicitly control the current in-creation status of the specified bean.* For container-internal use only.* @param beanName the name of the bean* @param inCreation whether the bean is currently in creation* @since 3.1*/// bean創(chuàng)建狀態(tài)控制.在解決循環(huán)依賴時(shí)有使用//設(shè)置一個(gè)Bean是否正在創(chuàng)建void setCurrentlyInCreation(String beanName, boolean inCreation);/*** Determine whether the specified bean is currently in creation.* @param beanName the name of the bean* @return whether the bean is currently in creation* @since 2.5*/// bean創(chuàng)建狀態(tài)控制.在解決循環(huán)依賴時(shí)有使用//返回指定Bean是否已經(jīng)成功創(chuàng)建boolean isCurrentlyInCreation(String beanName);/*** Register a dependent bean for the given bean,* to be destroyed before the given bean is destroyed.* @param beanName the name of the bean* @param dependentBeanName the name of the dependent bean* @since 2.5*/// 處理bean依賴問(wèn)題//注冊(cè)一個(gè)依賴于指定bean的Beanvoid registerDependentBean(String beanName, String dependentBeanName);/*** Return the names of all beans which depend on the specified bean, if any.* @param beanName the name of the bean* @return the array of dependent bean names, or an empty array if none* @since 2.5*/// 處理bean依賴問(wèn)題//返回依賴于指定Bean的所欲Bean名String[] getDependentBeans(String beanName);/*** Return the names of all beans that the specified bean depends on, if any.* @param beanName the name of the bean* @return the array of names of beans which the bean depends on,* or an empty array if none* @since 2.5*/// 處理bean依賴問(wèn)題//返回指定Bean依賴的所有Bean名String[] getDependenciesForBean(String beanName);/*** Destroy the given bean instance (usually a prototype instance* obtained from this factory) according to its bean definition.* <p>Any exception that arises during destruction should be caught* and logged instead of propagated to the caller of this method.* @param beanName the name of the bean definition* @param beanInstance the bean instance to destroy*/// bean生命周期管理-- 銷毀bean//銷毀指定的Beanvoid destroyBean(String beanName, Object beanInstance);/*** Destroy the specified scoped bean in the current target scope, if any.* <p>Any exception that arises during destruction should be caught* and logged instead of propagated to the caller of this method.* @param beanName the name of the scoped bean*/// bean生命周期管理-- 銷毀bean//銷毀指定的范圍Beanvoid destroyScopedBean(String beanName);/*** Destroy all singleton beans in this factory, including inner beans that have* been registered as disposable. To be called on shutdown of a factory.* <p>Any exception that arises during destruction should be caught* and logged instead of propagated to the caller of this method.*/// bean生命周期管理-- 銷毀bean//銷毀所有的單例類void destroySingletons();}

總結(jié)

以上是生活随笔為你收集整理的configurablebeanfactory的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問(wèn)題。

如果覺(jué)得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。