SpringMVC 3.RequestMapping，@PathVariable注解，REST

@RequestMapping，@PathVariable注解，REST

---

1.使用 @RequestMapping 映射请求

1.1 在控制器的类定义及方法定义处都可标注@RequestMapping

• 类定义处：提供初步的请求映射信息。相对于 WEB 应用的根目录
• 方法处：提供进一步的细分映射信息。相对于类定义处的 URL。若类定义处未标注@RequestMapping，则方法处标记的 URL 相对于WEB 应用的根目录

• DispatcherServlet 截获请求后，就通过控制器上@RequestMapping 提供的映射信息确定请求所对应的处理方法。

  controller类:

/**
 * 类定义处标记的@RequestMapping 限定了处理器类可以处理所有 URI 为 /springmvc的请求，
 * 它相对于 WEB 容器部署的根路径
 */
@RequestMapping("/springmvc")
@Controller
public class SpringTest {
    private static final String SUCCESS = "success" ;

    /**
     * 处理器类可以定义多个处理方法，处理来自/springmvc 下的请求 这个方法可以处理来自/springmvc/testRequestMapping的请求
     * @return
     */
    @RequestMapping("/testRequestMapping")
    public String testRequestMapping(){
        System.out.println("testRequestMapping");
        return SUCCESS ;
    }


}

• jsp页面:<a href="/springmvc/testRequestMapping">TestRequestMapping page</a>

1.2 @RequestMapping 除了可以使用请求 URL 映射请求外，还可以使用请求方法、请求参数及请求头映射请求

1.2.1@RequestMapping 的 value、method、params 及 heads分别表示请求 URL、请求方法、请求参数及请求头的映射条件，他们之间是与的关系，联合使用多个条件可让请求映射更加精确化。

params 和 headers支持简单的表达式：
- param1: 表示请求必须包含名为 param1 的请求参数
- !param1: 表示请求不能包含名为 param1 的请求参数
- param1 != value1: 表示请求包含名为 param1 的请求参数，但其值不能为 value1
- {“param1=value1”, “param2”}: 请求必须包含名为 param1 和param2的两个请求参数，且 param1 参数的值必须为 value1

controller类中添加:

    /**
     * 映射请求方法
     *
     */
    @RequestMapping(value = "/testMethod", method = RequestMethod.POST)
    public String testMethod(){
        System.out.println("testMethod");
        return SUCCESS ;
    }

    /**
     * 映射请求参数或请求头
     * 了解: 可以使用 params 和 headers 来更加精确的映射请求. params 和 headers 支持简单的表达式.
     * @return
     */
    @RequestMapping(value = "/testParamAndHeaders",params = {"username","age!=10"},headers = {})
    public String testParamsAndHeaders(){
        return SUCCESS ;
    }

• jsp页面:

<a href="springmvc/testParamAndHeaders?username=1233&age=11">testParamAndHeaders page</a>
    <br><br>
<form action="/springmvc/testMethod" method="post">
    <input type="submit" value="submit2">
 </form>

1.2.2 Ant 风格资源地址支持 3 种匹配符:

匹配文件名中的一个字符

• *：匹配文件名中的任意字符
• **：** 匹配多层路径

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

controller类中添加:

    @RequestMapping(value = "/testAntPath/*/abc")
    public String testAntPath(){
        System.out.println("testAntPath");
        return SUCCESS ;
    }

• jsp页面: <a href="/springmvc/testAntPath/mmm/abc" >test AntPath</a> mmm可以替换任意值

2 @PathVariable 映射 URL 绑定的占位符

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

controller类中添加:

    /**
     * @PathVariable 可以来映射URL 中的占位符到目标方法的参数中。
     * @param id
     * @return
     */
    @RequestMapping(value = "/testPathVariable/{id}")
    public String testPathVariable(@PathVariable(value = "id") Integer id){
        System.out.println("testPathVariable" + id);
        return SUCCESS ;
    }

jsp页面:<a href="/springmvc/testPathVariable/1" >test PathVariable</a>

3 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：新增 order

HiddenHttpMethodFilter：浏览器 form 表单只支持 GET与 POST 请求，而DELETE、PUT 等 method 并不支持，Spring3.0 添加了一个过滤器，可以将这些请求转换为标准的 http 方法，使得支持 GET、POST、PUT 与DELETE 请求。

web.xml中配置:

 <!--配置org.springframework.web.filter.HiddenHttpMethodFilter:可以把POST请求转为DELETE　或　PUT　请求-->
    <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>

controller类中添加:

    /*
    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 注解
   */

    //get请求
    @RequestMapping(value = "/testRest/{id}",method = RequestMethod.GET)
    public String testRest(@PathVariable("id") Integer id){
        System.out.println("testRest GET :" + id);
        return SUCCESS ;
    }
    //post请求
    @RequestMapping(value = "/testRest",method = RequestMethod.POST)
    public String testRest(){
        System.out.println("testRest POST");
        return SUCCESS ;
    }
    //delete请求
    @RequestMapping(value = "/testRest/{id}",method = RequestMethod.DELETE)
    @ResponseBody
    public String testRestDelete(@PathVariable("id") Integer id){
        System.out.println("testRest Delete :" + id);
        return SUCCESS ;
    }
    //put请求
    @RequestMapping(value = "/testRest/{id}",method = RequestMethod.PUT)
    @ResponseBody
    public String testRestPut(@PathVariable("id") Integer id){
        System.out.println("testRest PUT :" + id);
        return SUCCESS ;
    }

• jsp页面:
  浏览器 form 表单只支持 GET与 POST 请求，所以对于DELETE和PUT 需要利用POST，在表单中添加一个隐藏域，name属性为_method，value为DELETE和PUT 。
  如:<input type="hidden" name="_method" value="PUT">。然后被HiddenHttpMethodFilter拦截，使得相应的controller方法处理。

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>TestHiddenHttpMethodFilter</title>
</head>
<body>
    <%--get获取--%>
    <a href="springmvc/testRest/1">Test Rest Get</a>
    <br><br>
    <%--post 新增--%>
    <form method="post" action="springmvc/testRest">
        <input type="submit" value="submit">
    </form>
    <br><br>
    <%--delete 删除--%>
    <form method="post" action="springmvc/testRest/1">
        <input type="hidden" name="_method" value="DELETE">
        <input type="submit" value="TestRest DELETE">
    </form>

    <br><br>
    <%--PUT 更新 --%>
    <form method="post" action="springmvc/testRest/1">
        <input type="hidden" name="_method" value="PUT">
        <input type="submit" value="TestRest PUT">
    </form>
</body>