Spring-装配Bean

创建应用对象之间协作关系的行为通常称为装配（wiring），这也是依赖注入（DI）的本质。
Spring提供三种主要的装配机制：

　　　　1.在XML中进行显式配置；

　　　　2.在java中进行显式配置；

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

　　　　注：这三种机制可以自由搭配，但是建议尽可能地使用自动配置的机制，显式配置越少越好，并且尽量使用java进行配置，即使用注解的方式进行配置。

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

　　　　1.组件扫描(component scanning):Spring会自动发现上应用上下文中所创建的bean。

　　　　2.自动装配(autowiring):Spring自动满足bean之间的依赖。

　　　　注：组件扫描和自动装配组合在一起就能发挥出强大的威力，它们能够将显式配置降低到最少。

package soundSystem;
/**
 * 创建CD接口，只有一个cdInfo方法来在控制台显示CD相关信息
 * @author yan
 */
public interface CompactDisc {
    void cdInfo();
}

package soundSystem;

/**
 * CompactDisc接口的实现类，此类中定义了CD的名字和作者以及打印相关信息的方法
 * @author yan
 */
public class SgtPeppers implements CompactDisc{

    private String title="K歌之王";
    private String artist="陈奕迅";
    @Override
    public void cdInfo() {
        System.out.print("This CD's title:"+title+";artist:"+artist);
    }

}

package soundSystem;
/**
 * 定义多媒体播放器接口，包含play方法
 * @author yan
 */
public interface MediaPlayer {
    void play();
}

 1 package soundSystem;
 2 /**
 3  * 定义多媒体播放器的实现类，并使用有参构造关联了CompactDisc接口，重写了play方法
 4  * @author yan
 5  */
 6 public class CDPlayer implements MediaPlayer{
 7 
 8     private CompactDisc cd;
 9     
10     public CDPlayer(CompactDisc cd) {
11         super();
12         this.cd = cd;
13     }
14     public void setCd(CompactDisc cd) {
15         this.cd = cd;
16     }
17     @Override
18     public void play() {
19         System.out.print("Info of CD playing :");        
20         cd.cdInfo();
21     }
22 
23 }

以上四段代码仅仅列举出了CD和播放器的接口、实现类以及它们之间的依赖关系，比如，CDPlayer的构造方法中传入了CD类型的参数。

Spring如何实现依赖注入呢？我们以隐式配置为例：

　　首先，在同一包下（soundSystem）创建配置类CDPlayerConfig，效果如下

 1 package soundSystem;
 2 
 3 import org.springframework.context.annotation.ComponentScan;
 4 import org.springframework.context.annotation.Configuration;
 5 
 6 @Configuration
 7 @ComponentScan//如果此处不加任何参数，默认扫描与配置类相同的包
 8 //@ComponentScan("soundSystem")//指定单独的包，这个包内主要放置bean配置
 9 //@ComponentScan(basePackages={"soundSystem","video"})//允许指定多个包，但是，这种用字符串表示的包不安全，可以尝试使用class方式
10 //@ComponentScan(basePackageClasses={CompactDisc.class,SgrPeppers.class})
11 public class CDPlayerConfig {}

@Configuration表明这是一个配置类，@ComponentScan表示自动扫描，其不同用法见代码注释。

此时，只是扫描包，但并无作用，因为没有相关标志表明它是扫描的目标，即所要生成的bean，而Spring之所以存在是因为解耦和，即不用传统方法来new一个新的实例，因此在实现类中使用@Component标明，即可达到效果，代码如下：

package soundSystem;

import org.springframework.stereotype.Component;
/**
 * CompactDisc接口的实现类，此类中定义了CD的名字和作者以及打印相关信息的方法
 * @author yan
 */
@Component("compactd")//用于扫描来生成bean，并且提供了初始化所用的值
public class SgtPeppers implements CompactDisc{

    private String title="K歌之王";
    private String artist="陈奕迅";
    @Override
    public void cdInfo() {
        System.out.print("This CD's title:"+title+";artist:"+artist);
    }

}

Component不加参数时，默认id为第一个字母小写的类名：sgtPeppers，有参数则id为参数。

