Spring Annotation Facility

JDK 在1.5之后加入了Annotation功能,同时Spring到2.5版本后,基本上开发人员也可以不再使用XML文件来配置bean了,都是使用Annotation来声明一个bean,因此,本节对Spring的Annotation做一个简单总结。

        @Autowired(spring)

        @Autowired可以对成员变量、方法和构造函数进行标注,来完成自动装配的工作。推荐使用@Resource来代替Spring专有的@Autowired注解。例如:

//类的实现1--对成员变量进行标注:
public class UserServiceImpl implements IUserService {

    @Autowired  
    private UserDao userDao;
    ……
}

//类的实现2--对方法进行标注:
public class UserServiceImpl implements IUserService {

    private UserDao userDao;

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

}

配置文件:

<bean id="userService" class="com.basis.system.core.user.service.UserServiceImpl">
</bean>

<bean id="userDao" class="com.basis.system.core.user.dao.UserDao">
   <property name="sessionFactory" ref="sessionFactory" />
</bean>


<!--要使@Autowired能够工作,还需要在配置文件中加入以下代码:-->
<bean class="org.springframework.beans.factory.annotation.AutowiredAnnotationBeanPostProcessor" />

以上两种不同实现方式中,@Autowired的标注位置不同,它们都会在Spring初始化userServiceImpl这个bean时,自动装配userDao这个属性,区别是:
        第一种实现中,Spring会直接将UserDao类型的唯一一个bean赋值给userDao这个成员变量;
        第二种实现中,Spring会调用setUserDao方法来将UserDao类型的唯一一个bean装配到userDao这个属性。

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

//1) 可能存在多个UserDao实例
    @Autowired
    public void setUserDao(@Qualifier("userDao") UserDao userDao) {
       this.userDao = userDao;
    }
//这样,Spring会找到id为userDao的bean进行装配。

//2) 可能不存在UserDao实例
    @Autowired(required = false)
    public void setUserDao(UserDao userDao) {
       this.userDao = userDao;
    }

       

        @Resource(JSR-250)

@Resource 是JSR-250标准注解,推荐使用它来代替Spring专有的@Autowired注解

Spring 不但支持自己定义的@Autowired注解,还支持几个由JSR-250规范定义的注解,它们分别是@Resource、@PostConstruct以及@PreDestroy。
        @Resource的作用相当于@Autowired,只不过@Autowired按byType自动注入,而@Resource默认按byName自动注入罢了。@Resource有两个属性是比较重要的,分别是name和type,Spring将@Resource注解的name属性解析为bean的名字,而type属性则解析为bean的类型。所以如果使用name属性,则使用byName的自动注入策略,而使用type属性时则使用byType自动注入策略。如果既不指定name也不指定type属性,这时将通过反射机制使用byName自动注入策略。

1) @Resource装配顺序

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

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

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

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

        @PostConstruct(JSR-250)

在方法上加上注解@PostConstruct,这个方法就会在Bean初始化之后被Spring容器执行(注:Bean初始化包括,实例化Bean,并装配Bean的属性(依赖注入))。

它的一个典型的应用场景是,当你需要往Bean里注入一个其父类中定义的属性,而你又无法复写父类的属性或属性的setter方法时,如:

@Repository("logDao")
public class LogDao extends HibernateDaoSupport{

    @Resource
    private SessionFactory sessionFactory;
    /** 
     * 类初始化时初始化父类的session工厂 
     * */
    @PostConstruct
    void injectSessionFactory() {
       super.setSessionFactory(sessionFactory);
    }
    
    public void addLog(Log log) {
       this.getHibernateTemplate().save(log);
    }
}

        @PreDestroy(JSR-250)

在方法上加上注解@PreDestroy,这个方法就会在Bean初始化之后被Spring容器执行。由于我们当前还没有需要用到它的场景,这里不去演示。其用法同@PostConstruct。

@Qualifier(spring)
        当Spring上下文中存在不止一个UserDao类型的bean时,就会抛出BeanCreationException异常;如果Spring上下文中不存在UserDao类型的bean,也会抛出BeanCreationException异常。我们可以使用@Qualifier配合@Autowired来解决这些问题。参考上面例子。

@Required(spring)

