SpringMVC 3.RequestMapping，@PathVariable注解，REST

偏执的太偏执、 2022-05-26 20:05 235阅读 0赞

# @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中配置:**

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

[上一篇:SpringMVC 2.HelloWorld][SpringMVC 2.HelloWorld]

[下一篇:SpringMVC 4.请求处理方法签名][SpringMVC 4.]

[SpringMVC 2.HelloWorld]: https://blog.csdn.net/hgx_suiyuesusu/article/details/79980496
[SpringMVC 4.]: https://blog.csdn.net/hgx_suiyuesusu/article/details/79993030