《Spring实战》读书笔记--使用SpringMVC构建REST API

1. REST介绍

REST(Representational State Transfer)：表述性状态转移，是基于HTTP、URI、MIME(HTML、JSON等)协议的Web软件架构。它不同于SOAP Web服务(RPC)关注处理，面向行为，其更关注要处理的数据，面向资源。

1.1 《Spring实战》中是这样描述REST的：

为了理解REST是什么，我们将它的首字母缩写才拆分为不同的构成部分：

• 表述性(Representational)：REST资源实际上可以用各种形式来进行表述，包括XML、HTML、JSON及HTML---最适合资源使用者的任意形式。
• 状态(State)：当使用REST的时候，我们更关注资源的状态而不是对资源采取的行为。
• 转移(Transfer)：REST涉及转移资源数据，它以某种表述性从一个应用转移到另一个应用。

在REST中，资源通过URL进行识别和定位。REST中会有行为，它们是通过HTTP方法来进行定义的。这些HTTP方法通常匹配如下CURD动作：

• Create: POST
• Read: GET
• Update: PUT或PATCH
• Delete: DELETE

我是萌萌的分割线

1.2 wiki是这样描述REST的：

• 资源是由URI来指定。
• 对资源的操作包括获取、创建、修改和删除资源，这些操作正好对应HTTP协议提供的GET、POST、PUT和DELETE方法。
• 通过操作资源的表现形式来操作资源。
• 资源的表现形式则是XML或者HTML，取决于读者是机器还是人，是消费web服务的客户软件还是web浏览器。当然也可以是任何其他的格式。

RESTful API：符合REST设计风格的Web API，它从以下三个方面资源进行定义的：

• 直观简短的资源地址：URI，比如：http://example.com/resources/
• 传输的资源：Web服务接受与返回的互联网媒体类型，比如：JSON，XML，YAML，HTML等。
• 对资源的操作：Web服务在该资源上所支持的一系列请求方法（比如：POST，GET，PUT或DELETE）。

HTTP请求方法在RESTful API中的典型应用:

实现举例:
列出所有物品：GET http://www.store.com/products
呈现某一件商品: GET http://www.store.com/product/12345
呈现一些商品(过滤规则)：GET http://www.store.com/product/1022?limit=10(id为1022后的10件商品)
下单购买：
POST http://www.store.com/order <purchase-order> <item> ... </item> </purchase-order>

1.3 实现网站(自己找了几个网站看了看，有几个网站个人觉得API挺符合RESTful API)：
小米官网：看了几家购物网站，就觉得小米官网除了登录(估计安全原因)，其它的设计挺符合RESTful API
落网：一家音乐网站，其推荐的小众音乐挺不错的。因为其功能较为简单，所以其API看起来挺简洁的，一眼看上去就符合RESTful API

我是萌萌的分割线
1.4 私以为：
其实自己看了后，感觉不是太懂，模模糊糊的。下面简单说点自己的理解吧：

• 基于RESTful API 能够前后端分离，前端不管是web浏览器还是移动终端只要访问响应的API，就能够得到相应的资源。
• RPC(远程过程化调度)感觉就是基于服务的，更看重行为，一般直接从service层就暴露接口了。而REST上面所说是基于资源的，其一般从web层暴露接口(RESTful API)，它更看重对资源的行为(通过HTTP请求方法表现)，也就是说我们冲RESTful API中看不出行为来，仅仅能够看出操作资源。

1.5 设计好的RESTful API接口
RESTful API的设计原则

2.SpringMVC中的REST

2.1 大体结构
在一般的SpringMVC框架中处理流程如下：
当HTTP请求到达DispatcherServlet时，DispatcherServlet通过handlerMapping找到该URL对于的Controller后，DispatcherServlet会把HttpServletRequest转发给Controller处理(SpringMVC在这里做了许多的改进)。Controller处理完后会把Model and View传给DispatcherServlet，其会通过ViewResolver找到物理视图，然后把Model发给该视图中进行渲染，最后视图会响应HTTP请求，发送响应的数据。

