← 返回刚才阅读的位置

知识卡片

普通读书笔记卡 · 2306.e.1

互联网API把松耦合放首位

理解等级:中级

(REST 五个关键词的基本含义见旧卡“元模型与REST解耦”。)

统一接口的一个细节:对每个资源只能执行一组有限的操作,而且操作语义必须由 HTTP 消息体之前的部分完全表达,不能封装在消息体内部——目的是提高交互的可见性,使通信链上的中间组件能够实现缓存、安全审计等功能。

超文本驱动(HATEOAS):Web 应用可看作由很多应用状态组成的有限状态机;超链接既表示资源之间的关系,也表示可执行的状态迁移。超媒体不仅包含数据,还包含状态迁移的语义;客户端应依赖超媒体的状态迁移语义,而不应对是否存在某个 URI 或 URI 的特殊构造方式做出假设——一切都可能变化,只有状态迁移语义能长期保持稳定。

状态转移 ≠ 状态迁移:前者是在客户端和服务器之间转移代表资源状态的表述,通过操作表述间接操作资源。

设计取舍:“统一接口 + 超文本驱动”带来最大限度的松耦合,允许服务器和客户端在很大范围内独立进化。但书中明确区分: - 面向企业内网的 API,松耦合并不是很重要的设计关注点; - 面向互联网的 API,松耦合是必选项,不仅设计时要关注,还应放在最优先位置。

启示:是否要做 HATEOAS 等“彻底的 REST”,取决于你能否控制所有客户端——客户端越不受你控制、升级越不同步,越需要把耦合点压缩到稳定的语义上。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    • · 查看原书依据

      对于设计面向企业内网的API来说,松耦合并不是一个很重要的设计关注点。但是对于设计面向互联网的API来说,松耦合变成了一个必选项,不仅在设计时应该关注,而且应该放在最优先位置。

    参考来源

    - 位置:《软件架构理论与实践》第18章《第18章 软件架构解耦》18.9 REST架构风格及其解耦(源文件:extracted/软件架构理论与实践/_epub-src/OEBPS/text00153.html,来源项目 book-sources) - 结论依据:第18章补充REST细节:统一接口要求操作语义完全由消息体之前的部分表达以便中间组件缓存和审计,超文本驱动让客户端依赖状态迁移语义而不假设URI结构;这种松耦合使两端可独立进化,对内网API不那么重要,但对互联网API应放在最优先位置。 - 原始内容:对于设计面向企业内网的API来说,松耦合并不是一个很重要的设计关注点。