关于RESTful的六个限制

前言

RESTfulapi是开发中常用的概念，那什么是REST，什么又是RESTfulapi？

REST介绍

REST是Representational State Transfer的缩写
Representational :数据的表现形式(JSON、XML...)
State:当前状态或者数据
Transfer：数据传输
看字面意思还是不太懂，没关系，接着看：
标准的 REST 六个限制如下：

1.客户端-服务器

参考内容：客户端-服务器模型

• 关注点分离
• 服务端专注数据存储，提升简单性
• 前端专注用户界面，提升可移植性

2.无状态

参考内容：无状态协议

• 所有用户会话信息都保存在客户端
• 每次请求必须包括所有信息，不能依赖上下文信息
• 服务端不用保存会话信息，提升简单性、可靠性、可见性

3.缓存

参考内容：网页缓存

• 所有服务端响应都要被标为可缓存或不可缓存
• 减少前后端交互，提升了性能

4.统一的接口

统一接口约束是设计任何REST服务的基础。

• 接口设计尽可能统一通用，提升了简单性、可见性
• 接口与实现解耦，使前后端可以独立开发迭代

5.分层系统

参考内容：分层系统

• 每层只知道相邻的一层，后面隐藏的就不知道了
• 客户端不知道是和代理还是真实服务器通信
• 其他层： 安全层，负载均衡，缓存层等

6.按需代码（可选）

参考内容：客户端脚本

• 客户端可以下载运行服务端传来的代码(比如JS)
• 通过减少一些功能，简化了客户端

统一的接口

上文中提到了REST的6个限制，其中统一的接口需要统一成什么样子的呢？
1.资源的标识

• 资源是任何可以命名的事物，比如用户，评论等
• 每个资源通过URI被唯一地标识
  2.通过表述来操作资源
• 表述就是Representation，比如JSON,XML等
• 客户端不能直接操作(比如SQL)服务端资源
  3.自描述的消息
• 每个信息(请求或响应)必须提供足够的信息让接受者理解
• 媒体类型(application/json、application/xml)
• HTTP方法：GET(查)、POST(增)、DELETE(删)等
• 是否缓存：Cache-Control
  4.超媒体作为应用程序状态的引擎（HATEOAS）
• 超媒体：带文字的链接
• 应用状态：一个网页
• 引擎：驱动、跳转
• 合起来：点击链接跳转到另一个网页

RESTfulapi介绍

RESTfulapi就是符合REST风格的api

RESTfulapi的设计规范

1.请求设计规范

• URI使用名词，尽量用复数，如/users
• URI使用嵌套表示关联关系，如/users/12/repos/5
• 使用正确的HTTP方法，如GET/POST/PUT等
• 不符合CRUD的情况：POST/action/子资源

2.响应式设计规范

• 查询
• 分页
• 字段过滤
• 状态码
• 错误处理

3.安全设计规范

• HTTPS
• 鉴权
• 限流

4.开发中友好设计规范

• 文档
• 超媒体