注：这里CompactDisc是独立存在的，不依赖任何其他类的，因此不需要装配，对于MediaPlayer则需要，因为其实现类中明确定义了CompactDisc类型的有参构造方法，所以，仍然需要标明依赖关系，使用@AutoWired可以达到目的，代码如下：

 1 package soundSystem;
 2 
 3 import org.springframework.beans.factory.annotation.Autowired;
 4 import org.springframework.stereotype.Component;
 5 /**
 6  * 定义多媒体播放器的实现类，并使用有参构造关联了CompactDisc接口，重写了play方法
 7  * @author yan
 8  */
 9 @Component
10 public class CDPlayer implements MediaPlayer{
11     private CompactDisc cd;
12     @Autowired
13     public CDPlayer(CompactDisc cd) {
14         super();
15         this.cd = cd;
16     }
17     @Override
18     public void play() {
19         System.out.print("Info of CD playing :");        
20         cd.cdInfo();
21     }
22 
23 }

这表明不但创造了一个叫cDPlayer的bean，而且还在bean中引用（或者说自动装配）了名叫compactd的bean为参数。

注意：此处使用的自动装配的对象是有参构造方法，而Spring还提供了Setter方法的自动装配方式，用法与此相同。

package soundSystem;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;
/**
 * 定义多媒体播放器的实现类，并使用有参构造关联了CompactDisc接口，重写了play方法
 * @author yan
 */
@Component
public class CDPlayer implements MediaPlayer{
    private CompactDisc cd;
    
    public CDPlayer(CompactDisc cd) {
        super();
        this.cd = cd;
    }
    @Autowired
    public void setCd(CompactDisc cd) {
        this.cd = cd;
    }
    @Override
    public void play() {
        System.out.print("Info of CD playing :");        
        cd.cdInfo();
    }

}

写一个测试类CDPlayerTest：

 1 package soundSystem;
 2 
 3 import static org.junit.Assert.*;
 4 
 5 import org.junit.Rule;
 6 import org.junit.Test;
 7 import org.junit.contrib.java.lang.system.StandardOutputStreamLog;
 8 import org.junit.runner.RunWith;
 9 import org.springframework.beans.factory.annotation.Autowired;
10 import org.springframework.test.context.ContextConfiguration;
11 import org.springframework.test.context.junit4.SpringJUnit4ClassRunner;
12 @RunWith(SpringJUnit4ClassRunner.class)
13 @ContextConfiguration(classes=CDPlayerConfig.class)
14 public class CDPlayerTest {
15     
16     @Rule
17     public final StandardOutputStreamLog log=new StandardOutputStreamLog();//需要引入system-rules-1.3.0.jar
18     
19     @Autowired
20     private MediaPlayer player;
21     
22     @Autowired
23     private CompactDisc cd;
24     
25     @Test
26     public void cdShouldNotBeNull() {
27         assertNotNull(cd);//如果测试正常，说名cd已被初始化，Spring依赖注入有效发挥作用了
28     }
29     
30     @Test
31     public void play(){
32         player.play();
33         assertEquals("Info of CD playing :This CD's title:K歌之王;artist:陈奕迅", log.getLog());
34     }
35 }

需要注意的是，在声明MediaPlayer和CompactDisc时，需要加上自动装配的标志@Autowired，否则无法通过测试。

此时我们使用扫描的方式实现依赖注入的，也可以不用扫描（将@ComponentScan注释掉，保留@AutoWired），直接在javaConfig中定义bean

 1 package soundSystem;
 2 
 3 import org.springframework.context.annotation.Bean;
 4 //import org.springframework.context.annotation.ComponentScan;
 5 import org.springframework.context.annotation.Configuration;
 6 
 7 @Configuration
 8 //@ComponentScan//如果此处不加任何参数，默认扫描与配置类相同的包
 9 //@ComponentScan("soundSystem")//指定单独的包，这个包内主要放置bean配置
