SpringMVC系列（二）: SpringMVC各个注解的使用

1、@RequestMapping

1.@RequestMapping除了能修饰方法，还能修饰类
(1)修饰类：提供初步的请求映射信息，相对于web请求的根目录
(2)修饰方法：提供进一步的细分映射信息
相对于类定义处的URL，若类定义处未标注@RequestMapping，则方法处标记的URL相对于web应用的根目录

2.@RequestMapping的请求方式
@RequestMapping 的 value、method、params 及 heads 分别表示请求 URL、请求方法、请求参数及请求头的映射条
件，他们之间是与的关系，联合使用多个条件可让请求映射更加精确化。

3.Ant 风格资源地址支持 3 种匹配符：
– ?：匹配文件名中的一个字符
– *：匹配文件名中的任意字符
– **：** 匹配多层路径
• @RequestMapping 还支持 Ant 风格的 URL：
– /user/*/createUser: 匹配
/user/aaa/createUser、/user/bbb/createUser 等 URL
– /user/**/createUser: 匹配
/user/createUser、/user/aaa/bbb/createUser 等 URL
– /user/createUser??: 匹配
/user/createUseraa、/user/createUserbb 等 URL

 package com.study.springmvc.handlers;

 import org.springframework.stereotype.Controller;

 import org.springframework.web.bind.annotation.RequestMapping;

 import org.springframework.web.bind.annotation.RequestMethod;

 @RequestMapping("/requestMappingTest")

 @Controller

 public class RequestMappingTest {

     public static final String SUCCESS="success";

     /**

      * 1.@RequestMapping除了能修饰方法，还能修饰类

      *(1)修饰类：提供初步的请求映射信息，相对于web请求的根目录

      *(2)修饰方法：提供进一步的细分映射信息

      * 相对于类定义处的URL，若类定义处未标注@RequestMapping，则方法处标记的URL相对于web应用的根目录

      * @return 成功

      */

     @RequestMapping("/testRequestMapping")

     public String testRequestMapping() {

         System.out.println("testRequestMapping");

         return SUCCESS;

     }

     /**

      * 2.@RequestMapping的请求方式

        @RequestMapping 的 value、method、params 及 heads 分别表示请求 URL、请求方法、请求参数及请求头的映射条

          件，他们之间是与的关系，联合使用多个条件可让请求映射更加精确化。

      * @return

      */

     @RequestMapping(value="/testMethod",method=RequestMethod.POST)

     public String testMethod() {

         System.out.println("testMethod的post方式");

         return SUCCESS;

     } 

     /**

      * 3.了解: 可以使用 params 和 headers 来更加精确的映射请求. params 和 headers 支持简单的表达式.

      *

      * @return

      */

     @RequestMapping(value = "testParamsAndHeaders", params = { "username",

             "age!=10" }, headers = { "Accept-Language=zh-CN,zh;q=0.8" })

     public String testParamsAndHeaders() {

         System.out.println("testParamsAndHeaders");

         return SUCCESS;

     }

     /**

      * 4.Ant 风格资源地址支持 3 种匹配符：

      *    – ?：匹配文件名中的一个字符

      *    – *：匹配文件名中的任意字符

      *    – **：** 匹配多层路径

      * @return

      */

     @RequestMapping("/testAntPath/*/abc")

     public String testAntPath() {

         System.out.println("testAntPath");

         return SUCCESS;

     }

 }

 <%@ page language="java" contentType="text/html; charset=UTF-8"

     pageEncoding="UTF-8"%>

 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">

 <html>

 <body>

 <!-- href="helloworld"和HelloWorld.java的@RequestMapping("/helloworld")对应 -->

 <a href="helloworld">Hello World</a>

 <br/>

 <a href="requestMappingTest/testRequestMapping">@RequestMapping修饰类和方法</a>

 <br/>

 <form action="requestMappingTest/testMethod" method="POST">

 <input type="submit" value="测试@RequestMappin的post请求方式">

 </form>

  <br/>

 <a href="requestMappingTest/testParamsAndHeaders?username=lgs&age=11">testParamsAndHeaders</a>

  <br/>

 <a href="requestMappingTest/testAntPath/ggggggg/abc">testAntPath</a>

 </body>

 </html>

