SpringMVC框架 第2 章 @RequestMapping注解
第2 章 @RequestMapping注解
2.1 @RequestMapping 映射请求注解
2.1.1 @RequestMapping 概念
1) SpringMVC使用@RequestMapping注解为控制器指定可以处理哪些 URL 请求
2) 在控制器的类定义及方法定义处都可标注 @RequestMapping
- 标记在类上:提供初步的请求映射信息。相对于 WEB 应用的根目录
- 标记在方法上:提供进一步的细分映射信息。相对于标记在类上的 URL。
3) 若类上未标注 @RequestMapping,则方法处标记的 URL 相对于 WEB 应用的根目录
4) 作用:DispatcherServlet 截获请求后,就通过控制器上 @RequestMapping 提供的映射信息确定请求所对应的处理方法。
2.1.2 @ RequestMapping源码参考
package org.springframework.web.bind.annotation; @Target({ElementType.METHOD, ElementType.TYPE}) @Retention(RetentionPolicy.RUNTIME) @Documented @Mapping public @interface RequestMapping { String[] value() default {}; RequestMethod[] method() default {}; String[] params() default {}; String[] headers() default {}; String[] consumes() default {}; String[] produces() default {}; } |
2.2 RequestMapping 可标注的位置
2.2.1 实验代码
定义页面链接、控制器方法
<a href="springmvc/helloworld">test @RequestMapping</a> |
@Controller //声明Bean对象,为一个控制器组件 @RequestMapping("/springmvc") public class HelloWorldController { /** * 映射请求的名称:用于客户端请求;类似Struts2中action映射配置的,action名称 *1 使用@RequestMapping 注解来映射请求的 URL *2 返回值会通过视图解析器解析为实际的物理视图, * 对于 InternalResourceViewResolver 视图解析器, * 会做如下的解析: * 通过 prefix + returnVal + 后缀 这样的方式得到实际的物理视图, 然会做转发操作. * /WEB-INF/views/success.jsp */ @RequestMapping(value="/helloworld") public String helloworld(){ System.out.println("hello,world"); return "success"; //结果如何跳转呢?需要配置视图解析器 } } |
2.3 RequestMapping映射请求方式
2.3.1 标准的 HTTP 请求报头
2.3.2 映射请求参数、请求方法或请求头
1)@RequestMapping 除了可以使用请求 URL 映射请求外,还可以使用请求方法、请求参数及请求头映射请求
2)@RequestMapping 的 value【重点】、method【重点】、params【了解】 及 heads
【了解】 分别表示请求 URL、请求方法、请求参数及请求头的映射条件,他们之间是与的关系,联合使用多个条件可让请求映射更加精确化。
3)params 和 headers支持简单的表达式:
param1: 表示请求必须包含名为 param1 的请求参数
!param1: 表示请求不能包含名为 param1 的请求参数
param1 != value1: 表示请求包含名为 param1 的请求参数,但其值不能为 value1
{"param1=value1", "param2"}: 请求必须包含名为 param1 和param2 的两个请求参数,且 param1 参数的值必须为 value1
2.3.3 实验代码
1) 定义控制器方法
@Controller @RequestMapping("/springmvc") public class SpringMVCController { @RequestMapping(value="/testMethord",method=RequestMethod.POST) public String testMethord(){ System.out.println("testMethord..."); return "success"; } } |
2) 以get方式请求
<a href="springmvc/testMethord">testMethord</a> |
发生请求错误
3) 以POST方式请求
<form action="springmvc/testMethord" method="post"> <input type="submit" value="submit"> </form> |
2.4 RequestMapping映射请求参数&请求头
2.4.1 RequestMapping_请求参数&请求头【了解】
//了解: 可以使用 params 和 headers 来更加精确的映射请求. params 和 headers 支持简单的表达式. @RequestMapping(value="/testParamsAndHeaders", params= {"username","age!=10"}, headers = { "Accept-Language=en-US,zh;q=0.8" }) public String testParamsAndHeaders(){ System.out.println("testParamsAndHeaders..."); return "success"; } |
2.4.2 实验代码
1) 请求URL
<!--设置请求参数和请求头信息 --> <a href="springmvc/testParamsAndHeaders">testParamsAndHeaders</a> |
- 2) 测试:使用火狐或Chrom浏览器debug测试
- 测试有参数情况(不正确):
- <a href="springmvc/testParamsAndHeaders">testParamsAndHeaders</a>
警告: No matching handler method found for servlet request: path '/springmvc/testParamsAndHeaders', method 'GET', parameters map[[empty]] |
- <a href="springmvc/testParamsAndHeaders?username=atguigu&age=10">testParamsAndHeaders</a>
警告: No matching handler method found for servlet request: path '/springmvc/testParamsAndHeaders', method 'GET', parameters map['username' -> array<String>['atguigu'], 'age' -> array<String>['10']] |
- <a href="springmvc/testParamsAndHeaders?age=11">testParamsAndHeaders</a>
警告: No matching handler method found for servlet request: path '/springmvc/testParamsAndHeaders', method 'GET', parameters map['age' -> array<String>['11']] |
- 测试有参数情况(正确):
- <a href="springmvc/testParamsAndHeaders?username=atguigu&age=15">testParamsAndHeaders</a>
2.5 RequestMapping支持Ant 路径风格
2.5.1 Ant
1) Ant 风格资源地址支持 3 种匹配符:【了解】
?:匹配文件名中的一个字符
*:匹配文件名中的任意字符
**:** 匹配多层路径
2) @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 |
2.5.2 实验代码
1) 定义控制器方法
//Ant 风格资源地址支持 3 种匹配符 //@RequestMapping(value="/testAntPath/*/abc") //@RequestMapping(value="/testAntPath/**/abc") @RequestMapping(value="/testAntPath/abc??") public String testAntPath(){ System.out.println("testAntPath..."); return "success"; } |
2) 页面链接
<!-- Ant 风格资源地址支持 3 种匹配符 --> <a href="springmvc/testAntPath/*/abc">testAntPath</a> <a href="springmvc/testAntPath/xxx/yyy/abc">testAntPath</a> <a href="springmvc/testAntPath/abcxx">testAntPath</a> |
2.6 RequestMapping映射请求占位符PathVariable注解
2.6.1 @PathVariable
带占位符的 URL 是 Spring3.0 新增的功能,该功能在 SpringMVC 向 REST 目标挺进发展过程中具有里程碑的意义
通过 @PathVariable 可以将 URL 中占位符参数绑定到控制器处理方法的入参中:
URL 中的 {xxx} 占位符可以通过 @PathVariable("xxx") 绑定到操作方法的入参中。
2.6.2 实验代码
1) 定义控制器方法
//@PathVariable 注解可以将请求URL路径中的请求参数,传递到处理请求方法的入参中 @RequestMapping(value="/testPathVariable/{id}") public String testPathVariable(@PathVariable("id") Integer id){ System.out.println("testPathVariable...id="+id); return "success"; } |
2) 请求链接
<!-- 测试 @PathVariable --> <a href="springmvc/testPathVariable/1">testPathVariable</a> |