Spring 3.0 注解详解

在Spring2.5中已经可以用注解的方式去驱动Spring的依赖注入了。使用注解需要JDK1.5+ API才支持。注解和Java代码位于同一个java文件中,而XML配置采用独立的配置文件,大多数配置信息在程序开发完成后都不会调整,如果配置信息和Java代码放在一起,有助于增强程序的内聚性。而采用独立的XML配置文件,程序员在编写一个功能时,往往需要在程序文件和配置文件中不停切换,这种思维上的不连贯会降低开发效率。而且XML配置文件在项目大的时候不易管理。

在Spring2.5中已经可以用注解的方式去驱动Spring的依赖注入了。使用注解需要JDK1.5+ API才支持。注解和Java代码位于同一个java文件中,而XML配置采用独立的配置文件,大多数配置信息在程序开发完成后都不会调整,如果配置信息和Java代码放在一起,有助于增强程序的内聚性。而采用独立的XML配置文件,程序员在编写一个功能时,往往需要在程序文件和配置文件中不停切换,这种思维上的不连贯会降低开发效率。而且XML配置文件在项目大的时候不易管理。

为什么要使用注解?

(1)它可以利用 Java 的反射机制获取类结构信息,这些信息可以有效减少配置的工作。如:使用@Resource注解可以轻松注入成员变量,而不需到XML配置文件中编写Setter配置项;

(2)使用注解可以提高开发效率,是配置信息和代码位于同一java文件,提高程序的内聚性。

因此在很多情况下,注解比 XML 配置更受欢迎。Spring 2.5 的一大增强就是引入了很多注解类,现在您已经可以使用注解完成大部分 XML 配置的功能。在这篇文章里,我们将向您讲述使用注释进行 Bean 定义和依赖注入的内容。

一、各种注解方式

1、@Autowired 注解(不推荐使用,建议使用@Resource)

@Autowired可以对成员变量、方法和构造函数进行标注,来完成自动装配的工作。@Autowired的标注位置不同,它们都会在Spring在初始化这个bean时,自动装配这个属性。要使@Autowired能够工作,还需要在配置文件中加入以下

<bean class="org.springframework.beans.factory.annotation.AutowiredAnnotationBeanPostProcessor" />

2、@Qualifier 注解

@Autowired是根据类型进行自动装配的。例如,如果当Spring上下文中存在不止一个UserDao类型的bean时,就会抛出BeanCreationException异常;如果Spring上下文中不存在UserDao类型的bean,也会抛出BeanCreationException异常。我们可以使用@Qualifier配合@Autowired来解决这些问题。如下:

1) 可能存在多个UserDao实例

@Autowired
@Qualifier("userServiceImpl")         
public IUserService userService;

或者

@Autowired       
public void setUserDao(@Qualifier("userDao") UserDao userDao) {
            this.userDao = userDao;        
}

这样,Spring会找到id为userServiceImpl和userDao的bean进行装配。

2) 可能不存在UserDao实例

@Autowired(required = false)        
public IUserService userService;

3、@Resource 注解

JSR-250标准注解,推荐使用它来代替Spring专有的@Autowired注解。@Resource的作用相当于@Autowired,只不过@Autowired按byType自动注入,而@Resource默认按byName自动注入罢了。@Resource有两个属性是比较重要的,分别是name和type,Spring将 @Resource注解的name属性解析为bean的名字,而type属性则解析为bean的类型。所以如果使用name属性,则使用byName的自动注入策略,而使用type属性时则使用byType自动注入策略。如果既不指定name也不指定type属性,这时将通过反射机制使用byName自动注入策略。要使@Autowired能够工作,还需要在配置文件中加入以下:

<bean class="org.springframework.context.annotation.CommonAnnotationBeanPostProcessor" />

@Resource装配顺序:

a、如果同时指定了name和type,则从Spring上下文中找到唯一匹配的bean进行装配,找不到则抛出异常

b、如果指定了name,则从上下文中查找名称(id)匹配的bean进行装配,找不到则抛出异常

c、如果指定了type,则从上下文中找到类型匹配的唯一bean进行装配,找不到或者找到多个,都会抛出异常

d、如果既没有指定name,又没有指定type,则自动按照byName方式进行装配(见2);如果没有匹配,则回退为一个原始类型(UserDao)进行匹配,如果匹配则自动装配;

4、@PostConstruct(JSR-250) 注解

在方法上加上注解@PostConstruct,这个方法就会在Bean初始化之后被Spring容器执行(注:Bean初始化包括,实例化Bean,并装配Bean的属性(依赖注入))。它的一个典型的应用场景是,当你需要往Bean里注入一个其父类中定义的属性,而你又无法复写父类的属性或属性的setter方法时,如:

public class UserDaoImpl extends HibernateDaoSupport implements UserDao {                
    private SessionFactory mySessionFacotry;                
    @Resource        
    public void setMySessionFacotry(SessionFactory sessionFacotry)  {                
        this.mySessionFacotry = sessionFacotry;            
    }                
    @PostConstruct           
    public void injectSessionFactory() {                
        super.setSessionFactory(mySessionFacotry);           
    }     
}

这里通过@PostConstruct,为UserDaoImpl的父类里定义的一个sessionFactory私有属性,注入了我们自己定义的 sessionFactory(父类的setSessionFactory方法为final,不可复写),之后我们就可以通过调用 super.getSessionFactory()来访问该属性了。