@Required 负责检查一个bean在初始化时其声明的 set方法是否被执行, 当某个被标注了 @Required 的 Setter 方法没有被调用,则 Spring 在解析的时候会抛出异常,以提醒开发者对相应属性进行设置。 @Required 注解只能标注在 Setter 方法之上。因为依赖注入的本质是检查 Setter 方法是否被调用了,而不是真的去检查属性是否赋值了以及赋了什么样的值。如果将该注解标注在非 setXxxx() 类型的方法则被忽略。它的作用等同于在配置文件中使用dependency-check来进行DI检查。

使用这个功能需要在配置文件中定义Bean:
<bean id="requiredChecker" class="rog.springframework.beans.factory.annotation.RequiredAnnotationBeanPostProcessor"/>

@Inject & @Named(JSR 330)

Instead of @Autowired, javax.inject.Inject may be used as follows:

import javax.inject.Inject;
  public class SimpleMovieLister {

  private MovieFinder movieFinder;

  @Inject
  public void setMovieFinder(MovieFinder movieFinder) {
      this.movieFinder = movieFinder;
  }
  // ...
 }

As for @Autowired, it is possible to use @Inject at the class-level, field-level, method-level and constructor-argument level. If you would like to use a qualified name for the dependency that should be injected, you should use the @Named annotation as follows:

import javax.inject.Inject;
  import javax.inject.Named;
  
  public class SimpleMovieLister {

  private MovieFinder movieFinder;

  @Inject
  public void setMovieFinder(@Named("main") MovieFinder movieFinder) {
      this.movieFinder = movieFinder;
  }
  // ...
}

@Named(JSR 330)

a standard equivalent to the @Component annotation

import javax.inject.Inject;
  import javax.inject.Named;
  
  @Named("movieListener")
  public class SimpleMovieLister {

  private MovieFinder movieFinder;

  @Inject
  public void setMovieFinder(MovieFinder movieFinder) {
      this.movieFinder = movieFinder;
  }
  // ...
}

使用Spring注解完成Bean的定义


        @Component   (不推荐使用)、@Repository、@Service、@Controller

@Component
@Scope("prototype")
public class UserAction extends BaseAction implements ModelDriven<User>{

}

使用@Component注解定义的Bean,默认的名称(id)是小写开头的非限定类名。如这里定义的Bean名称就是userDaoImpl。你也可以指定Bean的名称:

@Component("userDao")

@Component是所有受Spring管理组件的通用形式,Spring还提供了更加细化的注解形式:

@Repository、@Service、@Controller,它们分别对应持久化层Bean,业务层Bean,和展示层Bean。

版本(2.5)中,这些注解与@Component的语义是一样的,完全通用,在Spring以后的版本中可能会给它们追加更多的语义。所以,我们推荐使用@Repository、@Service、@Controller来替代@Component。

 

@Scope

定义Bean的作用范围


使用<context:component-scan />让Bean定义注解工作起来

<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-2.5.xsd
              http://www.springframework.org/schema/context
              http://www.springframework.org/schema/context/spring-context-2.5.xsd">

              <context:component-scan base-package="com.citi.crc" />

          </beans>


使用<context:annotation-config />简化配置

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

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

<context:annotationconfig />将隐式地向Spring容器注册:

AutowiredAnnotationBeanPostProcessor、

CommonAnnotationBeanPostProcessor、

PersistenceAnnotationBeanPostProcessor、

RequiredAnnotationBeanPostProcessor

这4个BeanPostProcessor。

<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-2.5.xsd
                http://www.springframework.org/schema/context
                http://www.springframework.org/schema/context/spring-context-2.5.xsd">

                <context:annotation-config />
          </beans>

Spring annotations vs standard annotations

Spring javax.inject.* javax.inject restrictions / comments
@Autowired @Inject @Inject has no 'required' attribute
@Component @Named  
@Scope("singleton") @Singleton

jsr-330 default scope is like Spring's prototype. However, in order to keep it consistent with Spring's general defaults, a jsr-330 bean declared in the Spring container is a singleton by default. In order to use another scope than singleton, you should use Spring's @Scope annotation.

javax.inject also provides a @Scope annotation. Nevertheless, this one only aims to be used for creating your own annotations.

@Qualifier @Named  
@Value - no equivalent
@Required - no equivalent
@Lazy -no equivalent

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值