【SpringMVC系列】@RequestMapping注解 详解
【SpringMVC系列】HiddenHttpMethodFilter 过滤器配置实例及源码分析
文章目录
一、@RequestMapping 映射请求注解
概念
1） SpringMVC使用@RequestMapping注解为控制器指定可以处理哪些 URL 请求；
2） 在控制器的类定义及方法定义处都可标注 @RequestMapping；
① 标记在类上：提供初步的请求映射信息。相对于 WEB 应用的根目录。
② 标记在方法上：提供进一步的细分映射信息。相对于标记在类上的 URL。
源码参考：
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 {};
}
3） 若类上未标注 @RequestMapping，则方法处标记的 URL 相对于 WEB 应用的根目录 ；
4） 作用：DispatcherServlet 截获请求后，就通过控制器上 @RequestMapping 提供的映射信息确定请求所对应的处理方法。
二、@RequestMapping 可标注的位置
定义页面链接：
<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
*/
//类上value值的斜杠不可省略，方法里value值的斜杠可以省略不写（会自动拼接上）
@RequestMapping(value="/helloworld")
public String helloworld(){
System.out.println("hello,world");
return "success"; //结果如何跳转呢？需要配置视图解析器
}
}
三、@RequestMapping 映射请求方式
（1）标准 HTTP 请求报头
（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；
（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>
四、@RequestMapping 支持Ant 路径风格
（1）Ant 风格资源地址支持 3 种匹配符：【了解】
?：匹配文件名中的一个字符；
*：匹配文件名中的任意字符；
**:** ：匹配多层路径；
（2）@RequestMapping 还支持 Ant 风格的 URL：
例如：
java/user/*/createUser
匹配 /user/aaa/createUser、/user/bbb/createUser 等 URL
java/user/**/createUser
匹配 /user/createUser、/user/aaa/bbb/createUser 等 URL
/user/createUser??
匹配 /user/createUseraa、/user/createUserbb 等 URL
（3）代码实例
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>
五、@RequestMapping映射请求占位符PathVariable注解
（1）@PathVariable注解
1）带占位符的URL 是 Spring3.0 新增的功能，该功能在 SpringMVC 向 REST 目标挺进发展过程中具有里程碑的意义；
2）通过 @PathVariable 可以将 URL 中占位符参数绑定到控制器处理方法的入参中：
URL 中的 {xxx} 占位符可以通过 @PathVariable(“xxx”) 绑定到操作方法的入参中。
（2）实例代码
1）定义控制器方法
//@PathVariable 注解可以将请求URL路径中的请求参数，传递到处理请求方法的入参中浏览器的请求: testPathVariable/1001
@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>
感谢阅读哇~