对于最新的稳定版本,请使用 Spring Framework 6.2.0! |
Bean 概述
Spring IoC 容器管理一个或多个 bean。这些 bean 是使用
您提供给容器的配置元数据(例如,以 XML 的形式<bean/>
定义)。
在容器本身中,这些 bean 定义表示为BeanDefinition
对象,其中包含(除其他信息外)以下元数据:
-
包限定的类名:通常是 bean 被定义。
-
Bean 行为配置元素,这些元素表示 Bean 在 容器(范围、生命周期回调等)。
-
对 Bean 执行其工作所需的其他 Bean 的引用。这些 引用也称为协作者或依赖项。
-
要在新创建的对象中设置的其他配置设置 — 例如,大小 pool 的限制或要在管理 连接池。
此元数据转换为构成每个 Bean 定义的一组属性。 下表描述了这些属性:
财产 | 解释于... |
---|---|
类 |
|
名字 |
|
范围 |
|
构造函数参数 |
|
性能 |
|
自动装配模式 |
|
延迟初始化模式 |
|
初始化方法 |
|
销毁方法 |
除了包含有关如何创建特定
bean 中,ApplicationContext
实现还允许注册现有的
在容器外部创建的对象(由用户创建)。这是通过访问
ApplicationContext 的BeanFactory
通过getBeanFactory()
方法,该方法返回
这DefaultListableBeanFactory
实现。DefaultListableBeanFactory
支持
此注册通过registerSingleton(..)
和registerBeanDefinition(..)
方法。但是,典型的应用程序仅使用通过常规定义的 bean
Bean 定义元数据。
Bean 元数据和手动提供的单例实例需要注册为 early 为了让容器在自动装配期间正确地推断它们 和其他内省步骤。在覆盖现有元数据和现有 在某种程度上支持单例实例,在 运行时(与工厂的实时访问同时)不受官方支持,可能会 导致并发访问异常、Bean 容器中的状态不一致,或两者兼而有之。 |
命名 Bean
每个 bean 都有一个或多个标识符。这些标识符在 托管 Bean 的容器。一个 bean 通常只有一个标识符。但是,如果它 需要多个,额外的可以被视为别名。
在基于 XML 的配置元数据中,您可以使用id
属性、name
属性或
两者都用于指定 Bean 标识符。这id
attribute 允许您只指定一个id
.
通常,这些名称是字母数字('myBean'、'someService' 等),但它们
也可以包含特殊字符。如果要为
bean,您也可以在name
属性,用逗号 (,
),
分号 () 或空格。尽管;
id
attribute 定义为xsd:string
类型, Beanid
唯一性由容器强制执行,但不由 XML 强制执行
解析 器。
您无需提供name
或id
对于一个 bean。如果您未提供name
或id
显式地,容器为该 bean 生成唯一的名称。然而
如果要按名称引用该 bean,请使用ref
元素或
Service Locator 样式查找,您必须提供名称。
不提供名称的动机与使用内部 bean 和自动装配协作者有关。
通过在 Classpath 中进行组件扫描, Spring 会为 unnamed 生成 bean 名称
组件,遵循前面描述的规则:本质上,采用简单的类名
并将其初始字符转换为小写。然而,在(不寻常的)特别
当有多个字符并且同时具有第一个和第二个字符时
为大写,则保留原始大小写。这些规则与
定义者java.beans.Introspector.decapitalize (Spring 在此处使用)。 |
在 Bean 定义之外为 Bean 设置别名
在 bean 定义本身中,您可以通过使用
最多 1 个 Name 的组合,该名称由id
属性和任意数量的其他
names 在name
属性。这些名称可以是同一 bean 的等效别名
,并且在某些情况下很有用,例如让应用程序中的每个组件
使用特定于该组件的 Bean 名称来引用公共依赖项
本身。
指定实际定义 bean 的所有别名并不总是足够的,
然而。有时需要为定义的 bean 引入别名
别处。在配置拆分的大型系统中,通常会出现这种情况
在每个子系统中,每个子系统都有自己的一组对象定义。
在基于 XML 的配置元数据中,您可以使用<alias/>
元素来完成
这。以下示例显示了如何执行此作:
<alias name="fromName" alias="toName"/>
在这种情况下,名为fromName
也可能,
使用这个别名定义后,称为toName
.
例如,子系统 A 的配置元数据可以通过
名称subsystemA-dataSource
.子系统 B 的配置元数据可以引用
名称为subsystemB-dataSource
.编写主应用程序时
使用这两个子系统,则主应用程序通过
名称myApp-dataSource
.要让所有三个名称都引用同一个对象,您可以
将以下别名定义添加到配置元数据中:
<alias name="myApp-dataSource" alias="subsystemA-dataSource"/>
<alias name="myApp-dataSource" alias="subsystemB-dataSource"/>
现在每个组件和主应用程序都可以通过名称来引用 dataSource 这是唯一的,并且保证不会与任何其他定义冲突(有效地 创建命名空间),但它们引用的是同一个 bean。
实例化 Bean
bean 定义本质上是创建一个或多个对象的配方。这 容器在询问时查看命名 bean 的配方,并使用配置 元数据来创建(或获取)实际对象。
如果使用基于 XML 的配置元数据,请指定对象的类型(或类)
即在class
属性的<bean/>
元素。这class
属性(在内部,它是一个Class
属性BeanDefinition
instance) 通常是必需的。(有关异常,请参见使用实例工厂方法实例化和 Bean 定义继承。
您可以使用Class
property 的
-
通常,在容器 它本身通过反射性地调用其构造函数来直接创建 Bean 等同于 Java 代码,其中
new
算子。 -
要指定包含
static
factory 方法,即 调用来创建对象,在不太常见的情况下,容器调用static
factory 方法创建 bean。返回的对象类型 从对static
factory 方法可以是同一个类或另一个类 类。
使用 Constructor 进行实例化
当你通过构造函数方法创建一个 bean 时,所有普通类都可以被 和 与 Spring 兼容。也就是说,正在开发的类不需要实现 任何特定接口或以特定方式编码。只需指定 bean 类应该就足够了。但是,具体取决于您为该特定 bean,则可能需要一个默认的(空的)构造函数。
Spring IoC 容器几乎可以管理您希望它管理的任何类。是的 不限于管理真正的 JavaBeans。大多数 Spring 用户更喜欢带有 仅对默认 (无参数) 构造函数和适当的 setter 和 getter 进行建模 在容器中的属性之后。你也可以有更多异国情调的非 bean 样式 类。例如,如果您需要使用遗留连接池 绝对不遵守 JavaBean 规范,Spring 可以将其管理为 井。
使用基于 XML 的配置元数据,您可以按如下方式指定 Bean 类:
<bean id="exampleBean" class="examples.ExampleBean"/>
<bean name="anotherExample" class="examples.ExampleBeanTwo"/>
有关向构造函数提供参数的机制的详细信息(如果需要) 以及在构造对象后设置对象实例属性,请参阅注入依赖项。
使用 Static Factory Method 进行实例化
定义使用静态工厂方法创建的 bean 时,请使用class
属性来指定包含static
factory 方法和属性
叫factory-method
来指定工厂方法本身的名称。您应该
能够调用此方法(使用可选参数,如下所述)并返回一个实时的
object,该对象随后被视为通过构造函数创建的。
这种 bean 定义的一个用途是调用static
工厂。
以下 Bean 定义指定将通过调用
Factory 方法。定义没有指定返回对象的类型(类),
而是包含 Factory 方法的类。在此示例中,createInstance()
method 必须是static
方法。以下示例说明如何
指定 Factory 方法:
<bean id="clientService"
class="examples.ClientService"
factory-method="createInstance"/>
下面的示例展示了一个将与前面的 bean 定义一起使用的类:
-
Java
-
Kotlin
public class ClientService {
private static ClientService clientService = new ClientService();
private ClientService() {}
public static ClientService createInstance() {
return clientService;
}
}
class ClientService private constructor() {
companion object {
private val clientService = ClientService()
@JvmStatic
fun createInstance() = clientService
}
}
有关向工厂方法提供(可选)参数的机制的详细信息 以及在从工厂返回对象后设置对象实例属性, 详见 依赖关系和配置。
使用实例工厂方法进行实例化
与通过 static factory method 进行实例化类似,使用实例工厂方法进行实例化会调用非 static
方法创建一个新的 bean。要使用此功能
机制中,离开class
属性为空,并在factory-bean
属性
在当前 (或 parent) 容器中指定 bean 的名称,其中包含
要调用以创建对象的 instance 方法。设置
factory 方法本身替换为factory-method
属性。以下示例显示了
如何配置这样的 bean:
<!-- the factory bean, which contains a method called createClientServiceInstance() -->
<bean id="serviceLocator" class="examples.DefaultServiceLocator">
<!-- inject any dependencies required by this locator bean -->
</bean>
<!-- the bean to be created via the factory bean -->
<bean id="clientService"
factory-bean="serviceLocator"
factory-method="createClientServiceInstance"/>
以下示例显示了相应的类:
-
Java
-
Kotlin
public class DefaultServiceLocator {
private static ClientService clientService = new ClientServiceImpl();
public ClientService createClientServiceInstance() {
return clientService;
}
}
class DefaultServiceLocator {
companion object {
private val clientService = ClientServiceImpl()
}
fun createClientServiceInstance(): ClientService {
return clientService
}
}
一个工厂类还可以包含多个工厂方法,如下例所示:
<bean id="serviceLocator" class="examples.DefaultServiceLocator">
<!-- inject any dependencies required by this locator bean -->
</bean>
<bean id="clientService"
factory-bean="serviceLocator"
factory-method="createClientServiceInstance"/>
<bean id="accountService"
factory-bean="serviceLocator"
factory-method="createAccountServiceInstance"/>
以下示例显示了相应的类:
-
Java
-
Kotlin
public class DefaultServiceLocator {
private static ClientService clientService = new ClientServiceImpl();
private static AccountService accountService = new AccountServiceImpl();
public ClientService createClientServiceInstance() {
return clientService;
}
public AccountService createAccountServiceInstance() {
return accountService;
}
}
class DefaultServiceLocator {
companion object {
private val clientService = ClientServiceImpl()
private val accountService = AccountServiceImpl()
}
fun createClientServiceInstance(): ClientService {
return clientService
}
fun createAccountServiceInstance(): AccountService {
return accountService
}
}
这种方法表明,工厂 Bean 本身可以通过 依赖注入 (DI)。 详见 依赖关系和配置。
在 Spring 文档中,“工厂 Bean”是指在
Spring 容器,它通过实例或静态工厂方法创建对象。相比之下,FactoryBean (注意大写)指的是特定于 Spring 的FactoryBean implementation 类。 |
确定 Bean 的运行时类型
确定特定 bean 的运行时类型并非易事。中指定的类
Bean 元数据定义只是一个初始类引用,可能会组合在一起
替换为声明的工厂方法或作为FactoryBean
类,这可能会导致
bean 的运行时类型不同,或者在实例级别的情况下根本不设置
Factory 方法(通过指定的factory-bean
name 代替)。
此外,AOP 代理可以使用基于接口的代理包装 bean 实例,其中
目标 Bean 的实际类型(仅其实现的接口)的有限公开。
了解特定 Bean 的实际运行时类型的推荐方法是
一个BeanFactory.getType
call 指定的 bean 名称。这需要以上所有
cases 中,并返回BeanFactory.getBean
call 为
将返回相同的 bean 名称。