（2）SpringMVC——@RequestMapping注解

1.@RequestMapping 注解映射请求

1 概述

1. SpringMVC使用@RequestMapping注解为控制器指定可以处理哪些 URL 请求。
2. DispatcherServlet 截获请求后，就通过控制器上 @RequestMapping 提供的映射信息确定请求所对应的处理方法。

2 @RequestMapping注解可以标注的位置

@RequestMapping注解可以添加到类上，也可以添加到方法上

1. 标记在类上：提供初步的请求映射信息。相对于WEB 应用的根目录
2. 标记在方法上：提供进一步的细分映射信息。相对于标记在类上的 URL。

3 @RequestMapping注解常用的属性

1) value属性

a) 用来设置要映射的请求地址
b) 值的类型是String类型的数组，所以可以同时设置多个映射的地址

@RequestMapping(value = {"/testValue1","/testValue2"})
public String testValue(){
    System.out.println("测试@RequestMapping注解的value属性");
    return "success";//与xml文件中的前后缀拼接成URL
}

2) method属性

a) 用来设置要映射的请求方式
b) 值的类型是RequestMethod枚举类型的数组
c) 请求方式有Get、Post、Put、Delete等

@RequestMapping(value = "/testMethod",method = RequestMethod.GET)
public String testMethod(){
    System.out.println("测试@RequestMapping注解的method属性");
    return "success";
}

3) 可以使用 params 和 headers 来更加精确的映射请求，而且支持简单的表达式

a) params属性（了解）

i. 用来设置请求地址中必须包含的请求参数
ii. 值的类型是String类型的数组
iii. 各种表达式说明：

1. param1: 表示请求必须包含名为 param1 的请求参数
2. !param1: 表示请求不能包含名为 param1 的请求参数
3. param1 != value1: 表示请求包含名为 param1 的请求参数，但其值不能为 value1
4. {“param1=value1”, “param2”}: 请求必须包含名为 param1 和param2 的两个请求参数，且 param1 参数的值必须为 value1

@RequestMapping(value = "/testParams",method = RequestMethod.GET,params = {"name=admin","age=18"})
public String testParams(){
    System.out.println("测试@RequestMapping注解的params属性");
    return "success";
}

b) headers属性（了解）

i. 用来设置请求地址中必须包含的请求头
ii. 值的类型是String类型的数组

@RequestMapping(value = "/testHeaders",method = RequestMethod.GET,
        headers = "Accept-Language=zh-CN,zh;q=0.9,en-US;q=0.8,en;q=0.7")
public String testHeaders(){
    System.out.println("测试@RequestMapping注解的headers属性");
    return "success";
}

4 @RequestMapping支持Ant 风格的路径（了解）

1. Ant 风格资源地址支持 3 种匹配符
   a) ?：匹配一个字符
   b) *：匹配任意字符
   c) **：匹配多层路径
2. 页面链接

<a href="${pageContext.request.contextPath}/testAnt/a/ant">Test Ant_?</a><br>
<a href="${pageContext.request.contextPath}/testAnt/abc/ant">Test Ant_*</a><br>
<a href="${pageContext.request.contextPath}/testAnt/a/b/c/ant">Test Ant_**</a><br>

3. 处理器方法

//    @RequestMapping("/testAnt/?/ant")
//    @RequestMapping("/testAnt/*/ant")
    @RequestMapping("/testAnt/**/ant")
    public String testAnt(){
        System.out.println("测试Ant风格的URL");
        return "success";
    }

5 @RequestMapping映射带占位符的URL（重点）

1. 带占位符的URL 是 Spring3.0 新增的功能，该功能在 SpringMVC 向 REST 目标挺进发展过程中具有里程碑的意义。
2. 通过 @PathVariable 可以将 URL 中占位符参数绑定到控制器处理方法的入参中，
   URL 中的 {xxx} 占位符可以通过 @PathVariable(“xxx”) 绑定到处理方法的入参中。
3. @PathVariable注解主要用来处理REST风格的URL的中的请求参数。该注解中有以下三个属性：
   a) value属性：用来指定要映射的URL中的占位符的名字。
   b) name属性：与value功能一样，是value的一个别名。
   c) required属性：设置指定的占位符的名字是否是必须的，默认是true，如果不存在则抛出异常。

