简介
BeanFactory 是 Spring 框架中的核心接口,它提供了配置框架和基础功能来管理应用程序中的 bean。BeanFactory 负责初始化、配置和管理在 Spring 容器中创建的对象,这些对象通常被称为 beans。
BeanFactory 的主要职责包括:
- Bean 的实例化:根据配置信息创建 bean 的实例。
- Bean 的配置:根据配置信息(如 XML、注解等)设置 bean 的属性值、依赖关系等。
- Bean 的管理:维护 bean 的生命周期,包括创建、销毁以及作用域管理等。
- 依赖注入:负责将依赖的 bean 注入到其他 bean 中。
Spring 提供了多种 BeanFactory 的实现,其中最常用的是 XmlBeanFactory(用于解析 XML 配置文件)和 DefaultListableBeanFactory(一个更通用的实现,支持多种配置方式)。然而,在实际应用中,开发者通常不会直接与 BeanFactory 接口交互,而是使用 ApplicationContext 接口,它是 BeanFactory 的一个子接口,提供了更多的功能,如国际化支持、事件传播等。
源码
public interface BeanFactory {
/**
对 FactoryBean 的转义标识,如果使用 bean 的名字检索 FactoryBean,
得到的对象是 FactoryBean 生成的对象
如果想要得到 FactoryBean 本身,需要转义
注意这里的 FactoryBean 是一种可以获得 bean 的回调函数,不是 beanFactory 那种容器
*/
String FACTORY_BEAN_PREFIX = "&";
/**
获取 beanName 对应的 bean 实例(可能涉及 bean 的创建)
1. 会对别名进行转换
2. 当前 BeanFactory 中找不到回去父级找
*/
Object getBean(String name) throws BeansException;
/**
获取 name + type 对应的 bean 实例,找不到或者类型转换失败会抛异常
1. 会对别名进行转换
2. 这里允许指定创建 bean 用到的参数,比如这个 bean 的属性是基于构造方法/工厂方法 赋值的,
当然这些参数可以在 BeanDefinition 中进行覆盖
*/
<T> T getBean(String name, Class<T> requiredType) throws BeansException;
/**
获取 beanName 对应的 bean 实例(可能涉及 bean 的创建)
1. 会对别名进行转换
2. 当前 BeanFactory 中找不到回去父级找
这里允许指定 bean 的属性,比如这个 bean 的属性是基于构造方法/工厂方法赋值的,
当然这些参数可以在 BeanDefinition 中进行覆盖
*/
Object getBean(String name, Object... args) throws BeansException;
/**
基于类型获取 bean,如果指定的类型有多个被实例化的 bean,查找时会抛异常
*/
<T> T getBean(Class<T> requiredType) throws BeansException;
/**
基于类型获取 bean,如果指定的类型有多个被实例化的 bean,查找时会抛异常
这里允许指定 bean 的属性,比如这个 bean 的属性是基于构造方法/工厂方法赋值的,
当然这些参数可以在 BeanDefinition 中进行覆盖
*
*/
<T> T getBean(Class<T> requiredType, Object... args) throws BeansException;
/**
返回对应的 ObjectProvider,这是一种可以延迟获取 bean 实例的模式
比如基于 ObjectProvider#getObject 方法获取实例
*/
<T> ObjectProvider<T> getBeanProvider(Class<T> requiredType);
/**
返回对应的 ObjectProvider,这是一种可以延迟获取 bean 实例的模式
比如基于 ObjectProvider#getObject 方法获取实例
*/
<T> ObjectProvider<T> getBeanProvider(ResolvableType requiredType);
/**
是否包含指定 name 的 beanDefinition 或单例实例
此处返回 true 并不意味着 getBean 能返回对应实例。
个人理解:如果 beanFactory 中包含 beanDefinition,也会返回 true,
但是不一定有这个 beanDefinition 的实例,可能还没有实例化出来对应的 bean。
1. 支持别名解析
2. 支持层级查找
*/
boolean containsBean(String name);
/**
name 对应的 bean 是否单例(singleton)
*/
boolean isSingleton(String name) throws NoSuchBeanDefinitionException;
/**
name 对应的 bean 是否原型(prototype)
*/
boolean isPrototype(String name) throws NoSuchBeanDefinitionException;
/**
指定 name 的 bean 是否匹配指定的类型
*/
boolean isTypeMatch(String name, ResolvableType typeToMatch)
throws NoSuchBeanDefinitionException;
/**
指定 name 的 bean 是否匹配指定的类型
*/
boolean isTypeMatch(String name, Class<?> typeToMatch) throws NoSuchBeanDefinitionException;
/**
获取指定 name 的 bean 实例的类型
如果目标 bean 实例是一个 FactoryBean,则返回的使其创建实例的类型,
调用 FactoryBean#getObjectType,这会造成 FactoryBean 的提前实例化
1. 支持别名解析
2. 支持层级查找
*/
@Nullable
Class<?> getType(String name) throws NoSuchBeanDefinitionException;
/**
在 getType(String name) 的基础上加了参数 allowFactoryBeanInit
控制是否允许 FactoryBean 的提前初始化
*/
@Nullable
Class<?> getType(String name, boolean allowFactoryBeanInit)
throws NoSuchBeanDefinitionException;
/**
返回指定 name 的所有别名,基于这些别名获取的 bean 实例都是同一个
如果这个地方传入的是一个别名,那么会返回 bean 原始名称和别名组成的数组
支持层级查找
*/
String[] getAliases(String name);
}
示例
使用 BeanFactory 的基本步骤如下:
- 配置 Bean:在 XML 文件中或通过注解定义和配置 bean。
- 创建 BeanFactory 实例:通过 XmlBeanFactory 或其他实现类来创建一个 BeanFactory 实例,并加载配置信息。
- 获取 Bean:使用 BeanFactory 的 getBean 方法来获取配置好的 bean 实例。
例如,使用 XML 配置的 BeanFactory:
// 创建并配置 BeanFactory
XmlBeanFactory beanFactory = new XmlBeanFactory(new ClassPathResource("beans.xml"));
// 获取 Bean 实例
MyBean myBean = (MyBean) beanFactory.getBean("myBean");
在这个例子中,beans.xml 是一个包含 bean 定义的 XML 文件,myBean 是 XML 中定义的 bean 的 ID。
然而,请注意,虽然 BeanFactory 是 Spring 的核心接口,但在大多数 Spring 应用程序中,开发者更倾向于使用 ApplicationContext,因为它提供了更多的功能和便利性,包括自动装配、事件处理、国际化等。在实际开发中,ApplicationContext 的实现类(如 ClassPathXmlApplicationContext、FileSystemXmlApplicationContext 等)被更广泛地用于加载和配置 beans。