REST在SpringMVC框架中处理流程如下：
当HTTP请求到达DispatcherServlet时，DispatcherServlet通过handlerMapping找到该URL对于的Controller后，DispatcherServlet会把HttpServletRequest转发给Controller处理(SpringMVC在这里做了许多的改进)在这里时，SpringMVC会通过消息转化器(Message Conversion)@RequestBody、@RequestMapping、@PathVariable接受响应的资源，GET、POST等方法标注行为。然后Controller调用service处理相关资源行为，最后在通过Message Conversion(@ResponseBody)返回数据。

2.2 支持的构件
SpringMVC在Controller中有许多的构件支持REST:

• HTTP方法构件。在@RequestMapping()参数中可以通过method=RequestMethod.GET 来指定响应的方法。
• 在@RequestMapping()参数中可以通过produces={"application/json;charset=UTF-8"} 来响应HTTP请求中的Accept字段，如果Request中Accept不支持该字段，则会返回HTTP 406 (Not Acceptable)响应。
• 在@RequestMapping()参数中可以通过consumes={"application/json"} 来响应请求中的Content-Type字段，如果Request中Content-Type不支持该字段，则会返回HTTP 415 ( Unsupported Media Type)响应。
• 获得数据构件。@ReqeustParam()可以获取Query String Parameters、Form Data等，@PathVariable()可以获取路径变量。
• 消息转换器(Message Conversion)转换消息。通过@RequestBody()可以把请求数据通过相关类库(如Jackson)转换Java对象，通过@ResponseBody()可以把Java对象数据通过相关类库(如Jackson)转换为Json对象。
• 可以在类级别使用@RestController。该类的所有方法都会默认的使用消息转化器，相当于每个方法都有@ResponseBody()注解。

2.3 Spring使用
导入Jackson

1 <dependency>
2     <groupId>com.fasterxml.jackson.core</groupId>
3     <artifactId>jackson-databind</artifactId>
4     <version>2.4.3</version>
5 </dependency>

JS

 1 function login(){
 2     var username = $(‘#username‘).val();
 3     var password = $(‘#password‘).val();
 4     var message = $(‘#message‘);
 5     if(username.length<6 || password.length <6){
 6         message.hide().html(‘用户或密码位数小于6位‘).show();
 7     }else{
 8         $.ajax({
 9             url : "/springMVC/hello",
10             type : "POST",
11             dataType : "text",
12             timeout : 10000,
13             data : {"username":username,"password":password},
14             success : function(result){
15                 console.log(result);
16             }
17         });
18     }
19 }

Controller

 1 @Controller
 2 @RequestMapping(value="/springMVC")
 3 public class UserController {
 4     @RequestMapping(value="/login", method=RequestMethod.GET)
 5     public String login() {
 6     return "login";
 7     }
 8 
 9     @RequestMapping(value="/hello")
10     @ResponseBody
11     public User hello(@RequestParam(value="username") String username, 
12         @RequestParam(value="username")String password) {
13         System.out.println(username + "\t" + password);
14         User user = new User(5,username);
15         return user;
16     }
17 }

HTTP Request

 1 POST /springMVC/hello HTTP/1.1
 2 Accept:text/plain, */*; q=0.01
 3 Accept-Encoding:gzip, deflate, br
 4 Accept-Language:zh-CN,zh;q=0.8
 5 Connection:keep-alive
 6 Content-Length:31
 7 Content-Type:application/x-www-form-urlencoded; charset=UTF-8
 8 Cookie:JSESSIONID=1mnbs1bxxlxvblq759pgltl8q
 9 Host:localhost:8080
10 Origin:http://localhost:8080
11 Referer:http://localhost:8080/springMVC/login
12 User-Agent:Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/57.0.2987.110 Safari/537.36
13 X-Requested-With:XMLHttpRequest
14 Form Data
15 view parsed
16 
17 username=132456&password=123456

HTTP Response

1 HTTP/1.1 200 OK
2 Content-Type:application/json;charset=UTF-8
3 Date:Wed, 12 Apr 2017 15:27:27 GMT
4 Server:Jetty(8.1.14.v20131031)
5 Transfer-Encoding:chunked
6 
7 {"id":5,"name":"132456"}

3.References

https://zh.wikipedia.org/wiki/REST