spring 注解

1.1：各种注解

@SuppressWarnings("restriction")

指示应该在注释元素（以及包含在该注释元素中的所有程序元素）中取消显示指定的编译器警告。

 

@SuppressWarnings 批注允许您选择性地取消特定代码段（即，类或方法）中的警告。其中的想法是当您看到警告时，您将调查它，如果您确定它不是问题，您就可以添加一个 @SuppressWarnings 批注，以使您不会再看到警告。虽然它听起来似乎会屏蔽潜在的错误，但实际上它将提高代码安全性，因为它将防止您对警告无动于衷 — 您看到的每一个警告都将值得注意。

 

@SuppressWarnings("serial")

关闭黄色的警告

 

@SuppressWarnings("rawtypes")

SuppressWarnings压制警告，即去除警告 rawtypes是说传参时也要传递带泛型的参数

关键字 用途

 deprecation 使用了不赞成使用的类或方法时的警告 unchecked 执行了未检查的转换时的警告，例如当使用集合时没有用泛型 (Generics) 来指定集合保存的类型。

 fallthrough 当 Switch 程序块直接通往下一种情况而没有 Break 时的警告。

 path 在类路径、源文件路径等中有不存在的路径时的警告。

 serial 当在可序列化的类上缺少 serialVersionUID 定义时的警告。 

finally 任何 finally 子句不能正常完成时的警告。 all 关于以上所有情况的警告。

 

@Controller

用来注解这个bean是MVC模型中的一个C 会被spring的auto-scan扫到纳入管理

 

@Scope("prototype")

当我们在一个ACTION类里面写很多个方法的时候（其实是一种按功能划分模块编程的思想），每个方法的返回状态可能不一样，如果ACTION中不@Scope("prototype")，有可能报找不到XXXACTION的错误！写上这个就表示每次请求都重新创建一个ACTION，与SINGALON对应，俗称“多例”。

 

@Service用于标注业务层组件

@Controller用于标注控制层组件（如struts中的action）

@Repository用于标注数据访问组件，即DAO组件

@Component泛指组件，当组件不好归类的时候，我们可以使用这个注解进行标注。

@Transactional

声明需要事务管理

@Autowired 注释

将 @Autowired 注释标注在成员变量上 

import org.springframework.beans.factory.annotation.Autowired;
public class Boss {
    @Autowired
    private Car car;
    @Autowired
    private Office office;
    …
}

 它可以对类成员变量、方法及构造函数进行标注，完成自动装配的工作。

Spring 通过一个 BeanPostProcessor 对 @Autowired 进行解析，所以要让 @Autowired 起作用必须事先在 Spring 容器中声明AutowiredAnnotationBeanPostProcessor Bean。

 <!-- 该 BeanPostProcessor 将自动起作用，对标注 @Autowired 的 Bean 进行自动注入 -->    

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

这样，当 Spring 容器启动时，AutowiredAnnotationBeanPostProcessor 将扫描 Spring 容器中所有 Bean，当发现 Bean 中拥有 @Autowired 注释时就找到和其匹配（默认按类型匹配）的 Bean，并注入到对应的地方中去。

按照上面的配置，Spring 将直接采用 Java 反射机制对 Boss 中的 car 和 office 这两个私有成员变量进行自动注入。

所以对成员变量使用 @Autowired 后，大可将它们的 setter 方法（setCar() 和 setOffice()）从 Boss 中删除。

当然，也可以通过 @Autowired 对方法或构造函数进行标注，来看下面的代码：

将 @Autowired 注释标注在 Setter 方法上

public class Boss {
    private Car car;
    private Office office;
     @Autowired
    public void setCar(Car car) {
        this.car = car;
    }
 
    @Autowired
    public void setOffice(Office office) {
        this.office = office;
    }
    …
}

这时，@Autowired 将查找被标注的方法的入参类型的 Bean，并调用方法自动注入这些 Bean。

将 @Autowired 注释标注在构造函数上

public class Boss {
    private Car car;
    private Office office;
 
    @Autowired
    public Boss(Car car ,Office office){
        this.car = car;
        this.office = office ;
    }

    …
}

由于 Boss() 构造函数有两个入参，分别是 car 和 office，@Autowired 将分别寻找和它们类型匹配的 Bean，将它们作为 Boss(Car car ,Office office) 的入参来创建 Boss Bean。

@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能够工作，还需要在配置文件中加入以下:

Xml代码

1. <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)进行匹配，如果匹配则自动装配;

 

@RequestParam

  一般用于将指定的请求参数付给方法中形参。示例代码如下：

        

@RequestMapping(params="method=reg5")     public String reg5(@RequestParam("name")String uname,ModelMap map) {        System.out.println("HelloController.handleRequest()");        System.out.println(uname);        return"index";     }

    这样，就会将name参数的值付给uname。当然，如果请求参数名称和形参名称保持一致，则不需要这种写法。

 

@Qualifier

当我们在 Spring 容器中配置了两个类型为 Office 类型的 Bean，当对 Boss 的 office 成员变量进行自动注入时，Spring 容器将无法确定到底要用哪一个 Bean，就会发生异常。

Spring 允许我们通过 @Qualifier 注释指定注入 Bean 的名称，这样歧义就消除了，可以通过下面的方法解决异常：

@Autowired
public void setOffice(@Qualifier("office")Office office) {
    this.office = office;
}

@Qualifier("office") 中的 office 是 Bean 的名称，所以 @Autowired 和 @Qualifier 结合使用时，自动注入的策略就从 byType 转变成 byName 了。

