（二）《Spring实战》——Spring核心

第二章：装配Bean

在Spring中，对象无需自己查找或创建与其所关联的其他对象。相反，容器负责把需要相互协作的对象引用赋予各个对象。例如，一个订单管理组件需要信用卡认证组件，但它不需要自己创建信用卡认证组件。订单管理组件只需要表明自己两手空空，容器就会主动赋予它一个信用卡认证组件。

创建应用对象之间协作关系的行为通常称为装配（wiring），这也是依赖注入（DI）的本质。

1. Spring配置的可选方案

　　Spring容器负责创建应用程序中的bean并通过DI来协调这些对象之间的关系。但是，作为开发人员，你需要告诉Spring要创建哪些bean并且如何将其装配在一起。当描述bean如何进行装配时，Spring具有非常大的灵活性，它提供了三种主要的装配机制：

• 在XML中进行显式配置。

• 在Java中进行显式配置。

• 隐式的bean发现机制和自动装配。

Spring有多种可选方案来配置bean，这是非常棒的，但有时候你必须要在其中做出选择。

　　这方面，并没有唯一的正确答案。你所做出的选择必须要适合你和你的项目。而且，谁说我们只能选择其中的一种方案呢？Spring的配置风格是可以互相搭配的，所以你可以选择使用XML装配一些bean，使用Spring基于Java的配置（JavaConfig）来装配另一些bean，而将剩余的bean让Spring去自动发现。

　　即便如此，我的建议是尽可能地使用自动配置的机制。显式配置越少越好。当你必须要显式配置bean的时候（比如，有些源码不是由你来维护的，而当你需要为这些代码配置bean的时候），我推荐使用类型安全并且比XML更加强大的JavaConfig。最后，只有当你想要使用便利的XML命名空间，并且在JavaConfig中没有同样的实现时，才应该使XML。

2. 自动化装配bean

　　尽管显式装配技术（借助Java和XML来进行Spring装配）非常有用，但是在便利性方面，最强大的还是Spring的自动化配置。

Spring从两个角度来实现自动化装配：

• 组件扫描（component scanning）：Spring会自动发现应用上下文中所创建的bean。

• 自动装配（autowiring）：Spring自动满足bean之间的依赖。

　　为了阐述组件扫描和装配，我们需要创建几个bean，它们代表了一个音响系统中的组件。首先，要创建CompactDisc 类，Spring会发现它并将其创建为一个bean。然后，会创建一个CDPlayer 类，让Spring发现它，并将CompactDisc bean注入进来。

2.1 创建可被发现的bean

CompactDisc接口在Java中定义了CD的概念

package soundsystem;

public interface CompactDisc {
  void play();
}

　　CompactDisc 的具体内容并不重要，重要的是你将其定义为一个接口。作为接口，它定义了CD播放器对一盘CD所能进行的操作。它将CD播放器的任意实现与CD本身的耦合降低到了最小的程度。

带有@Component注解的CompactDisc实现类SgtPeppers

package soundsystem;
import org.springframework.stereotype.Component;

@Component
public class SgtPeppers implements CompactDisc {

  private String title = "Sgt. Pepper's Lonely Hearts Club Band";
  private String artist = "The Beatles";

  public void play() {
    System.out.println("Playing " + title + " by " + artist);
  }
}

　　和CompactDisc 接口一样，SgtPeppers 的具体内容并不重要。你需要注意的就是SgtPeppers 类上使用了@Component 注解。这个简单的注解表明该类会作为组件类，并告知Spring要为这个类创建bean。没有必要显式配置SgtPeppers bean，因为这个类使用了@Component 注解，所以Spring会为你把事情处理妥当。

　　不过，组件扫描默认是不启用的。我们还需要显式配置一下Spring，从而命令它去寻找带有@Component 注解的类，并为其创建bean。

@ComponentScan注解启用了组件扫描

package soundsystem;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;

