BeanFactory

布满荆棘的人生 2024-03-17 16:13 45阅读 0赞

访问Spring bean容器的根接口是BeanFactory（Bean工厂）接口。

这个接口由持有许多bean定义的对象实现，每个bean定义由唯一的字符串名称标识。根据bean定义，工厂将返回包含对象的独立实例（原型设计模式）或单个共享实例（作为单例设计模式的一种高级替代方案，该实例在工厂的范围内是单例）。返回哪种类型的实例取决于bean工厂的配置，API是相同的。自从Spring 2.0以来，在具体的应用上下文中可用更多的作用域（例如Web环境中的“request”和“session”作用域）。

通常更好地依赖于依赖注入（通过设置器或构造函数进行“推送”配置）来配置应用程序对象，而不是使用任何形式的“拉取”配置，如BeanFactory查找。Spring的依赖注入功能是使用这个BeanFactory接口及其子接口实现的。

通常情况下，BeanFactory会加载存储在配置源中的bean定义（例如XML文档），并使用“org.springframework.beans”包来配置这些bean。但是，实现可以直接在Java代码中根据需要返回创建的Java对象。对于如何存储定义，没有任何限制：可以使用LDAP、关系型数据库、XML、属性文件等。鼓励实现支持bean之间的引用（依赖注入）。

Bean工厂实现应尽可能支持标准的bean生命周期接口。完整的初始化方法集及其标准顺序包括：

1.  BeanNameAware的 `setBeanName`
2.  BeanClassLoaderAware的 `setBeanClassLoader`
3.  BeanFactoryAware的 `setBeanFactory`
4.  EnvironmentAware的 `setEnvironment`
5.  EmbeddedValueResolverAware的 `setEmbeddedValueResolver`
6.  ResourceLoaderAware的 `setResourceLoader`（仅在应用程序上下文中运行时适用）
7.  ApplicationEventPublisherAware的 `setApplicationEventPublisher`（仅在应用程序上下文中运行时适用）
8.  MessageSourceAware的 `setMessageSource`（仅在应用程序上下文中运行时适用）
9.  ApplicationContextAware的 `setApplicationContext`（仅在应用程序上下文中运行时适用）
10. ServletContextAware的 `setServletContext`（仅在Web应用程序上下文中运行时适用）
11. BeanPostProcessors的 `postProcessBeforeInitialization`方法
12. InitializingBean的 `afterPropertiesSet`
13. 自定义的 `init-method`
14. BeanPostProcessors的 `postProcessAfterInitialization`方法

这些方法的调用顺序遵循了bean的初始化阶段的规范顺序。

在关闭一个bean工厂时，以下生命周期方法适用：

1.  DestructionAwareBeanPostProcessors的 `postProcessBeforeDestruction`方法
2.  DisposableBean的 `destroy`方法
3.  自定义的 `destroy-method`

这些方法的调用顺序遵循了bean的销毁阶段的规范顺序。

public interface BeanFactory {}

这个方法返回指定bean的实例，该实例可以是共享的或独立的。这个方法允许使用Spring BeanFactory作为Singleton或Prototype设计模式的替代方法。在Singleton bean的情况下，调用者可以保留对返回对象的引用。如果在当前工厂实例中找不到bean，将会向父工厂询问。

Object getBean(String name) throws BeansException;

这个方法返回指定bean的实例，该实例可以是共享的或独立的。

<T> T getBean(String name, Class<T> requiredType) throws BeansException;

这个方法返回指定bean的实例，该实例可以是共享的或独立的。允许指定显式的构造函数参数/工厂方法参数，以覆盖bean定义中指定的默认参数（如果有）。当使用显式参数创建一个新的实例时，可以使用args参数来传递参数。但是，请注意，该参数只适用于创建新实例，而不是检索现有实例。

Object getBean(String name, Object... args) throws BeansException;

