REST解惑

简介:

本文是「架构风格:你真的懂REST吗?」的补充!

REST全称是Representational State Transfer,目前普遍接受的中文翻译为「表述性状态转移」!

即使翻译过来了,你依然有一堆疑问:

  • 什么是「表述性」的?
  • 什么是状态?
  • 什么是转移?
  • 转移的是什么?

所以本文试图回答如下几个问题:

  • 为什么要叫REST这个名字?
  • 什么是状态、资源、表述?
  • 以及它们之间有什么关系?
  • 什么是转移(Transfer)、变迁(transitions)?转移什么?变迁什么?

为什么叫REST?

为什么Fielding博士要取这么个难以理解的名字呢?其实REST论文的第六章给出了明确的答案:

REST was originally referred to as the "HTTP object model," but that name would often lead to misinterpretation of it as the implementation model of an HTTP server. The name "Representational State Transfer" is intended to evoke an image of how a well-designed Web application behaves: a network of web pages (a virtual state-machine), where the user progresses through the application by selecting links (state transitions), resulting in the next page (representing the next state of the application) being transferred to the user and rendered for their use.
REST本来是想叫「HTTP object model」的,但是这个名字会给人误解,让人误以为REST是一个HTTP服务器的实现。叫REST这个名字的目的是为了暗示一个「设计良好的Web应用」应该有怎样的行为:一个由web页面组成的网(一个虚拟状态机),用户通过选择链接在应用中前进(状态变迁),用户的选择会导致下一个页面(代表应用的下一个状态)被转移到用户端、并被渲染出来以供使用!


Tips:注意上面括号里的单词(state transitions),这里是transitions而不是transfer。transitions表示的是过渡、切换、变迁,比如场景的切换,就是从一个场景到了另一个场景。这里是从一个状态切换到了另一个状态。REST中文文档里,还是将其翻译成了「转移」,应该是不正确的!


网上很多讨论REST的文章或帖子,关注的点有两个:

  • Representational应该怎么翻译?是「表述」还是「表述性」
  • Transfer应该怎么翻译?是「转移」还是「传输」

而从上面这段话,你会发现,重点既不是Representational、也不是Transfer,而是State!你有没有觉得上面所提到的State和你平时所理解的State有差异?或者说比较违和?

我们都知道,要保证服务端的伸缩性,就要确保服务端是无状态的!如果是「无状态」的,那么为什么有「状态的变迁」呢?难道REST没有伸缩性?显然不是,要知道,Web可是现今伸缩性最好的系统!

所以这里所指的State与我们平时所说的State不是一个概念!这里的State是「应用状态」,我们所说的State是「资源状态」(这里所说的资源和REST中所指的资源也是不一样的,下面会说到)!

先说应用状态,在上文中,可以看到。应用状态指的是一个个的Web页面!Web页面上有链接,你点击链接后,这个链接所对应的「应用状态」会从服务器「转移」到客户端,渲染出来,展示给你。你就「切换」到了下一个「应用状态」!

所以「State Transfer」指的是:「应用状态」从服务端「转移」到了客户端,导致客户端的「应用状态」从当前状态「变迁」到了下一个状态

资源与表述

在解释「资源状态」之前,要先来解释一下什么是「资源」?什么是「表述」?

早期URI设计时,「资源」表示的是「文档」!它假设万维网里转移的都是文档!现在看来,显然不是!REST对「资源」进行了抽象!

一般我们对资源的理解是「可以在万维网里转移的任何内容」,比如:网页、图片、视频等!但实际上,REST论文中给出的定义和我们平常所理解的「资源」差异还是很大的!

REST论文中给出的解释:

The resource is not the storage object. The resource is not a mechanism that the server uses to handle the storage object. The resource is a conceptual mapping -- the server receives the identifier (which identifies the mapping) and applies it to its current mapping implementation (usually a combination of collection-specific deep tree traversal and/or hash tables) to find the currently responsible handler implementation and the handler implementation then selects the appropriate action+response based on the request content.
资源不是存储对象!也不是服务器处理存储对象的机制!资源是一个概念上的映射关系:服务器接收到标示符(这些标示符标示了这个映射关系),将其应用到当前的映射实现上(一般是特定集合【深度遍历的树和/或哈希表】的组合)来找到当前负责处理该请求的处理器、这个处理根据请求内容选择合适的动作+响应

我用一段伪代码来解释一下!

var mappingImpl = {'/pathA':handlerA,'/pathB':handlerB,'/pathC':handleC,...}

