前端要知道的RESTful API架构风格

张张

修改于 2019-12-27 10:25:04

9030

修改于 2019-12-27 10:25:04

前端程序员在开发完页面后总是要对接口的，跟后端联调有时候还占用蛮大的时间的，那么你了解你和后端对的接口都是什么风格吗，你们公司接口设计的如何，你使用愉快吗？自己在写Node服务时你遇到如何定义好接口的问题吗？下面介绍一种API架构风格，也是目前主流的API设计风格，你或许一直在使用。

RESTful API 示例

REST是什么？

如果有人这么问你，你可以非常言简意赅的告诉他：“REST是一个风格！”，用英文说就是 Style，那他是什么风格呢？它是万维网软件架构风格。

风格这个词是非常关键的，因为它告诉我们，REST 不是协议，也不是什么硬性的规范，仅仅就是一种架构风格而已。是一组架构约束条件和设计指导原则，一种基于HTTP、URI、XML 等现有协议与标准的开发方式。

为何叫REST？

REST并不是REST这个单词休息的意思，而是 Representational State Transfer 的缩写，表示表述性状态转移，这个说明比较晦涩抽象，难以理解。接下来拆开解释。

Representational：在整个词语中表示“数据的表现形式”，如（JSON、XML……）,REST其实对数据的传输是不做任何限制的，尽管它不做任何限制，但我们在写REST服务时的最佳实践还是用JSON比较多。
State：当前状态或者数据。什么意思呢？比如说我们写了一个用户接口，一个用户列表或单个用户的数据，比如说姓名性别这些都是 State 都是数据，在 REST 这个词组里为什么要用 State 来代表这些数据呢？因为如果我们对数据进行增删改查那么数据就变了，在变化的每一个阶段它都是一种状态，从状态1变到状态2等等，用状态来描述数据更好的显示了数据是会变化的是会被我我们所修改的。
Transfer：数据传输。在 REST 这个词组里它代表的是数据在互联网上进行传输，比如从服务端传输到客户端。

其实 REST 的字面意思是很难表达它的精髓的，接下来我们通过 REST 的 6 个限制来详细了解它。这6个限制是REST的精髓，是它的重中之重，在面试中会经常考到。

REST的六个限制

REST给出了6种约束条件，通信两端在遵循这些约束后，就能提高工作效率，改善系统的可伸缩性、可靠性和交互的可见性，还能促进服务解耦。

客户端-服务器（Client-Server）

这个限制其实已经非常常见了，现在几乎没有什么不是CS架构的，所以它也是没有任何争议的，值得一提的是这个限制的本质其实是一种软件架构思想，叫做分离关注点，所谓关注点分离，用大白话说其实就是各扫门前雪，自己管好自己的事。这里是指服务端专注数据存储，提升了简单性；前端专注于用户界面，提升了可移植性。

无状态（Sateless）

所谓无状态就是所有用户会话信息都保存在客户端，意思就是所有的会话信息服务端都不管，不要妄想让服务端存着你的用户信息、用户会话信息、当前所处的状态，服务端都不知道，因为服务端不管事了，所以每次请求必须包括所有信息，不能依赖上下文信息。

无状态有什么好处？好处就是服务端不用保存会话信息，提升了简单些、可靠性、可见性。

简单性。服务端少了很多代码自然就简单了。
可靠性。可靠性是指一个软件的稳定程度，以及它从依次故障中恢复正常的能力。为什么说它提升了可靠性呢？因为如果服务端要管用户的会话信息的话，一旦服务端出错出现故障用户会话信息就会完全丢失，想要恢复起来机会是不可能的，所以说它的可靠性就会很差，但如果服务端不管你用户会话信息的话，那么从故障中恢复起来就回非常的容易。
可见性。是指在软件工程中这些模块、接口之间的透明程度。为什么说提升了可见性了呢？因为每次请求都必须包括所有信息，所以说接口之间就更加透明了。

缓存（Cache）

这个很好理解。是指所有服务端响应都要被标为可缓存或不可缓存，响应的资源可以被标记为可缓存或禁止缓存，如果可以缓存，那么客户端可以减少与服务器通信的次数，降低延迟、提高效率。

统一接口（Uniform Interface）

这个限制是所有限制中最重要的一个，别的限制如果不是在 REST 里面也可以遵循，比如CS架构，现在生活中几乎都是CS架构了，也不一定是REST风格，比如缓存，别的风格也可以用到缓存。但是只有统一接口凸出了REST的特点，区别于其他架构风格的核心特征。（后面详细讲解）

统一接口是什么意思呢，我们分开来看：

统一。所谓统一指的是接口设计尽可能通用统一，遵循同一个规范，提升了简单性、可见性。
接口。接口与实现解耦，使前后端可以独立开发迭代。

分层系统（Layers）

这个限制的意思是，软件架构是分很多层的，而且每一层只知道相邻额有一层，后面隐藏的就不知道了，比如客户端不知道自己是在和代理还是在和真实的服务器通信，这里的代理就是软件分层中的一层，其它层比如：安全层、负载均衡层、缓存层等。

按需代码（Code-On-Demand 可选）

这是一条可选的限制，也不是很重要。所谓按需代码是指客户端可以下载运行服务端传来的代码（比如JS），按需代码的好处是通过减少一些功能，简化了客户端。

统一接口的限制详细

统一接口的限制的风格到底长什么样？下面说一下这个限制的子限制，接口定义包括4个部分。

资源的标识。资源是任何可以命名的事物，比如用户、评论等。REST整个都是围绕资源展开的，不像其它一些风格可能是以动词形式，REST里面的资源都是一些名词，不仅如此，每个资源都可以被URI唯一的标识。
通过表述对资源执行操作。表述就是 Representational ，比如JSON、XML等。反过来理解，客户端不能直接操作（比如SQL）服务端资源，客户端只能通过表述（比如JSON）来操作资源，我觉得这个很好理解。
自描述的消息。每个请求或响应必须提供足够的信息让接受者理解，这些消息是指比如媒体类型、HTTP方法、是否缓存
超媒体作为应用状态引擎。超媒体：带文字的链接，应用状态：一个网页；引擎：驱动、跳转，其实意思就是点击链接跳转到另一个网页或者另一个JSON。