Spring 中用 XML 装配 Bean,竟然有五种姿势!

Spring Boot 系列还在不断的更新,有小伙伴和松哥抱怨对 Spring 还不太懂,其实我 2016 年的时候写过一点点 Spring 的教程,但是不够详细,因此,最近决定再挖一个坑,和大家聊聊 Spring 的一些常见用法,也顺便聊聊源码。

Spring 和 Spring Boot 强相关,因此,相信这个系列不会烂尾。

本想写一些高大上的架构方面的,可是考虑到有很多读者是刚入行的状态,因此还是决定先把 Spring 也和大家过一遍,当然这些东西会穿插着来,尽量满足每一个小伙伴的需求。

今天就先来和大家聊一聊 Spring 中 XML 装配 Bean 的一些经常被人忽略的细节。

使用 XML 配置 Spring ,很多人都用过,可能有的小伙伴没认真总结过,今天我们就来稍微总结下,算是开启我们的 Spring 之旅。

基本配置

XML 配置是最原始最古老的 Bean 的装配方案,曾经我们的项目离不开它,而如今,我们却在慢慢的抛弃它,没办法,时代在进步,我们也要进步呀。为了能看懂前辈们写的代码,我们还是有必要来看一下如何通过 XML 来装配 Bean。

首先我们来创建一个普通的 Maven 工程(不用创建成 web 工程),创建成功之后,引入 Spring 相关的依赖,这里只要引入 spring-context 即可,如下:

1
2
3
4
5
6
7
<dependencies>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
<version>5.1.5.RELEASE</version>
</dependency>
</dependencies>

创建成功之后,我们再来创建一个 Book 类,如下:

1
2
3
4
5
6
public class Book {
private Integer id;
private String name;
private Double price;
//省略 getter/setter
}

然后再在 resources 目录下创建一个 beans.xml 文件,作为 Spring 的配置文件,然后在里边配置一个 Book bean,如下:

1
2
3
4
5
6
<?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.xsd">
<bean class="org.javaboy.spring.Book" id="book"/>
</beans>

在这里,我们在 class 属性中配置类的全路径,id 则表示 bean 的名称,也可以通过 name 属性来指定 bean 的名称,大部分场景下两者无任何差别,会有一些特殊场景下(例如用,隔开多个实例名,两者的处理方案不同),两者有区别。

然后我们在 Java 代码中加载这个配置文件:

1
ClassPathXmlApplicationContext ctx = new ClassPathXmlApplicationContext("classpath:beans.xml");

题外话:

ClassPathXmlApplicationContext 是配置文件众多的加载方式之一,表示从 classpath 下加载配置文件,这也是较常用的加载方式之一。其他常见的加载方式如下:

从这些不同的实现类中可以看到,我们也可以直接从文件系统中加载 Spring 的 XML 配置文件,使用 FileSystemXmlApplicationContext 类即可。

配置文件加载完成后,我们就可以从 Spring 容器中去获取这些 Bean 了,方式如下:

1
Book book = (Book) ctx.getBean("book");

这个表示根据 id 获取相应的 Bean ,我们也可以通过类型来获取,方式如下:

1
Book b1 = ctx.getBean(Book.class);

两种方式推荐第一种。

第二种通过类型获取 Bean 的方式存在一个问题,就是容器中同一个类如果存在多个实例,通过类型获取肯定会出错。

但是此时我们获取到的 Bean 中的属性全部为 null,没有值,这是因为我们在配置的时候没有给属性指定值。

在配置 Bean 时,给 Bean 指定相关的属性值,我们有几种不同的方式:

1.构造方法指定

首先我们可以通过构造方法指定 bean 的属性值,前提是我们为 Book 类提供一个有参构造方法(大家在创建有参构造方法时,一定记得再顺手加一个无参构造方法):

1
2
3
4
5
6
7
8
9
10
11
12
13
public class Book {
private Integer id;
private String name;
private Double price;
public Book() {
}
public Book(Integer id, String name, Double price) {
this.id = id;
this.name = name;
this.price = price;
}
//省略 getter/setter
}