2、@PathVariable

@PathVariable 映射 URL 绑定的占位符

• 带占位符的 URL 是 Spring3.0 新增的功能，该功能在SpringMVC 向 REST 目标挺进发展过程中具有里程碑的意义

• 通过 @PathVariable 可以将 URL 中占位符参数绑定到控制器处理方法的入参中：URL 中的 {xxx} 占位符可以通过@PathVariable("xxx") 绑定到操作方法的入参中。

 <a href="pathVariableTest/testPathVariable/10">testPathVariable</a>

 package com.study.springmvc.handlers;

 import org.springframework.stereotype.Controller;

 import org.springframework.web.bind.annotation.PathVariable;

 import org.springframework.web.bind.annotation.RequestMapping;

 @RequestMapping("/pathVariableTest")

 @Controller

 public class PathVariableTest {

     public static final String SUCCESS="success";

     /**

      * @PathVariable 可以来映射 URL 中的占位符到目标方法的参数中.

      * @param id

      * @return

      */

     @RequestMapping("/testPathVariable/{id}")

     public String testPathVariable(@PathVariable("id") Integer id) {

         System.out.println("testPathVariable: " + id);

         return SUCCESS;

     }

 }

3、@RequestParam

@RequestParam 来映射请求参数

value 值即请求参数的参数名
required 该参数是否必须. 默认为 true
defaultValue 请求参数的默认值

index.jsp代码

 <!--@RequestParam测试 begin  -->

 <br/>

 <a href="requestParamTest/testRequestParam?username=lgs&age=11">testRequestParam</a>

 <!--@RequestParam测试 end  -->

handlers代码

 package com.study.springmvc.handlers;

 import org.springframework.stereotype.Controller;

 import org.springframework.web.bind.annotation.RequestMapping;

 import org.springframework.web.bind.annotation.RequestParam;

 @RequestMapping("/requestParamTest")

 @Controller

 public class RequestParamTest {

     public static final String SUCCESS="success";

     /**

      * @RequestParam 来映射请求参数.

      * value 值即请求参数的参数名

      * required 该参数是否必须. 默认为 true

      * defaultValue 请求参数的默认值

      */

     @RequestMapping(value = "/testRequestParam")

     public String testRequestParam(

             @RequestParam(value = "username") String username,

             @RequestParam(value = "age", required = false, defaultValue = "0") int age) {

         System.out.println("testRequestParam, username: " + username + ", age: "

                 + age);

         return SUCCESS;

     }

 }

4. @RequestHeader

映射请求头信息用法同 @RequestParam，使用机会较少了解就行

index.jsp代码

 <!--@RequestHeader测试 begin  -->

 <br/>

 <a href="requestHeaderTest/testRequestHeader">testRequestHeader</a>

 <!--@RequestHeader测试 end  -->

handlers代码

 package com.study.springmvc.handlers;

 import org.springframework.stereotype.Controller;

 import org.springframework.web.bind.annotation.RequestHeader;

 import org.springframework.web.bind.annotation.RequestMapping;

 @RequestMapping("/requestHeaderTest")

 @Controller

 public class RequestHeaderTest {

     public static final String SUCCESS="success";

     /**

      * 使用机会较少了解就行

      * 映射请求头信息 用法同 @RequestParam

      */

     @RequestMapping("/testRequestHeader")

     public String testRequestHeader(

             @RequestHeader(value = "Accept-Language") String al) {

         System.out.println("testRequestHeader, Accept-Language: " + al);

         return SUCCESS;

     }

 }

5. @CookieValue

映射一个 Cookie 值. 属性同 @RequestParam，使用机会较少了解就行