mappingImpl.get('/pathB').handle(req);
  • mappingImpl就是映射实现,包含了所有URI到处理器实现的映射关系!
  • '/pathB':handlerB这个映射关系就是「资源」!
  • mappingImpl.get('/pathB')就是根据URI获取到负责处理该请求的处理器
  • handle(req)就是根据请求内容来选择合适的动作+响应

按照这个定义的话,实际上REST中所指的「资源」和我们平常所指的「资源」根本不是同一个东西:

  • REST中的资源指的是URI到针对这个URI的处理器之间的映射关系
  • 我们平常所指的资源,对应到REST中实际上是这个处理器处理后的返回结果

你会发现,REST中的资源是个「动态」的东西,而我们所说的资源是个「静态」的东西,或者说就是个类型多样化的「文档」而已!

用伪代码表示的话就是:

var resourceMap = {'/pathA':resourceA,'/pathB':resourceB,'/pathC':resourceC,...}

resourceMap.get('/pathB');

实际上,现代Web应用中,绝大部分URI标示的都是动态的内容!所以在这一点上,REST对资源的定义更加的准确!

你可能会说,这两者的区别可能不是那么大,因为无论资源指的是关系还是处理结果,我们最终都是看到的是一样的内容!你确定吗?

假设资源就是我们平常所理解的「返回结果」:

  • 上面说到的,返回内容中包含了链接,客户端可以通过链接变迁到下一个状态,链接和资源怎么同时返回?
  • 如果URI指定的那个资源不存在的话,应该返回什么呢?
resourceMap.getOrDefault('/pathD','这里该返回什么?');

返回「空资源」?那什么是「空资源」,如何表示「空资源」?null吗?那客户端又如何处理这个特殊的null呢?或者说是一个「Null资源」?「Null资源」是资源吗?既然是没有资源,那还叫资源吗?是不是很拗口?

REST通过表述来解决这个问题:

  • 表述就是处理器返回的结果
  • 包含了链接(操作)和内容(响应)
  • 如果没有内容,那么返回的就是一个没有内容的表述
mappingImpl.getOrDefault('/pathD',defaultHandler).handle(req); 
// 如果找不到对应的处理器就用默认处理器处理。
//如果找不到请求内容对应的响应,就返回一个没有内容的表述

上面所说的Web页面就是一种表述,也就是说表述是「应用状态」

所以对REST的理解应该是:通过链接,以表述的方式,将应用状态从服务端转移到客户端

解释完资源和表述,最后来解释一下「资源状态」!

资源状态

很多关于RESTful的博文,主要讲的是:

  • URI要怎么设计
  • 要用POST创建资源
  • 要用PUT更新资源
  • 要用DELETE删除资源
  • 要用GET获取资源

以User为例:

GET /users        // 获取用户列表
GET /user/1      // 获取ID为1的用户信息
POST /user       // 创建用户
PUT  /user/1     // 更新ID为1的用户信息
DELETE /user/1  // 删除ID为1的用户信息

这里的POST,PUT,DELETE改变的是「资源状态」!和上面所说的「应用状态」是两回事!很多地方都没有明确的区分开来!

记得当初看JVM的时候,也有类似的情况!JVM中有三个栈,虚拟机栈、操作数栈和本地方法栈。很多地方都直接叫做栈,这就导致了理解的混乱!前面说一个方法的调用就是将对应的栈帧入栈;后面又说指令的执行,对应的操作数入栈。实际上前一个栈指的是虚拟机栈,后一个栈指的是操作数栈!

在这里情况类似,状态没有区分开,也会导致理解的混乱!前面说「状态的转移」,这里又说「状态的改变」!一个是「应用状态的转移」,一个是「资源状态的改变」!

如果按照上面对资源的理解的话,这里的状态其实不应该叫「资源状态」,而应该是「内容状态」!

REST完整流程

下面以User的CRUD为例,来说明一下REST的完整流程:

  • 访问/users链接,服务端找到该URI对应的处理器,对请求进行处理,将包含了User列表内容的表述转移到客户端
  • 客户端展示该表述。表述中包含了到新增User页面的链接、到编辑User页面的链接、删除User的链接等操作链接
  • 用户点击到新增User页面的链接,服务端转移新增User的表述。客户端「应用状态」变迁到新增User页面
  • 用户填写信息,点击提交按钮。服务器处理该请求,将一条新的用户信息添加到数据库,导致了User「内容状态」变化。同时将新的包含了User列表内容的表述转移到客户端
  • 客户端「应用状态」又进入到了User列表页面
  • ......