然后在 XML 文件中,我们就可以通过构造方法注入相关值了:

1
2
3
4
5
<bean class="org.javaboy.spring.Book" id="book2">
<constructor-arg name="id" value="99"/>
<constructor-arg name="name" value="三国演义"/>
<constructor-arg name="price" value="99"/>
</bean>

使用构造方法注入相关值的时候,也可以使用下标来描述参数的顺序,注意如果使用下标,参数顺序不能错:

1
2
3
4
5
<bean class="org.javaboy.spring.Book" id="book3">
<constructor-arg index="0" value="99"/>
<constructor-arg index="1" value="红楼梦"/>
<constructor-arg index="2" value="100"/>
</bean>

注入成功之后,当我们再次去获取 Bean 的时候,就可以看到这些属性了。

2.通过属性注入

当然也可以通过属性注入,这是一种更为常见的方式:

1
2
3
4
5
<bean class="org.javaboy.spring.Book" id="book4">
<property name="id" value="99"/>
<property name="name" value="水浒传"/>
<property name="price" value="99"/>
</bean>

3.p名称空间注入

p 名称空间本质上还是通过属性注入的,只不过写法有些差异,p 名称空间注入方式如下:

1
<bean class="org.javaboy.spring.Book" id="book5" p:id="100" p:name="西游记" p:price="40"/>

以上三种不同的属性注入方式,我给大家演示的都是注入基本数据类型,如果注入的是一个对象的话,只需要通过 ref 属性来指明对象的引用即可。

特殊属性注入

除了这些基本属性之外,还有一些特殊属性,例如集合、数组、map 等。我们分别来看。

集合/数组

集合/数组的注入方式基本一致,首先我们给项目添加一个集合属性,如下:

1
2
3
4
5
6
7
public class Book {
private Integer id;
private String name;
private Double price;
private List<String> authors;
//省略 getter/setter
}

属性注入时,可以通过 array 节点注入值:

1
2
3
4
5
6
7
8
9
10
11
12
<bean class="org.javaboy.spring.Book" id="book4">
<property name="id" value="99"/>
<property name="name" value="水浒传"/>
<property name="price" value="99"/>
<property name="authors">
<array>
<value>zhangsan</value>
<value>lisi</value>
<value>javaboy</value>
</array>
</property>
</bean>

也可以通过 list 节点注入值:

1
2
3
4
5
6
7
8
9
10
11
12
<bean class="org.javaboy.spring.Book" id="book4">
<property name="id" value="99"/>
<property name="name" value="水浒传"/>
<property name="price" value="99"/>
<property name="authors">
<list>
<value>zhangsan</value>
<value>lisi</value>
<value>javaboy</value>
</list>
</property>
</bean>

还有一个可能大家使用比较少的方式,就是通过 utils:list 来创建集合属性,然后配置到 Book 属性中去,即可:

1
2
3
4
5
6
7
8
9
10
<bean class="org.javaboy.spring.Book" id="book4">
<property name="id" value="99"/>
<property name="name" value="水浒传"/>
<property name="price" value="99"/>
<property name="authors" ref="authors" />
</bean>
<utils:list id="authors">
<value>javaboy</value>
<value>zhangsan</value>
</utils:list>

这种方式比较少见。

map

map 的注入也有几种不同的方式,可以通过属性指定,也可以通过 utils 来搞定,先来看第一种:

1
2
3
4
5
6
7
8
public class Book {
private Integer id;
private String name;
private Double price;
private List<String> authors;
private Map<String, Object> info;
//省略 getter/setter
}

在 xml 文件中通过如下方式指定属性值:

1
2
3
4
5
6
7
8
9
10
11
12
<bean class="org.javaboy.spring.Book" id="book4">
<property name="id" value="99"/>
<property name="name" value="水浒传"/>
<property name="price" value="99"/>
<property name="authors" ref="authors" />
<property name="info">
<map>
<entry key="name" value="zhangsan"/>
<entry key="age" value="99"/>
</map>
</property>
</bean>

