SpringMVC之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 用来删除资源。

REST风格示例：

– /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 请求。

示例：

/**
 * Rest风格的URL
 * 以CRUD为例
 * 新增：/order POST
 * 修改：/order/1 PUT
 * 获取：/order/1 GET
 * 删除：/order/1 DELETE
 * @param id
 * @return
 */

@RequestMapping(value = "/testRest/{id}",method = RequestMethod.PUT)
    public String testRestPut(@PathVariable("id") Integer id){
        System.out.println("testRest PUT: " + id);
        return SUCCESS;
    }

@RequestMapping(value = "/testRest/{id}",method = RequestMethod.DELETE)
    public String testRestDelete(@PathVariable("id") Integer id){
        System.out.println("testReset DELETE: " + id);
        return SUCCESS;
    }

@RequestMapping(value = "/testRest",method = RequestMethod.POST)
    public String testRestPost(){
        System.out.println("testRest POST");
        return SUCCESS;
    }

@RequestMapping(value = "/testRest/{id}",method = RequestMethod.GET)
    public String testRestGet(@PathVariable("id") Integer id){
        System.out.println("testRest GET: " + id);
        return SUCCESS;
    }

jsp：

<form action="test/testRest/1" method="post">
      <input type="hidden" name="_method" value="PUT">
      <input type="submit" value="testRest PUT"/>
  </form>
  <br><br>
  <form action="test/testRest/1" method="post">
      <input type="hidden" name="_method" value="DELETE">
      <input type="submit" value="testRest DELETE"/>
  </form>
  <br><br>
  <form action="test/testRest" method="post">
      <input type="submit" value="testRest POST"/>
  </form>
  <br><br>
  <a href="test/testRest/1">Test Rest GET</a>
  <br><br>

  控制台结果：

 总结：

如果需要发送DELETE和PUT请求，需要进行如下操作：

1、需要在web.xml中配置HiddenHttpMethodFilter；
2、需要发送 POST 请求；
3、需要在发送POST请求时携带一个name="_method"的隐藏域，值为DELETE或PUT。

SpringMVC如何在方式中获取URL里面的占位符呢？

使用@PathVariable注解即可。

@RequestParame

@RequestParam：把请求参数传递给请求方法
value：值即请求参数的参数名称
required：该参数是否必须，默认true
defaultValue：参数默认值

示例：

 @RequestMapping("/testRequestParam")
    public String testRequestParam(@RequestParam(value = "username") String username,
                                   @RequestParam(value = "age", required = false, defaultValue = "0") int age){
        System.out.println("testRequestParam: username= " + username + ",age=" + age);
        return SUCCESS;
    }

jsp：

<a href="test/testRequestParam?username=java&age=11">testRequestParam</a>

 @ReuqestHeader

用法同@RequestParam，用于获取请求头信息传入方法参数。

示例：

@RequestMapping("/testRequestHeader")
    public String testRequestHeader(@RequestHeader("User-Agent") String ua){
        System.out.println("testRequestHeader: User-Agent= " + ua);
        return SUCCESS;
    }

控制台输出

testRequestHeader: User-Agent= Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/65.0.3325.181 Safari/537.36

@CookieValue

绑定请求中的Cookie值到方法参数中，用法同@RequestParam

示例：

RequestMapping("/testCookieValue")
    public String testCookieValue(@CookieValue(value = "JSESSIONID") String seesionId){
        System.out.println("testCookieValue: seesionId = " + seesionId);
        return SUCCESS;
    }

对应jsp：
<a href="test/testCookieValue">test testCookieValue</a>

控制台：

testCookieValue: seesionId = 660443E054FC195D5DAD798AEF32CBCD

和开发者工具的cookie值是一样的：