5、@PreDestroy(JSR-250) 注解

在方法上加上注解@PreDestroy,这个方法就会在Bean初始化之后被Spring容器执行。其用法同@PostConstruct。和@PostConstruct 区别在于:@PostConstruct注释的方法将在类实例化后调用,而标注了 @PreDestroy 的方法将在类销毁之前调用。

6、@Component 注解 (不推荐使用)

只需要在对应的类上加上一个@Component注解,就将该类定义为一个Bean了。Spring还提供了更加细化的注解形式:@Repository、@Service、@Controller,它们分别对应存储层Bean,业务层Bean,和展示层Bean。目前版本(2.5)中,这些注解与@Component的语义是一样的,完全通用,在Spring以后的版本中可能会给它们追加更多的语义。所以,我们推荐使用@Repository、@Service、@Controller来替代@Component。

7、@Scope 注解

在使用XML定义Bean时,我们可能还需要通过bean的scope属性来定义一个Bean的作用范围,我们同样可以通过@Scope注解来完成这项工作:

@Scope("session")        
@Component()        
public class UserSessionBean implements Serializable{ 
      ... ...     
}

二、配置启用注解 (注意以下配置需要使用spring2.5的头文件,在spring3.0中不适用)

1、使用简化配置

Spring2.1添加了一个新的context的Schema命名空间,该命名空间对注释驱动、属性文件引入、加载期织入等功能提供了便捷的配置。我们知道注释本身是不会做任何事情的,它仅提供元数据信息。要使元数据信息真正起作用,必须让负责处理这些元数据的处理器工作起来。

AutowiredAnnotationBeanPostProcessor和CommonAnnotationBeanPostProcessor就是处理这些注释元数据的处理器。但是直接在Spring配置文件中定义这些Bean显得比较笨拙。Spring为我们提供了一种方便的注册这些BeanPostProcessor的方式,这就是,以下是spring的配置。

<beans xmlns="https://www.springframework.org/schema/beans" 
    xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" 
    xmlns:context="https://www.springframework.org/schema/context"           
    xsi:schemaLocation="https://www.springframework.org/schema/beans           
         https://www.springframework.org/schema/beans/spring-beans-2.5.xsd            
         https://www.springframework.org/schema/context            
         https://www.springframework.org/schema/context/spring-context-2.5.xsd">            
     <context:annotation-config />       
 </ beans>

将隐式地向Spring容器注册了

AutowiredAnnotationBeanPostProcessor 、

CommonAnnotationBeanPostProcessor 、

PersistenceAnnotationBeanPostProcessor

RequiredAnnotationBeanPostProcessor

这4个BeanPostProcessor。

2、使用让Bean定义注解工作起来

<beans xmlns="https://www.springframework.org/schema/beans" 
    xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" 
    xmlns:context="https://www.springframework.org/schema/context"           
    xsi:schemaLocation="https://www.springframework.org/schema/beans            
        https://www.springframework.org/schema/beans/spring-beans-2.5.xsd            
        https://www.springframework.org/schema/context            
        https://www.springframework.org/schema/context/spring-context-2.5.xsd">            
    <context:component-scan base-package="com.kedacom.ksoa" />        
</beans>

这里,所有通过元素定义Bean的配置内容已经被移除,仅需要添加一行配置就解决所有问题了——Spring XML配置文件得到了极致的简化(当然配置元数据还是需要的,只不过以注释形式存在罢了)。的base-package属性指定了需要扫描的类包,类包及其递归子包中所有的类都会被处理。

还允许定义过滤器将基包下的某些类纳入或排除。Spring支持以下4种类型的过滤方式:

(1)注解方式,如:org.example.SomeAnnotation 将所有使用SomeAnnotation注解的类过滤出来

(2)指定类名方式,如: org.example.SomeClass 过滤指定的SomeClass类

(3)正则表达式,如:com\.kedacom\.spring\.annotation\.web\..*

(4)AspectJ表达式,如:org.example..*Service+

以正则表达式为例,我列举一个应用实例:

<context:component-scan base-package="com.casheen.spring.annotation">            
    <context:exclude-filter type="regex" expression="com\.casheen\.spring\.annotation\.web\..*" />        
</context:component-scan>

值得注意的是配置项不但启用了对类包进行扫描以实施注释驱动Bean定义的功能,同时还启用了注释驱动自动注入的功能(即还隐式地在内部注册了AutowiredAnnotationBeanPostProcessor和CommonAnnotationBeanPostProcessor),因此当使用后,就可以将移除了。

3、不开启事务和EJB
上面的配置项是不支持Spring的@Transcation和EJB的。Spring的@Transactional或者EJB3的@TransactionAttribute注解,需要使用特定的配置去开启。因此,上面的配置还是不能够使用这两个注解;

4、使用@Scope来定义Bean的作用范围

在使用XML定义Bean时,我们可能还需要通过bean的scope属性来定义一个Bean的作用范围,我们同样可以通过@Scope注解来完成这项工作:

@Scope("session")           
@Component()            
public class UserSessionBean implements Serializable {
                ...          
 }
尺有所短;寸有所长。物有所不足;智有所不明。——屈原《卜居》
0 不喜欢
说说我的看法 -
全部评论(
没有评论
关于
本网站属于个人的非赢利性网站,转载的文章遵循原作者的版权声明,如果原文没有版权声明,请来信告知:hxstrive@outlook.com
公众号