@Configuration
@ComponentScan
public class CDPlayerConfig {
}

　　如果没有其他配置的话，@ComponentScan 默认会扫描与配置类相同的包。因为CDPlayerConfig 类位于soundsystem 包中，因此Spring将会扫描这个包以及这个包下的所有子包，查找带有@Component 注解的类。这样的话，就能发现CompactDisc ，并且会在Spring中自动为其创建一个bean。

　　如果你更倾向于使用XML来启用组件扫描的话，那么可以使用Spring context 命名空间的<context:component-scan> 元素。

通过XML启用组件扫描

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:context="http://www.springframework.org/schema/context"
  xmlns:c="http://www.springframework.org/schema/c"
  xmlns:p="http://www.springframework.org/schema/p"
  xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
        http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd">

  <context:component-scan base-package="soundsystem" />

</beans>

测试组件扫描能够发现CompactDisc

package soundsystem;

import static org.junit.Assert.*;

import org.junit.Rule;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.test.context.ContextConfiguration;
import org.springframework.test.context.junit4.SpringJUnit4ClassRunner;

@RunWith(SpringJUnit4ClassRunner.class)
@ContextConfiguration(classes=CDPlayerConfig.class)
public class CDPlayerTest {

  @Autowired
  private CompactDisc cd;

  @Test
  public void cdShouldNotBeNull() {
    assertNotNull(cd);
  }

}

　　CDPlayerTest 使用了Spring的SpringJUnit4ClassRunner ，以便在测试开始的时候自动创建Spring的应用上下文。注解@ContextConfiguration 会告诉它需要在CDPlayerConfig 中加载配置。因为CDPlayerConfig 类中包含了@ComponentScan ，因此最终的应用上下文中应该包含CompactDisc bean。

　　测试代码中有一个CompactDisc 类型的属性，并且这个属性带有@Autowired 注解，以便于将CompactDisc bean注入到测试代码之中。

2.2 为组件扫描的bean命名

　　Spring应用上下文中所有的bean都会给定一个ID。在前面的例子中，尽管我们没有明确地为SgtPeppers bean设置ID，但Spring会根据类名为其指定一个ID。具体来讲，这个bean所给定的ID为sgtPeppers ，也就是将类名的第一个字母变为小写。

　　如果想为这个bean设置不同的ID，你所要做的就是将期望的ID作为值传递给@Component 注解。

　　还有一种方式是使用Java依赖注入规范（Java Dependency Injection）中所提供的@Named 注解来为bean设置ID。（不常用）

2.3  设置组件扫描的基础包

　　为了指定不同的基础包，你所需要做的就是在@ComponentScan 的value属性中指明包的名称：

　　要表明你所设置的是基础包，那么你可以通过basePackages属性进行配置：

　　要设置多个基础包的话，只需要将basePackages 属性设置为要扫描包的一个数组即可：

　　除了将包设置为简单的String类型（缺点类型不安全【not type-safe】）之外，@ComponentScan 还提供了另外一种方法，那就是将其指定为包中所包含的类或接口：

　　可以看到，basePackages 属性被替换成了basePackageClasses 。同时，我们不是再使用String 类型的名称来指定包，为basePackageClasses 属性所设置的数组中包含了类。这些类所在的包将会作为组件扫描的基础包。

2.4 通过为bean添加注解实现自动装配

　　简单来说，自动装配就是让Spring自动满足bean依赖的一种方法，在满足依赖的过程中，会在Spring应用上下文中寻找匹配某个bean需求的其他bean。为了声明要进行自动装配，我们可以借助Spring的@Autowired 注解。

　　如下，构造器上添加了@Autowired 注解，这表明当Spring创建CDPlayer bean的时候，会通过这个构造器来进行实例化并且会传入一个可设置给CompactDisc 类型的bean。

package soundsystem;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;

@Component
public class CDPlayer implements MediaPlayer {
  private CompactDisc cd;