@Autowired 可以对成员变量、方法以及构造函数进行注释，而 @Qualifier 的标注对象是成员变量、方法入参、构造函数入参。正是由于注释对象的不同，所以 Spring 不将 @Autowired 和 @Qualifier 统一成一个注释类。

对成员变量使用 @Qualifier 注释

public class Boss {
    @Autowired
    private Car car;
    @Autowired
    @Qualifier("office")
    private Office office;
    …
}

对构造函数变量使用 @Qualifier 注释 @Qualifier 只能和 @Autowired 结合使用，是对 @Autowired 有益的补充。一般来讲，@Qualifier 对方法签名中入参进行注释会降低代码的可读性，而对成员变量注释则相对好一些。

public class Boss {
    private Car car;
    private Office office;
    @Autowired
    public Boss(Car car , @Qualifier("office")Office office){
        this.car = car;
        this.office = office ;
    }
}

@Controller

@Controller的基本目标是担任所注解的类的原型的角色，指明它的职责。Dispatcher将会在这样被注解的类中扫描映射的方法，探测注解@RequestMapping。

所注解的控制器bean可以被显式定义，这个过程是在Dispatcher的上下文中使用标准的Spring bean定义完成的。然而，@Controller原型也允许自动探测，要实现对所注解的控制器的自动探测，必须要向配置中加入组件扫描的部分。实现如下：

<beans xsi:schemaLocation="
　　http://www.springframework.org/schema/mvc
http://www.springframework.org/schema/mvc/spring-mvc-3.0.xsd
http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context-3.0.xsd">

@RequestMapping 

@RequestMapping是一种通过匹配URL路径来访问相应页面的

分类：类级别的和方法级别的

@RequestMapping的几种形式：

    @RequestMapping(method = RequestMethod.GET)
      @RequestMapping(value="/{day}", method = RequestMethod.GET)//day为方法中的参数
    @RequestMapping(value="/new", method = RequestMethod.GET)

将@RequestMapping放在类级别上这可令它与方法级别上的@RequestMapping注解协同工作，取得缩小选择范围的效果，如下：

@RequestMapping("/a")//类级别,可以不需要,如果要了,下面所有的请求路径前都需要加入  /a  
 public class ccccontroller{  
      @RequestMapping("/b")//方法级别,必须有,决定这个方法处理哪个请求,如果有类级别 /a/b
　　　 @RequestMapping(value="/b" method=RequestMethod.POST)
　　　 @RequestMapping(value="/b", method=RequestMethod.GET, params="type=checking")
　　　 @RequestMapping
       public String show()  
       {  
            //如果没有类级别的就直接请求/b  
            return;  
       }  
}  

第一个是一种简写方式，匹配路径为 “/a/b”；

第二个方法级的请求映射和类级别的映射结合，当HTTP方法是POST时与路径“/a/b”匹配；

第三个添加了一个要求，就是名为“type”的请求参数和其值“checking”都需要在请求中出现；

第四个根本就没有指定路径，这个方法匹配所有的 HTTP方法，如果有必要的话可以用它的方法名。下面改写我们的方法，使它可以依靠方法名进行匹配。

@PostConstruct(JSR-250)

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

Java代码

1. public class UserDaoImpl extends HibernateDaoSupport implements UserDao {        

2.     

3.     private SessionFactory mySessionFacotry;        

4.     

5.     @Resource    

6.     public void setMySessionFacotry(SessionFactory sessionFacotry)     

7.     {        

8.         this.mySessionFacotry = sessionFacotry;        

9.     }        

10.     

11.     @PostConstruct       

12.     public void injectSessionFactory()     

13.     {        

14.         super.setSessionFactory(mySessionFacotry);        

15.     }     

16. }  

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

@PreDestroy

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

 

1.2：配置启用注解

1.使用简化配置

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

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

Xml代码

1. <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"       

2.     xsi:schemaLocation="http://www.springframework.org/schema/beans        

3.     http://www.springframework.org/schema/beans/spring-beans-2.5.xsd        

4.     http://www.springframework.org/schema/context        

5.     http://www.springframework.org/schema/context/spring-context-2.5.xsd">        

6.     <context:annotation-config />        

7. beans>  

将隐式地向Spring容器注册了

AutowiredAnnotationBeanPostProcessor 、

CommonAnnotationBeanPostProcessor 、

PersistenceAnnotationBeanPostProcessor

RequiredAnnotationBeanPostProcessor

这4个BeanPostProcessor。

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

Xml代码

1. <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"       

2.     xsi:schemaLocation="http://www.springframework.org/schema/beans        

3.     http://www.springframework.org/schema/beans/spring-beans-2.5.xsd        

4.     http://www.springframework.org/schema/context        

5.     http://www.springframework.org/schema/context/spring-context-2.5.xsd">        

6.     <context:component-scan base-package="com.kedacom.ksoa" />        

7. beans>   

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

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

过滤器类型 | 表达式范例 | 说明

注解 | org.example.SomeAnnotation | 将所有使用SomeAnnotation注解的类过滤出来

类名指定 | org.example.SomeClass | 过滤指定的类

正则表达式 | com\.kedacom\.spring\.annotation\.web\..* | 通过正则表达式过滤一些类

AspectJ表达式 | org.example..*Service+ | 通过AspectJ表达式过滤一些类

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

Xml代码

1. <context:component-scan base-package="com.casheen.spring.annotation">        

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

3. context:component-scan>    

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