首页 > 代码库 > 《Spring实战》读书笔记--使用SpringMVC构建REST API

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

《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中的典型应用:

资源GETPUTPOSTDELETE
一组资源的URI,比如http://example.com/resources/ 列出URI,以及该资源组中每个资源的详细信息(后者可选)。 使用给定的一组资源替换当前整组资源。 在本组资源中创建/追加一个新的资源。该操作往往返回新资源的URL。 删除整组资源。
单个资源的URI,比如http://example.com/resources/142 获取指定的资源的详细信息,格式可以自选一个合适的网络媒体类型(比如:XML、JSON等) 替换/创建指定的资源。并将其追加到相应的资源组中。 把指定的资源当做一个资源组,并在其下创建/追加一个新的元素,使其隶属于当前资源。 删除指定的元素。

实现举例:
列出所有物品: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="http://www.mamicode.com/springMVC")
 3 public class UserController {
 4     @RequestMapping(value="http://www.mamicode.com/login", method=RequestMethod.GET)
 5     public String login() {
 6     return "login";
 7     }
 8 
 9     @RequestMapping(value="http://www.mamicode.com/hello")
10     @ResponseBody
11     public User hello(@RequestParam(value="http://www.mamicode.com/username") String username, 
12         @RequestParam(value="http://www.mamicode.com/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

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