前言:Spring容器就是一个超级大工厂,而Spring容器中的Bean就是该工厂的产品,Spring容器能产生哪些产品,则完全取决于开发者在配置文件中的配置。本文就配置Bean时可添加的属性、功能做介绍,基本覆盖开发中的常规功能。
本篇文章重点关注以下问题:
- Bean的基本定义和属性
- 配置Bean的依赖关系
1. Bean的基本定义和属性
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-4.3.xsd">
<bean id="pencil" class="com.wj.chapter1.ioc.constructor.xml.Service.Pencil"></bean>
<bean id="ballpointPen" class="com.wj.chapter1.ioc.constructor.xml.Service.BallpointPen"></bean>
</beans>
1.1 配置文件根元素<beans>
<beans../>元素是Spring配置文件的根元素,该元素可以指定如下属性:
- default-lazy-init:指定该 <beans../>元素下配置的所有Bean默认的延迟初始化行为;(默认false)
- default-merge:指定该 <beans../>元素下配置的所有Bean默认的merge行为(继承父Bean属性);(默认true)
- default-autowire:指定该 <beans../>元素下配置的所有Bean默认的自动装配行为;(默认no)
- default-autowire-candidates:指定该 <beans../>元素下配置的所有Bean默认是否作为自动装配的候选Bean;
- default-init-method:指定该 <beans../>元素下配置的所有Bean默认的初始化方法;
- default-destroy-method:指定该 <beans../>元素下配置的所有Bean默认的回收方法。
1.2 配置<beans../>的子元素<bean../>
<beans../>元素可以包含多个<bean../>子元素,每个<bean../>子元素定义一个Bean,每个Bean对应Spring容器里的一个java实例。
定义Bean时,通常需要指定两个属性:id、class
id: 确定该Bean的唯一标识,容器对该Bean的管理、访问,以及该Bean的依赖关系,都通
过该属性完成。Bean的id属性在Spring容器中应该是唯一的;(字母开头,字母数字组成)
class:指定该Bean的实现类,而不是接口,通常情况下Spring会直接使用new关键字创建该
Bean的实例,因此,这里必须提供Bean的实现类的类名。
<bean../>元素的其他属性:
属性名 | 属性值类型 | 默认值 | 作用 |
abstract | Boolean | false | 指明该Bean作为父类,spring容器不会为该类创建对象 |
autowire-candidate | Boolean | true | 指明该Bean是否作为自动装配的候选Bean |
autowire | String | no | 指明该Bean是否采用自动装配及采用自动装配的规则 |
depends-on | String | —— | 显示指明该Bean依赖的其他Bean(确保依赖Bean先实例化) |
destroy-method | String | —— | 指明该Bean默认的回收方法 |
factory-bean | String | —— | 工厂方法创建对象时,指定工厂Bean |
factory-method | String | —— | 工厂方法创建对象时,指定工厂Bean中创建对象的方法 |
init-method | String | —— | 指明该Bean默认的初始化方法 |
lazy-init | Boolean | false | 指明该Bean的延迟初始化行为(只对单例模式起作用) |
name | String | —— | 指明该Bean的别名alias,可以有多个,可以其他Bean重名 |
parent | String | —— | 指明该bean需要继承的父类Bean |
primary | Boolean | false | 自动装配若候选Bean不止一个,则此属性为true的Bean当选 |
scope | String | singleton | 指明该Bean的作用域 |
补充说明:
- autowire属性有五种模式:no(不采用自动装配)、byName(通过属性的名称自动装配)、byType(通过类型自动装配)、constructor(通过构造函数的参数类型来匹配)、default(采用父级标签,即beans的default-autowire属性的配置);
- scope属性有五种模式:singleton(单例模式)、prototype(多例模式)、request(该bean仅在当前HTTP request内有效)、session(该bean仅在当前HTTP session内有效)、global session(作用域类似于标准的HTTP Session作用域,不过它仅仅在基于portlet的web应用中才有意义)。
2. 配置Bean的依赖关系
Spring有两种依赖注入方式(设值注入和构造注入),但不管哪种注入,都需要为参数传入参数值,而java类的成员变量可以是各种数据类型,除了基本类型、字符串类型、还可以是其他java实例,也可以是java集合、数组等,所有Spring允许通过如下元素为setter方法、构造器参数指定参数值:
- value:指定参数值是基本类型及其包装、字符串类型;
- ref:指定参数值是容器中的另一个Bean实例;
- bean:指定参数值是一个嵌套Bean实例;
- list、set、map及props:指定参数值是集合。
2.1 各数据类型的成员变量在配置Bean时的注入方式
2.1.1 设置普通属性值
<!-- 设置普通属性值. -->
<bean id="valueDiBean" class="com.wj.chapter3.di.Di_Bean_Value">
<!-- 指定int型参数. -->
<property name="integerField" value="100"/>
<!-- 指定double型参数. -->
<property name="doubleField" value="99.99"/>
<!-- 指定String型参数. -->
<property name="stringField" value="一百分"/>
</bean>
2.1.2 配置合作者Bean
<!-- 配置合作者Bean. -->
<bean id="refDiBean" class="com.wj.chapter3.di.Di_Bean_Ref">
<property name="valueBean" ref="valueDiBean"></property>
</bean>
2.1.3 指定使用byName策略自动注入
<!-- 指定使用byName策略,Spring会根据setter方法的方法名与Bean的id(dependOnBeanTTT)进行匹配. -->
<bean id="byNameBean" class="com.wj.chapter3.di.byNameBean.ByNameBean" autowire="byName"/>
<!-- setDependOnBeanTTT(..)方法与id(dependOnBeanTTT)相对应. -->
<bean id="dependOnBeanTTT" class="com.wj.chapter3.di.byNameBean.ByNameDependOn">
<property name="name" value="熊燕子"/>
</bean>
2.1.4 指定使用byType策略自动注入
<!-- 指定使用byType策略,Spring会根据setter方法的参数类型与Bean的类型进行匹配. -->
<bean id="byTypeBean" class="com.wj.chapter3.di.byTypeBean.ByTypeBean" autowire="byType"/>
<bean id="dependOnBean1" class="com.wj.chapter3.di.byTypeBean.ByTypeDependOn1">
<property name="name" value="熊燕子1"/>
</bean>
<!-- autowire-candidate指明Bean不作为自动装配的候选Bean. -->
<bean id="dependOnBean2" class="com.wj.chapter3.di.byTypeBean.ByTypeDependOn2" autowire-candidate="false">
<property name="name" value="熊燕子2"/>
</bean>
2.1.5 注入嵌套Bean
<!-- 注入嵌套Bean(嵌套Bean不能被容器访问). -->
<bean id="outerBean" class="com.wj.chapter3.di.nestedBean.OuterBean">
<!-- 驱动调用outerBean的getInnerBean()方法,使用嵌套Bean作为参数 -->
<property name="innerBean">
<!-- 嵌套Bean配置的对象仅作为setter方法的参数嵌套Bean不能被容器访问,因此无需指定id属性-->
<bean class="com.wj.chapter3.di.nestedBean.InnerBean"/>
</property>
</bean>
2.1.6 注入集合值
<bean id="collectionBean" class="com.wj.chapter3.di.DI_Bean_Collection">
<property name="list">
<!-- 为调用setList()方法配置List集合作为参数值 -->
<list>
<value>List元素1</value>
<value>List元素2</value>
<value>List元素3</value>
</list>
</property>
<property name="set">
<!-- 为调用setSet()方法配置Map集合作为参数值 -->
<set>
<value>100</value>
<value>200</value>
<value>300</value>
</set>
</property>
<property name="map">
<!-- 为调用setMap()方法配置Map集合作为参数值 -->
<map>
<!-- 每个entry配置一个key-value对 -->
<entry key="熊燕子 " value-ref="dependOnBean1"/>
<entry key="wj" value-ref="dependOnBean2"/>
</map>
</property>
<property name="prop">
<!-- 为调用setProp()方法配置Properties集合作为参数值 -->
<props>
<!-- 每个prop元素配置一个属性项,其中key指定属性名 -->
<prop key="熊燕子">159</prop>
<prop key="wj">173</prop>
</props>
</property>
<property name="array">
<!-- 为调用setArray()方法配置数组作为参数值 -->
<list>
<value>小学</value>
<value>中学</value>
<value>大学</value>
</list>
</property>
</bean>
2.2 编写各实体Bean
这里不做阐述,详细代码可见附件;
2.3 编写测试代码
public class Main {
// 1.指明xml配置文件位置,便于Spring读取,从而知道Bean的相关信息
private static final String PATH_XML = "com/wj/chapter3/di/applicationContext-di.xml";
@SuppressWarnings("resource")
public static void main(String[] args) {
// 2.根据xml配置文件,创建Spring IOC容器的上下文
ApplicationContext cxt = new ClassPathXmlApplicationContext(PATH_XML);
// 3.设置普通属性值测试
Di_Bean_Value valuebean = cxt.getBean("valueDiBean", Di_Bean_Value.class);
System.out.println("**************设置普通属性值测试*************");
System.out.println("int类型:" + valuebean.getIntegerField());
System.out.println("double类型:" + valuebean.getDoubleField());
System.out.println("String类型:" + valuebean.getStringField());
System.out.println();
// 4. 配置合作者Bean测试
Di_Bean_Ref refBean = cxt.getBean("refDiBean", Di_Bean_Ref.class);
System.out.println("**************配置合作者Bean测试*************");
System.out.println("合作者Bean:" + refBean.toString());
System.out.println();
// 5. 指定使用byName策略测试
ByNameBean byNameBean = cxt.getBean("byNameBean", ByNameBean.class);
System.out.println("**************指定使用byName策略测试*************");
byNameBean.test();
System.out.println();
// 6. 指定使用byType策略测试
ByTypeBean byTypeBean = cxt.getBean("byTypeBean", ByTypeBean.class);
System.out.println("**************指定使用byType策略测试*************");
byTypeBean.test();
System.out.println();
// 7. 测试注入内嵌Bean
OuterBean outerBean = cxt.getBean("outerBean", OuterBean.class);
System.out.println("**************测试注入内嵌Bean*************");
outerBean.test();
System.out.println();
// 8. 测试注入集合值
DI_Bean_Collection collectionBean = cxt.getBean("collectionBean", DI_Bean_Collection.class);
System.out.println("**************测试注入集合值*************");
collectionBean.test();
}
}
2.4 查看测试结果,验证注入的正确性
可以看出,测试基本成功。
补充:Spring还支持组合属性的方式进行注入,但是这不常见,就没写入实例。