一. 可以修饰类
RequestMapping既可以修饰方法,也可以修饰类
二. 请求方式
1. @RequestMapping不仅可以根据url来响应用户请求,还可以根据其他参数来响应:
- value——请求url
- method——请求方法(post或者get)
- params——请求参数
- headers——请求头
他们之间是”与“的关系,联合使用多个条件可以让请求映射更加精确化
eg. (常用)使用 method 属性来指定请求方式(params 和 headers 比较不常用)
/**
* 常用: 使用 method 属性来指定请求方式
*/
@RequestMapping(value = "/testMethod", method = RequestMethod.POST)
public String testMethod() {
System.out.println("testMethod");
return SUCCESS;
}
2. params和headers支持简单的表达式:
使用params和headers来精确映射请求(了解即可):
如上图,要求请求中包含参数“username”和“age”,并且age不等于10;同时要求请求头中的信息中包含“Accept-Language-US,zh;q=0.8”
所以,当请求为如下时,请求无法响应而会报错。
三. Ant路径(了解)
- 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
四. @PathVariable注解
带占位符的 URL 是spring3.0 新增的功能,该功能在springmvc向 REST 目标挺进发展过程中具有里程碑式的意义
通过 @PathVariable 注解可以将 URL 中的占位符参数绑定到到目标方法的入参中,即:
URL 中的 {xxx} 占位符可以通过@PathVariable(“xxx”)绑定到操作方法的入参中
/**
* @PathVariable 可以来映射 URL 中的占位符到目标方法的参数中.
* @param id
* @return
*/
@RequestMapping("/testPathVariable/{id}")
public String testPathVariable(@PathVariable("id") Integer id) {
System.out.println("testPathVariable: " + id);
return SUCCESS;
}
五. HiddenHttpMethodFilter 过滤器
讲 HiddenHttpMethodFilter 之前,有必要先介绍一下REST:
REST:即 Representational State Transfer。(资源)表现层状态转化。是目前最流行的一种互联网软件架构。它结构清晰、符合标准、易于理解、扩展方便,所以正得到越来越多网站的采用。
- 资源(Resources):网络上的一个实体,或者说是网络上的一个具体信息。它可以是一段文本、一张图片、一首歌曲、一种服务,总之就是一个具体的存在。可以用一个URI(统一资源定位符)指向它,每种资源对应一个特定的 URI 。要获取这个资源,访问它的URI就可以,因此 URI 即为每一个资源的独一无二的识别符。
- 表现层(Representation):把资源具体呈现出来的形式,叫做它的表现(Representation)。比如,文本可以用 txt 格式表现,也可以用 HTML 格式、XML 格式、JSON 格式表现,甚至可以采用二进制格式。
- 状态转化(State Transfer):每发出一个请求,就代表了客户端和服务器的一次交互过程。HTTP协议,是一个无状态协议,即所有的状态都保存在服务器端。因此,如果客户端想要操作服务器,必须通过某种手段,让服务器端发生“状态转化”(State Transfer)。而这种转化是建立在表现层之上的,所以就是 “表现层状态转化”。具体说,就是 HTTP 协议里面,四个表示操作方式的动词:GET、POST、PUT、DELETE。它们分别对应四种基本操作:GET 用来获取资源,POST 用来新建资源,PUT 用来更新资源,DELETE 用来删除资源。
四种状态分别对应了数据库的增删改查操作,例如:
– /order/1 HTTP GET :得到 id = 1 的 order
– /order/1 HTTP DELETE:删除 id = 1的 order
– /order/1 HTTP PUT:更新id = 1的 order
– /order HTTP POST:新增 orderHiddenHttpMethodFilter:浏览器 form 表单只支持 GET与 POST 请求,而DELETE、PUT 等 method 并不支持,Spring3.0 添加了一个过滤器,可以将这些请求转换为标准的 http 方法,使得支持 GET、POST、PUT 与DELETE 请求。
具体应用步骤:
1. 首先在web.xml中添加HiddenHttpMethodFilter的配置:
<!--
配置 org.springframework.web.filter.HiddenHttpMethodFilter: 可以把 POST 请求转为 DELETE 或 POST 请求
-->
<filter>
<filter-name>HiddenHttpMethodFilter</filter-name>
<filter-class>org.springframework.web.filter.HiddenHttpMethodFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>HiddenHttpMethodFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
2. 请求链接:
<a href="springmvc/testREST/1">test REST GET</a>
<br><br>
<form action="springmvc/testREST" method="post">
<input type="submit" value="test REST POST">
</form>
<br><br>
<form action="springmvc/testREST/1" method="post">
<input type="hidden" name="_method" value="DELETE">
<input type="submit" value="test REST DELETE">
</form>
<br><br>
<form action="springmvc/testREST/1" method="post">
<input type="hidden" name="_method" value="PUT">
<input type="submit" value="test REST PUT">
</form>
3. handler处理:
package com.springmvc.handlers;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
@Controller
@RequestMapping("/springmvc")
public class SpringMVCTest {
private static final String SUCCESS="success";
/**
* Rest 风格的 URL.
* 以 CRUD 为例:
* 新增: /order POST
* 修改: /order/1 PUT update?id=1
* 获取: /order/1 GET get?id=1
* 删除: /order/1 DELETE delete?id=1
*
* 如何发送 PUT 请求和 DELETE 请求呢 ?
* 1. 需要配置 HiddenHttpMethodFilter
* 2. 需要发送 POST 请求
* 3. 需要在发送 POST 请求时携带一个 name="_method" 的隐藏域, 值为 DELETE 或 PUT
*
* 在 SpringMVC 的目标方法中如何得到 id 呢? 使用 @PathVariable 注解
*
*/
@RequestMapping(value="/testREST/{id}" , method=RequestMethod.GET)
public String testREST(@PathVariable("id") Integer id) {
System.out.println("testREST GET : "+id);
return SUCCESS;
}
@RequestMapping(value="/testREST" , method=RequestMethod.POST)
public String testREST() {
System.out.println("testREST POST");
return SUCCESS;
}
@RequestMapping(value="/testREST/{id}" , method=RequestMethod.DELETE)
public String testRESTdelete(@PathVariable("id") Integer id) {
System.out.println("testREST DELETE:"+id);
return SUCCESS;
}
@RequestMapping(value="/testREST/{id}" , method=RequestMethod.PUT)
public String testRESTput(@PathVariable("id") Integer id) {
System.out.println("testREST PUT:"+id);
return SUCCESS;
}
}