1 页面连接

<a href="${pageContext.request.contextPath}/testPathVariable/1">Test PathVariable</a><br>

2 处理器方法

@RequestMapping("/testPathVariable/{id}")
public String testPathVariable(@PathVariable(value = "id",required = false) Integer id){
    System.out.println("传入的id的值是："+id);
    return "success";
}

2.REST

REST：即 Representational State Transfer，表现层状态转换。是Roy Thomas Fielding博士于2000年在他的博士论文中提出来的一种万维网软件架构风格，目的是便于不同软件/程序在网络（例如互联网）中互相传递信息。表现层状态转换是根基于超文本传输协议（HTTP）之上而确定的一组约束和属性，是一种设计提供万维网络服务的软件构建风格。
符合或兼容于这种架构风格（简称为 REST 或 RESTful）的网络服务，允许客户端发出以统一资源标识符访问和操作网络资源的请求。简单来说就是将服务器中的资源通过URI的方式来定位。
REST风格的URL将HTTP协议中的四种请求方式GET、POST、PUT、DELETE分别对应四种基本操作：GET 用来获取资源，POST 用来新建资源，PUT 用来更新资源，DELETE 用来删除资源。

1 REST风格URL与传统URL的对比### 2 发送PUT和DELETE请求

浏览器 form 表单只支持 GET 与 POST 请求，而PUT、DELETE 等请求方式并不支持，Spring3.0 添加了一个过滤器HiddenHttpMethodFilter，可以将POST请求转换为PUT或DELETE请求。
转换PUT或DELETE请求的步骤：

1. 在web.xml配文件中配置过滤器 HiddenHttpMethodFilter。

<!--配置HiddenHttpMethodFilte过滤器，目的是为了将POST请求转换为PUT或DELETE请求-->
<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. 在POST请求的form表单中添加一个_method的请求参数
   _method的值为put（忽略大小写）则转换为PUT请求
   _method的值为delete（忽略大小写）则转换为DELETE请求

<form action="${pageContext.request.contextPath}/testPut" method="post">
  <input type="hidden" name="_method" value="put">
  <input type="submit" value="转换PUT请求">
</form>
<form action="${pageContext.request.contextPath}/testDelete" method="post">
  <input type="hidden" name="_method" value="delete">
  <input type="submit" value="转换DELETE请求">
</form>

3 REST风格的CRUD操作

1) 页面内容

<%--获取资源--%>
<a href="${pageContext.request.contextPath}/testRest/1">Test REST_get</a><br>
<%--添加资源--%>
<form action="${pageContext.request.contextPath}/testRest" method="post">
  <input type="submit" value="REST_post">
</form>
<%--更新资源--%>
<form action="${pageContext.request.contextPath}/testRest" method="post">
  <input type="hidden" name="_method" value="put">
  <input type="hidden" name="id" value="1">
  <input type="submit" value="REST_put">
</form>
<%--删除资源--%>
<form action="${pageContext.request.contextPath}/testRest/1" method="post">
  <input type="hidden" name="_method" value="delete">
  <input type="submit" value="REST_delete">
</form>

2) 处理器方法

//测试REST风格获取操作
@RequestMapping(value = "/testRest/{id}",method = RequestMethod.GET)
public String testREST_get(@PathVariable("id") Integer id){
    System.out.println("传入的id的值是："+id);
    return "success";
}

//测试REST风格添加操作
@RequestMapping(value = "/testRest",method = RequestMethod.POST)
public String testREST_post(){
    System.out.println("添加操作");
    return "success";
}

//测试REST风格更新操作
@RequestMapping(value = "/testRest",method = RequestMethod.PUT)
public String testREST_put(){
    System.out.println("更新操作");
    return "success";
}

//测试REST风格删除操作
@RequestMapping(value = "/testRest/{id}",method = RequestMethod.DELETE)
public String testREST_delete(@PathVariable("id") Integer id){
    System.out.println("传入的id的值是："+id);
    return "success";
}