这个方法返回一个单独与给定类型匹配的bean实例，如果有的话。这个方法可以根据给定类型的名称进行常规的按名称查找，也可以进入到\`ListableBeanFactory\`的按类型查找领域。对于跨多个bean集合的更广泛的检索操作，请使用\`ListableBeanFactory\`和或\`BeanFactoryUtils\`。

<T> T getBean(Class<T> requiredType) throws BeansException;

这个方法返回指定bean的实例，该实例可以是共享的或独立的。允许指定显式的构造函数参数/工厂方法参数，以覆盖bean定义中指定的默认参数（如果有）。当使用显式参数创建一个新的实例时，可以使用args参数来传递参数。但是，请注意，该参数只适用于创建新实例，而不是检索现有实例。这个方法可以进入到\`ListableBeanFactory\`的按类型查找领域，也可以根据给定类型的名称进行常规的按名称查找。对于跨多个bean集合的更广泛的检索操作，请使用\`ListableBeanFactory\`和或\`BeanFactoryUtil。

<T> T getBean(Class<T> requiredType, Object... args) throws BeansException;

这个方法返回一个针对指定bean的提供者，允许延迟按需检索实例，包括可用性和唯一性选项。

<T> ObjectProvider<T> getBeanProvider(Class<T> requiredType);

这个方法返回一个针对指定bean的提供者，允许按需延迟检索实例，包括可用性和唯一性选项。这个变种允许指定一个要匹配的泛型类型，类似于方法/构造函数参数的泛型类型声明中的反射注入点。

<T> ObjectProvider<T> getBeanProvider(ResolvableType requiredType);

这个方法用于检查bean工厂是否包含指定名称的bean定义或外部注册的单例实例。如果给定的名称是一个别名，它将被转换回相应的规范bean名称。如果这个工厂是分层的，则在无法在当前工厂实例中找到bean时，会向任何父工厂询问。如果找到与给定的名称匹配的bean定义或单例实例，则无论被命名的bean定义是具体还是抽象的、延迟还是急切的、在作用域内还是不在作用域内，该方法都会返回\`true\`。因此，请注意，该方法的返回值为\`true\`并不一定意味着\`getBean\`方法能够获取相同名称的实例。

boolean containsBean(String name);

这个方法用于检查一个bean是否是共享的单例。也就是说，`getBean`方法每次都会返回同一个实例。如果在当前工厂实例中找不到bean，将会向父工厂询问。

boolean isSingleton(String name) throws NoSuchBeanDefinitionException;

这个方法用于检查一个bean是否是原型的。也就是说，`getBean`方法每次都会返回独立的实例。如果在当前工厂实例中找不到bean，将会向父工厂询问。

boolean isPrototype(String name) throws NoSuchBeanDefinitionException;

个方法用于检查具有给定名称的bean是否与指定类型匹配。更具体地说，它检查针对给定名称的 `getBean`调用是否会返回一个可分配给指定目标类型的对象。

boolean isTypeMatch(String name, ResolvableType typeToMatch) throws NoSuchBeanDefinitionException;

这个方法用于检查具有给定名称的bean是否与指定类型匹配。

boolean isTypeMatch(String name, Class<?> typeToMatch) throws NoSuchBeanDefinitionException;

这个方法用于确定具有给定名称的bean的类型。更具体地说，确定 `getBean`方法对于给定名称会返回什么类型的对象。对于\`FactoryBean\`，返回FactoryBean创建的对象的类型，就像\`FactoryBean\#getObjectType()\`所公开的那样。这可能会导致先前未初始化的\`FactoryBean\`的初始化

@Nullable
    	Class<?> getType(String name) throws NoSuchBeanDefinitionException;

这个方法用于确定具有给定名称的bean的类型。更具体地说，确定 `getBean`方法对于给定名称会返回什么类型的对象。对于\`FactoryBean\`，返回FactoryBean创建的对象的类型，就像\`FactoryBean\#getObjectType()\`所公开的那样。根据\`allowFactoryBeanInit\`标志的不同，如果没有提前的类型信息可用，这可能会导致先前未初始化的\`FactoryBean\`的初始化。

@Nullable
    	Class<?> getType(String name, boolean allowFactoryBeanInit) throws NoSuchBeanDefinitionException;

这个方法用于返回给定bean名称的别名（如果有）。

String[] getAliases(String name);