10 //@ComponentScan(basePackages={"soundSystem","video"})//允许指定多个包，但是，这种用字符串表示的包不安全，可以尝试使用class方式
11 //@ComponentScan(basePackageClasses={CompactDisc.class,SgrPeppers.class})
12 public class CDPlayerConfig {
13 @Bean
14     public CompactDisc sgtPeppers(){
15     return new SgtPeppers();
16 }
17 @Bean
18     public CDPlayer cdPlayer(){
19         return new CDPlayer(sgtPeppers());
20 }
21 }

此时bean缺省id为方法名，也可以自定义（name="***"）。

之所以建议多用javaConfig方式而不是xml方式，主要原因：javaConfig更为强大、类型安全并且对重构友好，因为它就是java代码，就像应用程序中的其他Java代码一样。因此我们可以发挥java提供的所有功能，只要最终得到一个所需实例即可。--《Spring实战》中举例为：定义多个同为CD实现类的bean，然后可以通过生产随机数和if判断来控制CDPlayer随机播放。

以上是使用javaConfig或说注解的方式来实现bean的创建和管理，下面看看XML方式的配置，因为我们已经写了注解，所以直接删除javaConfig类，然后在根目录下创建一个xml文件applicationContext.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:p="http://www.springframework.org/schema/p"
    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
    ">

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

这样就实现了和javaConfig类同样的功能。如果删除注解，只用xml来管理则可配置如下：

 1 <?xml version="1.0" encoding="UTF-8"?>
 2 <beans
 3     xmlns="http://www.springframework.org/schema/beans"
 4     xmlns:c="http://www.springframework.org/schema/c"
 5     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 6     xmlns:p="http://www.springframework.org/schema/p"
 7     xmlns:context="http://www.springframework.org/schema/context"
 8     xsi:schemaLocation="http://www.springframework.org/schema/beans 
 9     http://www.springframework.org/schema/beans/spring-beans.xsd
10     http://www.springframework.org/schema/context 
11     http://www.springframework.org/schema/context/spring-context.xsd
12     ">
13     <bean id="compactd" class="soundSystem.SgtPeppers"/>
14 　　<bean id="cDPlayer" class="soundSystem.CDPlayer" >
15 　　　　<constructor-arg ref="compactd"></constructor-arg>
16 　　</bean>
17 </beans>

同时在jUnit测试中将@ContextConfiguration(classes=CDPlayerConfig.class)改为：@ContextConfiguration(locations="/applicationContext.xml")即可实现同样的效果。

此时我们使用引用的方式将id为compactd的bean引为cDPlayer的构造方法的参数，而compactd的初始值是在java文件中定义的，那么如何通过xml文件来定义初始值呢？

首先我们删除java文件SgtPeppers.java（CompactDisc接口的实现类）中的属性赋值，即只定义title和artist，并且补充set方法即可，xml中可配置如下：

1     <bean id="compactd" class="soundSystem.SgtPeppers">
2         <property name="title" value="K歌之王"></property>
3         <property name="artist" value="陈奕迅"></property>
4     </bean>

这样也可以通过测试。

其实我们这里是用了setter注入方式，它对应的是（默认的）无参构造，所以会出现一种疏忽，即类中有有参构造而忘了写无参构造时，使用setter注入会报错。

言归正传，在xml中，还可以将其调整为构造器注入，并赋予初始值，仍然以compactd举例：

首先在SgtPeppers.java中补充有参构造方法：

1     public SgtPeppers(String title, String artist) {
2         super();
3         this.title = title;
4         this.artist = artist;
5     }

修改bean为：

    <bean id="compactd" class="soundSystem.SgtPeppers">
        <constructor-arg value="K歌之王"></constructor-arg>
        <constructor-arg value="陈奕迅"></constructor-arg><!-- 
        <property name="title" value="K歌之王"></property>
        <property name="artist" value="陈奕迅"></property> -->
    </bean>

这里的参数顺序必须与定义参数的顺序一致，否则会错，这样不够灵活，不安全，我们可以通过name属性来定义属性名而不受顺序的限制：

1 <bean id="compactd" class="soundSystem.SgtPeppers">
2         <constructor-arg name="artist"  value="陈奕迅"></constructor-arg>
3         <constructor-arg name="title" value="K歌之王"></constructor-arg><!-- 
4         <property name="title" value="K歌之王"></property>
5         <property name="artist" value="陈奕迅"></property> -->
6     </bean>

