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

 1 package com.study.springmvc.handlers;
 2 
 3 import org.springframework.stereotype.Controller;
 4 import org.springframework.web.bind.annotation.RequestMapping;
 5 import org.springframework.web.bind.annotation.RequestMethod;
 6 
 7 @RequestMapping("/requestMappingTest")
 8 @Controller
 9 public class RequestMappingTest {
10 
11     public static final String SUCCESS="success";
12     /**
13      * 1.@RequestMapping除了能修饰方法，还能修饰类
14      *(1)修饰类：提供初步的请求映射信息，相对于web请求的根目录
15      *(2)修饰方法：提供进一步的细分映射信息
16      * 相对于类定义处的URL，若类定义处未标注@RequestMapping，则方法处标记的URL相对于web应用的根目录
17      * @return 成功
18      */
19     @RequestMapping("/testRequestMapping")
20     public String testRequestMapping() {
21         System.out.println("testRequestMapping");
22         return SUCCESS;
23     }
24     
25     /**
26      * 2.@RequestMapping的请求方式
27        @RequestMapping 的 value、method、params 及 heads 分别表示请求 URL、请求方法、请求参数及请求头的映射条
28          件，他们之间是与的关系，联合使用多个条件可让请求映射更加精确化。
29      * @return
30      */
31     @RequestMapping(value="/testMethod",method=RequestMethod.POST)
32     public String testMethod() {
33         System.out.println("testMethod的post方式");
34         return SUCCESS;
35     } 
36     
37     /**
38      * 3.了解: 可以使用 params 和 headers 来更加精确的映射请求. params 和 headers 支持简单的表达式.
39      * 
40      * @return
41      */
42     @RequestMapping(value = "testParamsAndHeaders", params = { "username",
43             "age!=10" }, headers = { "Accept-Language=zh-CN,zh;q=0.8" })
44     public String testParamsAndHeaders() {
45         System.out.println("testParamsAndHeaders");
46         return SUCCESS;
47     }
48     /**
49      * 4.Ant 风格资源地址支持 3 种匹配符：
50      *    – ?：匹配文件名中的一个字符
51      *    – *：匹配文件名中的任意字符
52      *    – **：** 匹配多层路径
53      * @return
54      */
55     @RequestMapping("/testAntPath/*/abc")
56     public String testAntPath() {
57         System.out.println("testAntPath");
58         return SUCCESS;
59     }
60 }

 1 <%@ page language="java" contentType="text/html; charset=UTF-8"
 2     pageEncoding="UTF-8"%>
 3     
 4 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
 5 <html>
 6 <body>
 7 <!-- href="helloworld"和HelloWorld.java的@RequestMapping("/helloworld")对应 -->
 8 <a href="helloworld">Hello World</a>
 9 
10 <br/>
11 <a href="requestMappingTest/testRequestMapping">@RequestMapping修饰类和方法</a>
12 
13 <br/>
14 <form action="requestMappingTest/testMethod" method="POST">
15 <input type="submit" value="测试@RequestMappin的post请求方式">
16 </form>
17  
18  <br/>
19 <a href="requestMappingTest/testParamsAndHeaders?username=lgs&age=11">testParamsAndHeaders</a>
20  
21  <br/>
22 <a href="requestMappingTest/testAntPath/ggggggg/abc">testAntPath</a>
23     
24     
25 </body>
26 </html>

2、@PathVariable

@PathVariable 映射 URL 绑定的占位符

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

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

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

 1 package com.study.springmvc.handlers;
 2 
 3 import org.springframework.stereotype.Controller;
 4 import org.springframework.web.bind.annotation.PathVariable;
 5 import org.springframework.web.bind.annotation.RequestMapping;
 6 
 7 @RequestMapping("/pathVariableTest")
 8 @Controller
 9 public class PathVariableTest {
10 
11     public static final String SUCCESS="success";
12     
13     /**
14      * @PathVariable 可以来映射 URL 中的占位符到目标方法的参数中.
15      * @param id
16      * @return
17      */
18     @RequestMapping("/testPathVariable/{id}")
19     public String testPathVariable(@PathVariable("id") Integer id) {
20         System.out.println("testPathVariable: " + id);
21         return SUCCESS;
22     }
23 }

3、@RequestParam

@RequestParam 来映射请求参数

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

index.jsp代码

1 <!--@RequestParam测试 begin  --> 
2 <br/>
3 <a href="requestParamTest/testRequestParam?username=lgs&age=11">testRequestParam</a>
4 <!--@RequestParam测试 end  -->