也可以通过 utils 来指定 map 的值,如下:

1
2
3
4
5
6
7
8
9
10
11
<bean class="org.javaboy.spring.Book" id="book4">
<property name="id" value="99"/>
<property name="name" value="水浒传"/>
<property name="price" value="99"/>
<property name="authors" ref="authors" />
<property name="info" ref="info"/>
</bean>
<utils:map id="info">
<entry key="name" value="lisi"/>
<entry key="age" value="98"/>
</utils:map>

properties

properties 属性也是一样的配置方案。既可以通过 props 属性指定,也可以通过 utils 来指定,例如:

1
2
3
4
5
6
7
8
9
public class Book {
private Integer id;
private String name;
private Double price;
private List<String> authors;
private Map<String, Object> info;
private Properties info2;
//省略 getter/setter
}

通过 props 属性指定方式如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
<bean class="org.javaboy.spring.Book" id="book4">
<property name="id" value="99"/>
<property name="name" value="水浒传"/>
<property name="price" value="99"/>
<property name="authors" ref="authors" />
<property name="info" ref="info"/>
<property name="info2">
<props>
<prop key="name">zhangsan</prop>
<prop key="age">99</prop>
</props>
</property>
</bean>

通过 utils 指定方式如下:

1
2
3
4
5
6
7
8
9
10
11
12
<bean class="org.javaboy.spring.Book" id="book4">
<property name="id" value="99"/>
<property name="name" value="水浒传"/>
<property name="price" value="99"/>
<property name="authors" ref="authors"/>
<property name="info" ref="info"/>
<property name="info2" ref="info2"/>
</bean>
<utils:properties id="info2">
<prop key="name">zhangsan</prop>
<prop key="age">99</prop>
</utils:properties>

除了这几种装配方式之外,我们也可以通过工厂方法装配。

工厂方法装配

工厂方法装配可以分为静态工厂和实例工厂两种方式,我们分别来看。

静态工厂

静态工厂方法装配需要我们先创建一个静态工厂方法,像下面这样:

1
2
3
4
5
public class BookFactory {
public static Book getInstance() {
return new Book();
}
}

然后在 XML 文件中装配:

1
<bean class="org.javaboy.spring.BookFactory" id="book6" factory-method="getInstance"/>

此时我们去容器中获取 book6 这个实例,拿到的就是你在静态工厂中返回的 Book 实例。

实例工厂

实例工厂方法则是指工厂方法是一个普通方法,不是静态的,像下面这样:

1
2
3
4
5
public class BookFactory2 {
public Book getInstance() {
return new Book();
}
}

然后在 XML 文件中,我们需要首先配置 BookFactory2 的实例,然后才能调用实例中的方法获取 Book 对象,如下:

1
2
<bean class="org.javaboy.spring.BookFactory2" id="bookFactory2"></bean>
<bean class="org.javaboy.spring.Book" id="book7" factory-bean="bookFactory2" factory-method="getInstance"/>

工厂方法装配的价值在哪里呢?

例如 Druid 中的 DataSource 对象,通过 DruidDataSourceBuilder.create().build() 方法来构建,如果我们想在 XML 中做这个配置,显然不太容易,此时就可以使用工厂方法装配了。

好了,这就是 XML 装配 Bean 的一个简单介绍,比较简单,但是为了知识的完整性,我还是稍微写了下,能看到这里的都是真爱啊!

# Spring

喜欢这篇文章吗?扫码关注公众号【江南一点雨】【江南一点雨】专注于 SPRING BOOT+微服务以及前后端分离技术,每天推送原创技术干货,关注后回复 JAVA,领取松哥为你精心准备的 JAVA 干货!

评论

Your browser is out-of-date!

Update your browser to view this website correctly. Update my browser now

×