  @Autowired
  public CDPlayer(CompactDisc cd) {
    this.cd = cd;
  }

  public void play() {
    cd.play();
  }
}

　　@Autowired 注解不仅能够用在构造器上，还能用在属性的Setter方法上。

@Autowired
public setCompactDisc(CompactDisc cd) {
    this.cd = cd;
}

　　@Autowired 注解可以用在类的任何方法上。

@Autowired
public insertCompactDisc(CompactDisc cd) {
    this.cd = cd;
}

　　不管是构造器、Setter方法还是其他的方法，Spring都会尝试满足方法参数上所声明的依赖。假如有且只有一个bean匹配依赖需求的话，那么这个bean将会被装配进来。

　　如果没有匹配的bean，那么在应用上下文创建的时候，Spring会抛出一个异常。为了避免异常的出现，你可以将@Autowired 的required 属性设置为false ：

@Autowired(required=false)
public CDPlayer(CompactDisc cd) {
    this.cd = cd;
}

　　将required 属性设置为false 时，Spring会尝试执行自动装配，但是如果没有匹配的bean的话，Spring将会让这个bean处于未装配的状态。但是，把required 属性设置为false 时，你需要谨慎对待。如果在你的代码中没有进行null检查的话，这个处于未装配状态的属性有可能会出现NullPointerException 。

　　@Autowired 是Spring特有的注解。如果你不愿意在代码中到处使用Spring的特定注解来完成自动装配任务的话，那么你可以考虑将其替换为@Inject ：

　　@Inject 注解来源于Java依赖注入规范，该规范同时还为我们定义了@Named 注解。在自动装配中，Spring同时支持@Inject 和@Autowired 。尽管@Inject 和@Autowired 之间有着一些细微的差别，但是在大多数场景下，它们都是可以互相替换的。

2.5 验证自动装配

package soundsystem;

import static org.junit.Assert.*;

import org.junit.Rule;
import org.junit.Test;
import org.junit.contrib.java.lang.system.StandardOutputStreamLog;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.test.context.ContextConfiguration;
import org.springframework.test.context.junit4.SpringJUnit4ClassRunner;

@RunWith(SpringJUnit4ClassRunner.class)
@ContextConfiguration(classes=CDPlayerConfig.class)
public class CDPlayerTest {

  //测试代码使用StandardOutputStreamLog 基于控制台的输出编写断言
  @Rule
  public final StandardOutputStreamLog log = new StandardOutputStreamLog();

  //将CDPlayer bean注入到测试代码的player 成员变量之中（它是更为通用的MediaPlayer 类型）
  @Autowired
  private MediaPlayer player;

  @Autowired
  private CompactDisc cd;

  @Test
  public void cdShouldNotBeNull() {
    assertNotNull(cd);
  }

  @Test
  public void play() {
    player.play();
    assertEquals(
        "Playing Sgt. Pepper's Lonely Hearts Club Band by The Beatles\n",
        log.getLog());
  }

}

3. 通过Java代码装配bean

　　在进行显式配置时，JavaConfig是更好的方案，因为它更为强大、类型安全并且对重构友好。因为它就是Java代码，就像应用程序中的其他Java代码一样。

　　同时，JavaConfig与其他的Java代码又有所区别，在概念上，它与应用程序中的业务逻辑和领域代码是不同的。尽管它与其他的组件一样都使用相同的语言进行表述，但JavaConfig是配置代码。这意味着它不应该包含任何业务逻辑，JavaConfig也不应该侵入到业务逻辑代码之中。尽管不是必须的，但通常会将JavaConfig放到单独的包中，使它与其他的应用程序逻辑分离开来，这样对于它的意图就不会产生困惑了。

3.1 创建配置类

package soundsystem;import org.springframework.context.annotation.Configuration;

@Configuration
public class CDPlayerConfig {
}

　　创建JavaConfig类的关键在于为其添加@Configuration 注解，@Configuration 注解表明这个类是一个配置类，该类应该包含在Spring应用上下文中如何创建bean的细节。