handlers代码

 1 package com.study.springmvc.handlers;
 2 
 3 import org.springframework.stereotype.Controller;
 4 import org.springframework.web.bind.annotation.RequestMapping;
 5 import org.springframework.web.bind.annotation.RequestParam;
 6 
 7 @RequestMapping("/requestParamTest")
 8 @Controller
 9 public class RequestParamTest {
10 
11     public static final String SUCCESS="success";
12     
13 
14     /**
15      * @RequestParam 来映射请求参数. 
16      * value 值即请求参数的参数名 
17      * required 该参数是否必须. 默认为 true
18      * defaultValue 请求参数的默认值
19      */
20     @RequestMapping(value = "/testRequestParam")
21     public String testRequestParam(
22             @RequestParam(value = "username") String username,
23             @RequestParam(value = "age", required = false, defaultValue = "0") int age) {
24         System.out.println("testRequestParam, username: " + username + ", age: "
25                 + age);
26         return SUCCESS;
27     }
28 }

4. @RequestHeader

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

index.jsp代码

1 <!--@RequestHeader测试 begin  --> 
2 <br/>
3 <a href="requestHeaderTest/testRequestHeader">testRequestHeader</a>
4 <!--@RequestHeader测试 end  -->

handlers代码

 1 package com.study.springmvc.handlers;
 2 
 3 import org.springframework.stereotype.Controller;
 4 import org.springframework.web.bind.annotation.RequestHeader;
 5 import org.springframework.web.bind.annotation.RequestMapping;
 6 
 7 @RequestMapping("/requestHeaderTest")
 8 @Controller
 9 public class RequestHeaderTest {
10 
11     public static final String SUCCESS="success";
12     
13     /**
14      * 使用机会较少了解就行
15      * 映射请求头信息 用法同 @RequestParam
16      */
17     @RequestMapping("/testRequestHeader")
18     public String testRequestHeader(
19             @RequestHeader(value = "Accept-Language") String al) {
20         System.out.println("testRequestHeader, Accept-Language: " + al);
21         return SUCCESS;
22     }
23 }

5. @CookieValue

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

index.jsp代码

1 <!--@CookieValue测试 begin  --> 
2 <br/>
3 <a href="cookieValueTest/testCookieValue">testCookieValue</a>
4 <!--@CookieValue测试 end  -->

handlers代码

 1 package com.study.springmvc.handlers;
 2 
 3 import org.springframework.stereotype.Controller;
 4 import org.springframework.web.bind.annotation.CookieValue;
 5 import org.springframework.web.bind.annotation.RequestMapping;
 6 
 7 @RequestMapping("/cookieValueTest")
 8 @Controller
 9 public class CookieValueTest {
10 
11     public static final String SUCCESS="success";
12     
13     /**
14      * 使用机会较少了解就行
15      * 
16      * @CookieValue: 映射一个 Cookie 值. 属性同 @RequestParam
17      */
18     @RequestMapping("/testCookieValue")
19     public String testCookieValue(@CookieValue(value = "JSESSIONID") String sessionId) {
20         System.out.println("testCookieValue: sessionId: " + sessionId);
21         return SUCCESS;
22     }
23 }

6. @InitBinder

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

1     @InitBinder
2     public void initBinder(WebDataBinder binder){
3         binder.setDisallowedFields("lastName");
4     }

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：完整日期/时间格式、-：忽略日期或时间格式

1 @DateTimeFormat(pattern="yyyy-MM-dd")
2     private Date birth;

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

 1 <mvc:annotation-driven conversion-service="conversionService"></mvc:annotation-driven>    
 2     
 3     <!-- 配置 ConversionService -->
 4     <bean id="conversionService"
 5         class="org.springframework.format.support.FormattingConversionServiceFactoryBean">
 6         <property name="converters">
 7             <set>
 8                 <ref bean="employeeConverter"/>
 9             </set>
10         </property>    
11     </bean>

8. @NumberFormat

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

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

1 @NumberFormat(pattern="#,###,###.#")
2     private Float salary;

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

posted @ 2017-11-08 21:22 小不点啊阅读(3097) 评论(0) 编辑收藏举报

刷新页面返回顶部

小不点啊

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

1、@RequestMapping

2、@PathVariable

3、@RequestParam

4. @RequestHeader

5. @CookieValue

6. @InitBinder

7. @DateTimeFormat

8. @NumberFormat

公告