使用annotation减少spring bean的配置

使用annotaion定义一个bean
@Component 是一个通用注解，用于说明一个类是一个spring容器管理的类。
除此之外，还有@Controller , @Service , @Repository 是@Component的细化，这三个注解比@Component带有更多的语义，它们分别对应了表现层、服务层、持久层的类。
如果你只是用它们定义bean，你可以仅使用@Component，但是既然spring提供这些细化的注解，那肯定有使用它们的好处，不过在以下的例子中体现不出。

定义了一个接口

1. package test1;
3. interface  MovieFinder {
4.     String getData();
5. }

定义一个实现

1. package test1;
3. import org.springframework.stereotype.Repository;
5. @Repository
6. public   class  JpaMovieFinder implements MovieFinder {
8.     @Override
9.      public  String getData() {
10.          return   "This is JpaMovieFinder implementation!" ;
11.     }
13. }

这里使用了注解@Repository，说明这是一个受spring容器管理的bean定义，这个注解没有指定bean的名字，默认为小写开头的类名，就是jpaMovieFinder，如果你要指定名字，可以这样写@Repository("myMovieFinder")。
这里也可以使用＠Component这个注解，在这里例子中体现不出用@Repository的好处。
这里没有指定这个bean的scope，缺省是singleton，如果你要其他scope，可以使用注解@Scope

1. @Scope( "prototype" )
2. @Repository
3. public   class  MovieFinderImpl implements MovieFinder {
4.      // ...
5. }

spring扫描并注册注解的bean
JpaMovieFinder只是添加了一个注解，这并不会自动被注册到spring容器中，我们需要告诉spring容器到那里去寻找这些bean。
配置如下：

1. <?xml version= "1.0"  encoding= "UTF-8" ?>
2. <beans xmlns= "http://www.springframework.org/schema/beans"
3.        xmlns:xsi= "http://www.w3.org/2001/XMLSchema-instance"
4.        xmlns:context= "http://www.springframework.org/schema/context"
5.        xsi:schemaLocation="http: //www.springframework.org/schema/beans 
6.            http: //www.springframework.org/schema/beans/spring-beans-2.5.xsd
7.            http: //www.springframework.org/schema/context
8.            http: //www.springframework.org/schema/context/spring-context-2.5.xsd">
9.                
10.      <context:component-scan  base -package= "test1" />
11.      
12. </beans>

<context:component-scan  base -package= "test1" />这个配置告诉spring容器到test1这个package下去扫描所有的类，从而找到被注解的类。
由于并不是test1下的所有的类都有注解，全部遍历效率不高，所以spring定义了过滤器用于减小扫描范围，这里为了简单起见没有使用。

使用注解进行依赖注入

1. package test1;
2. 
   
3. import org.springframework.beans.factory.annotation.Autowired;
4. import org.springframework.stereotype.Service;
5. 
   
6. @Service
7. public   class  SimpleMovieLister {
8.     
9.     ＠Autowired
10.      private  MovieFinder movieFinder;
11. 
    
12.      public  String getData(String name) {
13.          return   "Hi "  + name +  "! "  + movieFinder.getData();
14.     }
15.     
16.      public  MovieFinder getMovieFinder() {
17.          return  movieFinder;
18.     }
19. 
    
20.      public   void  setMovieFinder(MovieFinder movieFinder) {
21.          this .movieFinder = movieFinder;
22.     }
23. }

SimpleMovieLister是一个服务类，它也使用了＠Service注解为了bean，这个类用到了MovieFinder，为了注入这个类的实现，这里使用了注解@Autowired ，spring容器会自动找到合适的bean注入进去。注意这里并没有指定被注入bean的名字，因为spring根据只发现了一个实现，那就是 jpaMovieFinder。后面，我们会看到有两个实现会怎样。

注意，上面代码使用＠Autowired时， public   void  setMovieFinder(MovieFinder movieFinder) 这个方法是不需要的，你可以把它删除了试一试。如果你使用xml的配置方式，该方法必须存在。我这里保留该方法，是为了后面测试注解和xml配置混合使用的方式。

测试1

1. package test1;
2. 
   
3. import org.springframework.context.ApplicationContext;
4. import org.springframework.context.support.ClassPathXmlApplicationContext;
5. 
   
6. public   class  Main {
7. 
   
8.      public   static   void  main(String[] args) {
9.         ApplicationContext context =  new  ClassPathXmlApplicationContext( "test1/beans.xml" );
10.         SimpleMovieLister m = (SimpleMovieLister)context.getBean( "simpleMovieLister" );
11.         System. out .println(m.getData( "Arthur" ));
12.     }
13. 
    
14. }
15. 
    

