第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映射请求占位符PathVariable注解

2.5.1 @PathVariable

带占位符的 URL 是 Spring3.0 新增的功能，该功能在 SpringMVC 向 REST 目标挺进发展过程中具有里程碑的意义
通过 @PathVariable 可以将 URL 中占位符参数绑定到控制器处理方法的入参中：
URL 中的 {xxx} 占位符可以通过 @PathVariable(“xxx”) 绑定到操作方法的入参中。

2.5.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>