写点什么

超媒体 API 引发的 REST 生存危机

  • 2014-04-04
  • 本文字数:2054 字

    阅读完需:约 7 分钟

几周以前,软件开发者 Evan Cordell API-Craft 邮件组中引发了一场对话,就关于 REST 在超媒体方面的约束,与常见 Web API 需求之间如何存在分歧进行了讨论。

在讨论“REST 的生存危机(RESTisential crisis)”话题的时候,Cordell 注意到,经过数年之久的辩论和实践,REST 风格终于开始透露出它藏得最深的秘密——超媒体约束。尽管 Web 证明了 REST 风格完美适用于人类驱动的交互,但对于它在一般性可编程 Web API 方面的效用的担心,在 Web API 社区中却似乎在不断上升。

在这场讨论中,他首先给出了 REST 的描述,以及在面向特定领域 Web API 时超媒体的制约,接下来考虑了对其他架构风格的需求,选用 REST 中最好的部分,并替换掉其中的一些约束,以获得不同的价值,例如有效和可靠的 M2M(Machine-to-Machine)通讯。

讨论中所列出的主要担忧,涉及了不同的途径,用来应对接口随着时间推移而产生的变更。第一套解决方案要求并行运行若干 API 版本,甚至若干 API 编配以用于特定客户端体验,例如Netflix 所展示的做法。其灵活性方面则需要面对设计和运营方面的重大挑战。

第二个解决方案要求预先投入更多的努力,来设计一套更易于应对变化的RESTful 超媒体API,并限制对客户端的影响——就像HTML 浏览器和服务器的工作和演进那样。但部分讨论参与者(特别是Web 工程师 Mike Kelly )对此表达了自己的担心,主要集中在实现该方案涉及的复杂度和 API 使用者需要承担的额外负担方面。以下是讨论摘要,包括对 Evan 最初帖子内容和章节标题的摘录:

1) 好的 API 不会发生变化

  • 考虑一下 Joshua Bloch 在设计公共 Java API 方面的经验,我们似乎可以认为,相同的规则也可以运用到可编程 Web API 上。
  • API 是遵循外观模式的接口,面向客户端的部分不应该发生变化。然而,可以将多重或演进的实现(包括运行时数据)暴露出来,而无须改变 API 约定。

2) 版本管理不起作用

与“传统”API 相比,“Web API”公开出来的内容要多得多。它暴露出数据;而且对于持续变化数据的大型集合,它通常还会把其当前状态公之于众。那么,当我们的领域模型拥有两个版本,它们共享部分数据子集但使用不同方式访问的时候,该如何有效的进行版本管理?这会强迫客户端发生分裂。

  • 超媒体能够帮助 API 演进并变得不那么脆弱,但是如果数据和领域模型发生根本性改变,那么在没有开发者人工介入的情况下,客户端将无法自动适配这些变动。

3) 超媒体毁掉了资源定位

  • REST 阻止了来自客户端的固定 URI 和任何关于服务器资源的先验知识。在实践中,保存了 URI(例如书签)和服务器的客户端,需要处理其 URI 空间的演变(重定向)。
  • 超媒体无法将 API 提供者与 API 使用者的惰性行为隔离开,后者将不会遵循恰当的超媒体流,而是直接针对目标资源和 URI。
  • 由于超媒体 API 往往非常复杂,难以理解和使用,所以开发者将必然会优化其客户端并采用捷径——而这将会使为了将 API 变更与客户端隔离的所有努力化作泡影。

4) 对人类用户来说,超媒体富有意. 义;但对机器则并非如此

  • 机器并不善于处理随时间推移发生的变化,相反人类则非常擅长解读变更并决定下一步想要做什么。超媒体与人类在本质上非常贴近,而对机器来说这意味着相当程度的隔阂。
  • 领域模型方面的变动,要求客户端使用它的方式也发生改变,超媒体并没有对此采用什么特别的手法。

一个真正的 REST/ 超媒体客户端,其实是人机交互(HCI)的一种形式,而不是 API。(或者说,是 AHI——应用与人交互)。

5) 带外数据究竟有什么坏处?

  • API 是否真的有必要天生可发现?
  • 当 API 响应的格式具有高度复杂性、难以阅读的时候,API 凭什么应该具有自我说明性(self documenting)?
  • 真正易于阅读的材料应该是:组织结构精妙的 HTML、由浏览器渲染、具有交互式例子和清晰的描述。

6) 超媒体 API 与 WADL 真的不一样吗?

可发现的超媒体 API 有什么不同?“HAPI”看上去就像是一套 WADL 弥漫其中的 API。我们依旧必须从单独一个端点开始,依旧必须了解基于其响应,我们可以用 API 干什么。

  • 其中部分必须具有领域模型的描述,而它们还将随时间推移发生改变。