控制台上会打印 Hi Arthur! This is JpaMovieFinder implementation!

增加MovieFinder的第二个实现

1. package test1;
3. import org.springframework.stereotype.Repository;
5. @Repository
6. public   class  IbatisMovieFinder implements MovieFinder {
8.     @Override
9.      public  String getData() {
10.          return   "This is IbatisMovieFinder implementation!" ;
11.     }
13. }

这时运行Main，系统会报错：
Exception in thread "main" org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'simpleMovieLister': Injection of resource fields failed; nested exception is org.springframework.beans.factory.NoSuchBeanDefinitionException: No unique bean of type [test1.MovieFinder] is defined: expected single matching bean but found 2: [jpaMovieFinder, ibatisMovieFinder]
从错误信息中我们可以看到现在MovieFinder有两个bean实现了，一个是 jpaMovieFinder，另一个是 ibatisMovieFinder，spring容器不知道应该使用哪一个bean。这时可以使用注解 @Qualifier指定具体的bean。

1. //...
2. @Service
3. public   class  SimpleMovieLister {
4. 
   
5.     @Autowired
6.     @Qualifier( "ibatisMovieFinder" )
7.      private  MovieFinder movieFinder;
8. //...

这里我们指定注入的是 ibatisMovieFinder这个bean。
运行Main, 控制台上会打印 Hi Arthur! This is IbatisMovieFinder implementation!

Java6提供的注入注解
spring也可以使用java6提供的＠Resource注解来指定注入哪一个bean。

1. //...
2. @Service
3. public   class  SimpleMovieLister {
5.     @Resource(name= "ibatisMovieFinder" )
6.      private  MovieFinder movieFinder;
7. //...

这和@Autowired功能是一致的。

使用注解还是xml
使用注解很方便，但从上面的例子我们也可以看出注解的问题，MovieFinder有两个实现， SimpleMovieLister是在程序中用注解指定了使用哪一个实现，如果要修改，需要修改源程序。所以，注解只适用于固定依赖的情况。如果依赖需要在部署的时候做调整，那还是使用xml的配置方式方便，毕竟只需要修改一下xml文件即可。

实际使用时，我们可以xml和注解两种方式混合使用。

1. <?xml version= "1.0"  encoding= "UTF-8" ?>
2. <beans xmlns= "http://www.springframework.org/schema/beans"
3.        xmlns:xsi= "http://www.w3.org/2001/XMLSchema-instance"
4.        xmlns:context= "http://www.springframework.org/schema/context"
5.        xsi:schemaLocation="http: //www.springframework.org/schema/beans 
6.            http: //www.springframework.org/schema/beans/spring-beans-2.5.xsd
7.            http: //www.springframework.org/schema/context
8.            http: //www.springframework.org/schema/context/spring-context-2.5.xsd">
9.                
10.     <context:component-scan  base -package= "test1" />
11.     
12.     <bean id= "simpleMovieLister1"   class = "test1.SimpleMovieLister" >
13.         <property name= "movieFinder"   ref = "jpaMovieFinder"  />
14.     </bean>
15.     
16. </beans>

使用xml配置方式定义了另外一bean，注入了 jpaMovieFinder这个实现。

1. package test1;
2. 
   
3. import org.springframework.context.ApplicationContext;
4. import org.springframework.context.support.ClassPathXmlApplicationContext;
5. 
   
6. public   class  Main {
7. 
   
8.      public   static   void  main(String[] args) {
9.         ApplicationContext context =  new  ClassPathXmlApplicationContext( "test1/beans.xml" );
10.         SimpleMovieLister m = (SimpleMovieLister)context.getBean( "simpleMovieLister" );
11.         System. out .println(m.getData( "Arthur" ));
12.         SimpleMovieLister m1 = (SimpleMovieLister)context.getBean( "simpleMovieLister1" );
13.         System. out .println(m1.getData( "Arthur" ));
14.     }
15. 
    
16. }

simpleMovieLister是从注解来的， simpleMovieLister1是从xml配置来的。运行结果：
Hi Arthur! This is IbatisMovieFinder implementation!
Hi Arthur! This is JpaMovieFinder implementation!

证明混合使用是可行的，你可以继续测试，用xml重新配置 simpleMovieLister。
因此，即使我一开始使用了注解，之后我后悔了，没有关系，不用修改源程序，以前用xml怎么配置现在还是怎么配置。

评论

1 楼 朱元宇 2009-12-03  

请教 我这边使用@Autowired 的获得 serivce 进行数据库操作时候 将会发生事务不提交现象 但是我 用 getBean() 获得serivce 的时候就不会发生这个问题  所以很想了解下 getBean() 和 注释 注入 的区别 在网上一直没有找到答案