另外还有c-命名方式，此处不赘述。

下面看看bean中如何放置集合：

先写一个含有集合参数的类：

 1 package soundSystem.collections;
 2 
 3 import java.util.List;
 4 
 5 import soundSystem.CompactDisc;
 6 
 7 public class BlankDisc implements CompactDisc{
 8     private String title;
 9     private String artist;
10     private List<String> tracks;
11     /**
12      * setter方法，对应无参构造，是唯一的，
13      * 如果有有参构造而没明确标明无参构造，则此处使用setter注入会报错
14      * @param title
15      */
16     public void setTitle(String title) {
17         this.title = title;
18     }
19     public void setArtist(String artist) {
20         this.artist = artist;
21     }
22     
23     /********************************************************
24      * 有参构造，不唯一，可以是数量不唯一，也可以是参数类型不唯一，
25      * 但为保证能够自动装配，此处只定义一种
26      ********************************************************/
27     public BlankDisc(String title, String artist, List<String> tracks) {
28         super();
29         this.title = title;
30         this.artist = artist;
31         this.tracks = tracks;
32     }
33     /*重写接口中的方法*/
34     @Override
35     public void cdInfo() {
36         System.out.print("This CD's title:"+title+";artist:"+artist+";tracks:"+tracks);
37     }
38 
39 }

此类继承CompactDisc接口，并定义了List类型的参数tracks，那么在applicationContext.xml中如何配置：

 1 　　<bean id="compactd" class="soundSystem.collections.BlankDisc">
 2         <constructor-arg name="artist"  value="陈奕迅"></constructor-arg>
 3         <constructor-arg name="title" value="K歌之王"></constructor-arg>
 4         <constructor-arg name="tracks">
 5             <list>
 6                 <value>1</value>
 7                 <value>2</value>
 8                 <value>3</value>
 9             </list>
10         </constructor-arg>
11     </bean>

当然，list子元素中还可以使用ref，如

1             <list>
2                 <ref bean="#ID1"/>
3                 <ref bean="#ID2"/>
4                 <ref bean="#ID3"/>
5             </list>

当参数类型是List时，我们可以用<list>,同样也可以使用<set>，区别与list和set的区别相同，即不保证顺序，去掉重复值。

另外一种方法是将list直接放在另外一个bean中，然后在构造参数中引用即可，这里涉及到util:list，需要现在头部文件中加入声明：

 1 　　<beans
 2     xmlns="http://www.springframework.org/schema/beans"
 3     xmlns:c="http://www.springframework.org/schema/c"
 4     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 5     xmlns:p="http://www.springframework.org/schema/p"
 6     xmlns:context="http://www.springframework.org/schema/context"
 7     xmlns:util="http://www.springframework.org/schema/util"
 8     xsi:schemaLocation="http://www.springframework.org/schema/beans 
 9     http://www.springframework.org/schema/beans/spring-beans.xsd
10     http://www.springframework.org/schema/context 
11     http://www.springframework.org/schema/context/spring-context.xsd
12     http://www.springframework.org/schema/util 
13     http://www.springframework.org/schema/util/spring-util.xsd
14     ">

第7，12，13行中已声明，配置bean如下：

 1 　　<util:list id="ul">
 2         <value>1</value>
 3         <value>2</value>
 4         <value>3</value>
 5     </util:list>
 6      <bean id="compactd" class="soundSystem.collections.BlankDisc">
 7         <constructor-arg name="artist"  value="陈奕迅"></constructor-arg>
 8         <constructor-arg name="title" value="K歌之王"></constructor-arg>
 9         <constructor-arg name="tracks">
10                 <ref bean="ul"/>
11         </constructor-arg>
12     </bean>

这样就可以起到同样的作用了。

posted @ 2016-10-22 20:37 舒山阅读(594) 评论(0) 编辑收藏举报

刷新页面返回顶部

舒山

人到万难须放胆，事当两可要平心。

Spring-装配Bean

公告