Spring 通过Java代码装配bean

1. 背景

书接上文Spring自动化装配bean

尽管在很多场景下通过组件扫描和自动装配实现Spring的自动化扫描配置是更为推荐的方式，但在有些情况下自动化扫描的方案行不通，如想要将第三方库中的组件装配到自己的应用中。在这种情况下必须通过显示 装配的方式。

显示装配有两种可选方案：Java和XML。JavaConfig是更好的方案：更强大、类型安全并对重构友好。因他就是Java代码。

2. 代码 & 解说

接口： CompactDisc.java

package soundsystem;

public interface CompactDisc {
  void play();
}

接口： MediaPlayer.java

package soundsystem;

public interface MediaPlayer {
  void play();
}

SgtPeppers.java

package soundsystem;

public class SgtPeppers implements CompactDisc {

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

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

}

注：区别与自动转配，这里去掉了@compenent注解

CDPlayer.java

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

public class CDPlayer implements MediaPlayer {
  private CompactDisc cd;

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

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

借助JavaConfig实现注入

CDPlayerConfig.java

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

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

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

注：区别与自动装配，这里去掉了@ComponentScan注解，而是显式的声明了Bean。@Bean注解告诉了Spring上下文这个方法会将返回一个对象，该对象要注册为Spring应用上下文中的bean，方法体重包含了最终产生bean实例的实现逻辑。

测试CDPlayerTest.java

package soundsystem;

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 MediaPlayer player;

  @Test
  public void play() {
    player.play();
  }
}

3. 深入了解JavaConfig

别于上面代码中的实现方式，还可以这样配置JavaConfig

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

@Configuration
public class CDPlayerConfig {
  
  @Bean
  public CompactDisc sgtPeppers() {
    return new SgtPeppers();
  }

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

cdPlayer没有使用默认的构造函数，而是调用了CompactDisc对象。看起来是通过调用sgtPeppers()得到的，实际不是这样的。原因是sgtPeppers方法是上添加了@Bean注解，Spring将会拦截所有对它的调用，而是直接返回方法所创建的bean，而不是每次都对其进行实际的调用。以下为证

@Bean
public CDPlayer() {
    return new CDPlayer(sgtPeppers());
}

@Bean
public anotherCDPlayer() {
    return new CDPlayer(sgtPeppers());
}

假如每次都调用sgtPeppers()方法，那么每个CDPlayer实例将会有一个特有的SgtPepper实例，但实际上是相同的实例。

相比于前面代码中的声明方式，还是推荐上述代码中的方式，那样更容易理解。如

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

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

这种方法不用明确引用@Bean方法也能将CompactDisc注入到CDPlayer的构造器中。这种方式是引用其他bean的最佳方式，它不需要要求将CompactDisc必须在JavaConfig中声明。