3.2 声明简单的bean

　　要在JavaConfig中声明bean ，我们需要编写一个方法，这个方法会创建所需类型的实例，然后给这个方法添加@Bean 注解。

 @Bean
  public CompactDisc compactDisc() {
    return new SgtPeppers();
  }

　　默认情况下，bean的ID与带有@Bean 注解的方法名是一样的。当然也可通过name属性自定义。

 @Bean(name="lonelyHeartsClubBand")
  public CompactDisc compactDisc() {
    return new SgtPeppers();
  }

3.3 借助JavaConfig实现注入

　　可以使用上面的代码，通过调用方法来引用bean，但最常用的方法是下面这种：

@Bean
  public CDPlayer cdPlayer(CompactDisc compactDisc) {
    return new CDPlayer(compactDisc);
  }

　　在这里，cdPlayer() 方法请求一个CompactDisc 作为参数。当Spring调用cdPlayer() 创建CDPlayer bean的时候，它会自动装配一个CompactDisc 到配置方法之中。然后，方法体就可以按照合适的方式来使用它。借助这种技术，cdPlayer() 方法也能够将CompactDisc 注入到CDPlayer 的构造器中，而且不用明确引用CompactDisc 的@Bean 方法。

4. 通过xml装配bean

4.1 创建xml配置规范

　　创建新的配置规范。在使用JavaConfig的时候，这意味着要创建一个带有@Configuration 注解的类，而在XML配置中，这意味着要创建一个XML文件，并且要以<beans> 元素为根。

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:context="http://www.springframework.org/schema/context"
  xsi:schemaLocation="http://www.springframework.org/schema/beans
    http://www.springframework.org/schema/beans/spring-beans.xsd
    http://www.springframework.org/schema/context
    http://www.springframework.org/schema/context/spring-context.xsd">

</beans>

4.2 声明一个简单的bean

<bean id="compactDisc"  class="soundsystem.SgtPeppers" />

4.3 借助构造器注入初始化bean

构造器注入，有两种基本的配置方案可供选择：

• <constructor-arg> 元素

• 使用Spring 3.0所引入的c-命名空间

4.3.1 构造器注入bean引用

<constructor-arg >使用ref 来引入其他bean

　　　　

c-命名空间

　　　　   

4.3.2 将字面量注入到构造器中

<constructor-arg>使用value 属性表明给定的值要以字面量的形式注入到构造器之中。

c-命名空间

　　①引用构造器参数的名字

　　　

　　②通过参数索引装配相同的字面量值

　　　

4.3.3 装配集合

　

4.4 设置属性

引用bean

<property >通过ref引用bean

　

p-命名空间

　

将字面量注入到属性中

<property> 使用value 属性设置属性值

　

p-命名空间

　

不能使用p-命名空间来装配集合，装配集合可使用<util:list>

　

现在，我们能够像使用其他的bean那样，将磁道列表bean注入到BlankDisc bean的tracks 属性中

　

5. 导入和混合配置

　　在自动装配时，它并不在意要装配的bean来自哪里。自动装配的时候会考虑到Spring容器中所有的bean，不管它是在JavaConfig或XML中声明的还是通过组件扫描获取到的。

5.1 在JavaConfig中引用XML配置

　　假设BlankDisc 定义在名为cd-config.xml 的文件中，该文件位于根类路径下，那么可以修改SoundSystemConfig ，让它使用@ImportResource 注解，如下所示：

　　

　　两个bean——配置在JavaConfig中的CDPlayer 以及配置在XML中BlankDisc ——都会被加载到Spring容器之中。因为CDPlayer 中带有@Bean 注解的方法接受一个CompactDisc 作为参数，因此BlankDisc 将会装配进来，此时与它是通过XML配置的没有任何关系。

5.2 在XML配置中引用JavaConfig

　　在XML中，我们可以使用<import >元素来拆分XML配置。