0
点赞
收藏
分享

微信扫一扫

关于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.开发中友好设计规范

  • 文档
  • 超媒体
举报

相关推荐

0 条评论