参考资料

目录
相关文章
|
前端开发 Java 关系型数据库
最好用的七大顶级 API 接口测试工具
现在 API 接口已经成为软件开发重要的组成部分,由于 API 并没有 GUI 图形界面,无法直观的对接口进行测试,所以对于前后端开发来说,找到一套趁手的工具对 API 接口进行测试,了解开发的程序是否符合预期十分重要。面对批量的 API,手动测试变得非常低效,自动化 API 接口测试工具,帮我们提高测试效率的同时,更能帮我们保证程序的稳定和安全性。
3441 0
最好用的七大顶级 API 接口测试工具
|
2月前
|
前端开发 关系型数据库 API
深入浅出后端开发——从零到一构建RESTful API
本文旨在为初学者提供一个关于后端开发的全面指南,特别是如何从零开始构建一个RESTful API。我们将探讨后端开发的基本概念、所需技术栈、以及通过实际案例展示如何设计和实现一个简单的RESTful API。无论你是完全的新手还是有一定编程基础的开发者,这篇文章都将为你提供实用的知识和技巧,帮助你在后端开发的道路上迈出坚实的一步。
|
3月前
|
存储 API 数据库
深入浅出后端开发:从零到一搭建RESTful API
在数字化的浪潮中,后端开发如同一座桥梁,连接着用户界面与数据存储。本文将引导你理解后端开发的核心概念,并通过实践案例,展示如何从零开始构建一个RESTful API。我们将探索设计原则、选择合适的编程语言和框架、数据库交互以及API测试等方面。无论你是初学者还是希望巩固知识的开发者,这篇文章都将为你提供一条清晰的学习路径。
|
4月前
|
存储 JSON API
实战派教程!Python Web开发中RESTful API的设计哲学与实现技巧,一网打尽!
在数字化时代,Web API成为连接前后端及构建复杂应用的关键。RESTful API因简洁直观而广受欢迎。本文通过实战案例,介绍Python Web开发中的RESTful API设计哲学与技巧,包括使用Flask框架构建一个图书管理系统的API,涵盖资源定义、请求响应设计及实现示例。通过准确使用HTTP状态码、版本控制、错误处理及文档化等技巧,帮助你深入理解RESTful API的设计与实现。希望本文能助力你的API设计之旅。
81 3
|
5月前
|
存储 设计模式 API
深入浅出后端开发:从零到一构建RESTful API
【8月更文挑战第29天】本文旨在引导读者理解后端开发的精髓,并通过实际代码示例,展示如何从无到有构建一个RESTful API。文章首先解释后端开发的基本概念,然后逐步深入到API设计的原则和最佳实践,最后通过一个具体的代码示例,让读者能够动手实践,体验后端开发的乐趣。
|
存储 JSON 监控
通俗易懂讲清 API
无论是在科技行业还是其他地方,我遇到很多人对这个相当普遍的术语有着模糊的理解。从技术上讲,API 代表应用程序编程接口,大多数大公司都曾为客户或内部使用构建过 API。但如何用简单的语言来解释 API 呢?除了开发和商业中使用的定义外,是否还有更广泛的含义?首先,让我们退后一步看看网络本身是如何运作的。
144 1
|
API UED 网络架构
API入门指南:从零开始学习API的基础知识和应用
API(Application Programming Interface)指应用程序接口,是一种计算机软件接口,它使不同的应用程序之间可以进行交互。API已经在现代软件开发中变得越来越重要,因为它们允许应用程序之间实现无缝的集成,从而提供更优质的用户体验。
1084 0
|
负载均衡 网络协议 Dubbo
卷起来了!手把手带你写一个中高级程序员必会的分布式RPC框架
什么是RPC? 远程服务调用 官方:一种通过网络从远程计算机程序上请求服务,而不需要了解底层网络技术的思想 通俗一点:客户端在不知道调用细节的情况下,调用存在于远程计算机上的某个对象,就像调用本地应用程序中的对象一样。 市面上常见的rpc框架:dobbo,springCloud,gRPC...
|
编解码 运维 负载均衡
深入浅出RPC框架|青训营笔记
由于课程涉及到的RPC知识需要自己对其有较为全面的理解后才能比较好的get到课程中提及的各种框架设计的点,因此我建议阅读Kitex框架的源码,再结合课程目录去体会Kitex设计的初衷。
195 0
深入浅出RPC框架|青训营笔记
|
XML JSON API
寻求 REST
寻求 REST
60 0