java spring - 自动装配Bean 注解大全
@Configuration 将一个类定义为 Bean 的配置类
@Componet("userDao") 通过 Repository 定义一个 DAO 的 bean
等价于 <bean id="userDao" class="com.ib.anno.UserDao"/>
@Repository 用户对 DAO 实现类进行注解
@Service 用户对 Service 实现类进行注解
@Controller 用户对 Controller 实现类进行注解
@Autowired 默认按类型匹配注入 Bean,自动注入,默认情况下 required 为 ture,要求一顶耀找到匹配的 Bean,否则报 NoSuchBeanDefinitionException
@Autowired(required=false) 容器中没有一个标注变量类型匹配的 Bean, 忽略 NoSuchBeanDefinitionException 异常
@Qualifier("userDao") 指定注入 userDao Bean 的名称 (如果一个方法拥有多个入参,在默认情况下 Spring 自动选择匹配入参类型的 Bean 进行注入。Spring 允许对方法入参标注 @Qualifier 以指定注入 Bean 的名称)
以下两个注解和 @Autowired 注解的功能类似,除非必要都使用 @Autowired 注解
@Resource("userDao") 按名称匹配注入 Bean,要求提供一个 Bean 名称的属性,如果属性为空,则自动采用标注处的变量名或方法名作为 Bean 的名称
@Inject 按类型匹配注入 Bean,没有 required 属性
@PostConstruct 相当于 bean 的 init-method 属性的功能
@PreDestroy 相当于 bean 的 destroy-method 属性的功能
Spring2.5 引入注解式处理器支持,通过 @Controller 和 @RequestMapping 注解定义我们的处理器
类。并且提供了一组强大的注解:
需要通过处理器映射 DefaultAnnotationHandlerMapping 和处理器适配器 AnnotationMethodHandlerAdapter 来开启支
持 @Controller 和 @RequestMapping 注解的处理器。
@Controller:用于标识是处理器类;
@RequestMapping:请求到处理器功能方法的映射规则;
@RequestParam:请求参数到处理器功能处理方法的方法参数上的绑定;
@ModelAttribute:请求参数到命令对象的绑定;
@SessionAttributes:用于声明 session 级别存储的属性,放置在处理器类上,通常列出模型属性(如
@ModelAttribute)对应的名称,则这些属性会透明的保存到 session 中;
@InitBinder:自定义数据绑定注册支持,用于将请求参数转换到命令对象属性的对应类型;
、Spring3.0 引入 RESTful 架构风格支持 (通过 @PathVariable 注解和一些其他特性支持), 且又引入了
更多的注解支持:
@CookieValue:cookie 数据到处理器功能处理方法的方法参数上的绑定;
@RequestHeader:请求头(header)数据到处理器功能处理方法的方法参数上的绑定;
@RequestBody:请求的 body 体的绑定(通过 HttpMessageConverter 进行类型转换);
@ResponseBody:处理器功能处理方法的返回值作为响应体(通过 HttpMessageConverter 进行类型转换);
@ResponseStatus:定义处理器功能处理方法 / 异常处理器返回的状态码和原因;
@ExceptionHandler:注解式声明异常处理器;
@PathVariable:请求 URI 中的模板变量部分到处理器功能处理方法的方法参数上的绑定,从而支持 RESTful 架构风
格的 URI;
JSR-303 验证框架的无缝支持(通过 @Valid 注解定义验证元数据);
使用 Spring 3 开始的 ConversionService 进行类型转换(PropertyEditor 依然有效),支持使用 @NumberFormat 和
@DateTimeFormat 来进行数字和日期的格式化;
HttpMessageConverter(Http 输入 / 输出转换器,比如 JSON、XML 等的数据输出转换器);
ContentNegotiatingViewResolver,内容协商视图解析器,它还是视图解析器,只是它支持根据请求信息将同一模型
数据以不同的视图方式展示(如 json、xml、html 等),RESTful 架构风格中很重要的概念(同一资源,多种表现形式);
Spring 3 引入 一个 mvc XML 的命名空间用于支持 mvc 配置,包括如:
<mvc:annotation-driven>:
自动注册基于注解风格的处理器需要的 DefaultAnnotationHandlerMapping、AnnotationMethodHandlerAdapter
支持 Spring3 的 ConversionService 自动注册
支持 JSR-303 验证框架的自动探测并注册(只需把 JSR-303 实现放置到 classpath)
自动注册相应的 HttpMessageConverter(用于支持 @RequestBody 和 @ResponseBody)(如 XML 输入输出转换器
(只需将 JAXP 实现放置到 classpath)、JSON 输入输出转换器(只需将 Jackson 实现放置到 classpath))等。
<mvc:interceptors>:注册自定义的处理器拦截器;
<mvc:view-controller>:和 ParameterizableViewController 类似,收到相应请求后直接选择相应的视图;
<mvc:resources>:逻辑静态资源路径到物理静态资源路径的支持;
<mvc:default-servlet-handler>:当在 web.xml 中 DispatcherServlet 使用 <url-pattern>/</url-pattern> 映射时,能映射静
态资源(当 Spring Web MVC 框架没有处理请求对应的控制器时(如一些静态资源),转交给默认的 Servlet 来响应静态
文件,否则报 404 找不到资源错误,)。
……等等。
五、Spring3.1 新特性:
对 Servlet 3.0 的全面支持。
@EnableWebMvc:用于在基于 Java 类定义 Bean 配置中开启 MVC 支持,和 XML 中的 <mvc:annotation-driven> 功能一样;
新的 @Contoller 和 @RequestMapping 注解支持类:处理器映射 RequestMappingHandlerMapping 和 处理器适配器
RequestMappingHandlerAdapter 组合来代替 Spring2.5 开始的处理器映射 DefaultAnnotationHandlerMapping 和处理
器适配器 AnnotationMethodHandlerAdapter,提供更多的扩展点,它们之间的区别我们在处理器映射一章介绍。
新的 @ExceptionHandler 注解支持类: ExceptionHandlerExceptionResolver 来代替 Spring3.0 的
AnnotationMethodHandlerExceptionResolver,在异常处理器一章我们再详细讲解它们的区别。
@RequestMapping 的 "consumes" 和 "produces" 条件支持:用于支持 @RequestBody 和 @ResponseBody,
○1 consumes 指定请求的内容是什么类型的内容,即本处理方法消费什么类型的数据,如 consumes="application/json"
表示 JSON 类型的内容,Spring 会根据相应的 HttpMessageConverter 进行请求内容区数据到 @RequestBody 注解的命令
对象的转换;
○2 produces 指定生产什么类型的内容,如 produces="application/json" 表示 JSON 类型的内容,Spring 的根据相应的
HttpMessageConverter 进行请求内容区数据到 @RequestBody 注解的命令对象的转换,Spring 会根据相应的
HttpMessageConverter 进行模型数据(返回值)到 JSON 响应内容的转换
○3 以上内容,本章第×××节详述。
URI 模板变量增强:URI 模板变量可以直接绑定到 @ModelAttribute 指定的命令对象、@PathVariable 方法参数在视图
渲染之前被合并到模型数据中(除 JSON 序列化、XML 混搭场景下)。
@Validated:JSR-303 的 javax.validation.Valid 一种变体(非 JSR-303 规范定义的,而是 Spring 自定义的),用于
提供对 Spring 的验证器(org.springframework.validation.Validator)支持,需要 Hibernate Validator 4.2 及更
高版本支持;
@RequestPart : 提供对“ multipart/form-data ” 请求的全面支持, 支持 Servlet 3.0 文件上传
(javax.servlet.http.Part)、支持内容的 HttpMessageConverter(即根据请求头的 Content-Type,来判断内容区数
据是什么类型,如 JSON、XML,能自动转换为命令对象),比 @RequestParam 更强大(只能对请求参数数据绑定,key-alue
格式),而 @RequestPart 支持如 JSON、XML 内容区数据的绑定;详见本章的第×××节;
Flash 属性 和 RedirectAttribute:通过 FlashMap 存储一个请求的输出,当进入另一个请求时作为该请求的输入,
典型场景如重定向(POST-REDIRECT-GET 模式,1、POST 时将下一次需要的数据放在 FlashMap;2、重定向;3、通过
GET 访问重定向的地址,此时 FlashMap 会把 1 放到 FlashMap 的数据取出放到请求中,并从 FlashMap 中删除;从而支
持在两次请求之间保存数据并防止了重复表单提交)。
Spring Web MVC 提供 FlashMapManager 用于管理 FlashMap,默认使用 SessionFlashMapManager,即数据默认存储
在 session 中。