7) Web 的模拟

  • 假定这样一个场景:在原生移动应用中使用 REST API,我们拥有两门语言(Android ML 和 iOSMLS,分别拥有所需的代码);
  • 使用针对特定领域的超媒体媒体类型,依旧需要编写能够理解这一领域的客户端代码。

8) 关于 REST,有哪些是真正的优点?

  • 除了超媒体和文档网(Web of documents)外,REST 还提供:

    • 强制要求无状态服务器,从而使其易于扩展
    • 鼓励通过资源将信息解耦合

基础内容非常简单,我们可以与服务器以语义上富有意义的方式进行对话,而且只需要在所有平台和语言中包含 http 库即可。

以上摘要包含了对若干讨论参与者回复内容的摘抄,特别是 Evan Cordell,以及 Mike Amundsen、Jorn Wildt 和 Mike Kelly。作为免责声明,需要指出的是,本文作者也在开始阶段参与了这场讨论。

从自身的经验来看,各位读者是否认为我们需要更好地区分 REST 和 Web API 架构风格,区分人类驱动超媒体和 M2M 通讯的使用案例?

查看英文原文: RESTistential Crisis over Hypermedia APIs

2014-04-04 03:303434
用户头像

发布了 256 篇内容, 共 82.8 次阅读, 收获喜欢 10 次。

关注

评论

发布
暂无评论
发现更多内容

极客时间【架构实战营】第二期 模块二作业

Geek_91606e

架构实战营

架构实战营-模块二作业

^_^

架构实战营

k8s garbage collector源码分析(2)-处理逻辑分析

良凯尔

Kubernetes 源码分析 Kubernetes源码 #Kubernetes#

设计微博系统中”微博评论“的高性能高可用计算架构

架构0期-Bingo

微信朋友圈高性能架构

Geek_db27b5

0基础架构入门 - 2(架构设计复杂度模型和应对之道)

felix

架构实战营 0基础架构入门

Python开发篇——添加mysqlclient

吴脑的键客

Python MySQL

Prometheus relabel 透析与实战

卓丁

Prometheus relabel_config

从基础到实战!阿里P9用28天,总结出这份亿级活动高并发系统设计手册

Java 架构 面试 后端 高并发

双非本科跨专业5面京东,8600小时后收到通知,流下喜悦泪水

Java~~~

Java 架构 面试 微服务 JVM

激动!阿里技术官纯手打,1263页并发编程全系笔记,限时开源

Java~~~

Java 架构 面试 多线程 并发

【架构实战营作业】模块二——朋友圈高性能架构

聆息

图解 | Linux内存回收之LRU算法

程序员 架构 面试

k8s garbage collector源码分析(1)-启动分析

良凯尔

Kubernetes 源码分析 Kubernetes源码 #Kubernetes#

Java + opencv 实现老照片特效滤镜

张音乐

OpenCV 图像处理 9月日更 特效 老照片

惊讶!阿里大佬总结的图解Java小册火了,完整版笔记开放下载

Java~~~

Java 架构 面试 微服务 JVM

阿里技术专家,紧跟潮流,解读spring微服务架构技术的演进

Java~~~

Java 架构 面试 微服务 Spring Cloud

香!阿里技术官甩我一份283页Java核心笔记,竟含9大核心

Java~~~

Java 架构 面试 JVM 多线程

🌏【架构师指南】带你彻底认识Paxos算法、Zab协议和Raft协议的原理和本质

码界西柚

ZAB raft协议 paxos协议 9月日更

算法2021版第0期毕业总结

bin

Go- 接口-3

HelloBug

interface Go 语言

阿里进阶专用:Mycat权威指南,不怕从零开始,只怕从未启程

Java~~~

Java MySQL 数据库 架构 面试

架构作业 - 模块一

Leo Zhao

架构实战营

背完这套Java面试八股文,自动解锁面试牛逼症被动技能

北游学Java

Java 数据库 面试 算法 开发框架

架构师实战营 附一作业(按接口隔离原则优化设计无人机引导直升机攻击的类图)

代廉洁

架构实战营

Django 配置夯实,再补充几个配置项,够够的了

梦想橡皮擦

9月日更

奉若神明!阿里技术专家开源ApacheDubbo核心源码笔记

Java~~~

Java spring 架构 面试 dubbo

阿里技术专家亲码:满干货“Redis核心笔记”,全篇无尿点

Java~~~

Java redis 架构 面试 中间件

字节面试官狂问我:如何设计一个高并发系统?

Java架构师迁哥

谈 C++17 里的 Builder 模式

hedzr

c++ 设计模式

Fil价格强势上涨!fil的行情走势如何?Fil未来五年多少钱一枚?

区块链 分布式存储 fil币未来价格预估消息 fil大涨 fil价格行情

超媒体API引发的REST生存危机_语言 & 开发_Jerome Louvel_InfoQ精选文章