index.jsp代码

 <!--@CookieValue测试 begin  -->

 <br/>

 <a href="cookieValueTest/testCookieValue">testCookieValue</a>

 <!--@CookieValue测试 end  -->

handlers代码

 package com.study.springmvc.handlers;

 import org.springframework.stereotype.Controller;

 import org.springframework.web.bind.annotation.CookieValue;

 import org.springframework.web.bind.annotation.RequestMapping;

 @RequestMapping("/cookieValueTest")

 @Controller

 public class CookieValueTest {

     public static final String SUCCESS="success";

     /**

      * 使用机会较少了解就行

      *

      * @CookieValue: 映射一个 Cookie 值. 属性同 @RequestParam

      */

     @RequestMapping("/testCookieValue")

     public String testCookieValue(@CookieValue(value = "JSESSIONID") String sessionId) {

         System.out.println("testCookieValue: sessionId: " + sessionId);

         return SUCCESS;

     }

 }

6. @InitBinder

• 由 @InitBinder 标识的方法，可以对 WebDataBinder 对象进行初始化。WebDataBinder 是 DataBinder 的子类，用于完成由表单字段到 JavaBean 属性的绑定
• @InitBinder方法不能有返回值，它必须声明为void。
• @InitBinder方法的参数通常是是 WebDataBinder

     @InitBinder

     public void initBinder(WebDataBinder binder){

         binder.setDisallowedFields("lastName");

     }

7. @DateTimeFormat

对界面提交过来的日期进行格式化

@DateTimeFormat 注解可对java.util.Date、java.util.Calendar、java.long.Long 时间类型进行标注：
– pattern 属性：类型为字符串。指定解析/格式化字段数据的模式，如：”yyyy-MM-dd hh:mm:ss”
– iso 属性：类型为 DateTimeFormat.ISO。指定解析/格式化字段数据的ISO模式，包括四种：ISO.NONE（不使用） -- 默认、ISO.DATE(yyyy-MM-dd)、ISO.TIME(hh:mm:ss.SSSZ)、ISO.DATE_TIME(yyyy-MM-dd hh:mm:ss.SSSZ)
– style 属性：字符串类型。通过样式指定日期时间的格式，由两位字符组成，第一位表示日期的格式，第二位表示时间的格式：S：短日期/时间格式、M：中日期/时间格式、L：长日期/时间格式、F：完整日期/时间格式、-：忽略日期或时间格式

 @DateTimeFormat(pattern="yyyy-MM-dd")

     private Date birth;

备注：必须在springmvc.xml里面配置<mvc:annotation-driven/>，因为配置了以后才会默认实例化数据集类型转换和格式化的工厂类FormattingConversionServiceFactroyBean，如果自定义了类型转换器则需要这样配置

 <mvc:annotation-driven conversion-service="conversionService"></mvc:annotation-driven>    

     <!-- 配置 ConversionService -->

     <bean id="conversionService"

         class="org.springframework.format.support.FormattingConversionServiceFactoryBean">

         <property name="converters">

             <set>

                 <ref bean="employeeConverter"/>

             </set>

         </property>

     </bean>

8. @NumberFormat

对界面提交过来的数值进行格式化

@NumberFormat 可对类似数字类型的属性进行标注，它拥有两个互斥的属性：
– style：类型为 NumberFormat.Style。用于指定样式类型，包括三种：Style.NUMBER（正常数字类型）、Style.CURRENCY（货币类型）、 Style.PERCENT（百分数类型）
– pattern：类型为 String，自定义样式，如patter="#,###"

 @NumberFormat(pattern="#,###,###.#")

     private Float salary;

备注：必须在springmvc.xml里面配置<mvc:annotation-driven/>，因为配置了以后才会默认实例化数据集类型转换和格式化的工厂类FormattingConversionServiceFactroyBean，如果自定义了类型转换器则需要和@NumberFormat 一样配置