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），因此当使用后，就可以将移除了。