主题索引
存储模型选型
比较关系型、键值、列式、文档与全文检索等存储模型的特性取舍与适用场景。
来源书籍
Skill 版本:v23 本次执行规则:book-notes v24 / book-workflow v4(2026-11-14) 执行模式:light 建档进度:done 信息浓度:高 稳定性/时效性:高(稳定协议、语义边界、重试和演进取舍耐久;示例API、草案与HyperCLI命令按2022年版本理解) 内容形态:问题思考型 四象限评级:经典原理
评级依据:多数正文按具体问题、方案及讨论组织,解释超媒体、语义契约、幂等、并发、独立演进和跨服务流程的因果与边界;虽含大量消息示例,核心是可迁移设计取舍。附录D局部按工具用途保留操作参考,工具语法时效性不替代全书原理评级。
整书笔记:独立导读、主线、全部实质正文讲解、跨章综合和实践入口。
| 章节号 | 章节标题 | 状态(pending/done) | 卡片数 |
|---|---|---|---|
| foreword | 序言:沿链接发现下一步 | done | 1 |
| preface | 前言:配方的使用方法 | done | 3 |
| part1 | 第一部分导引:先理解可恢复性 | done | 1 |
| 01 | RESTful Web API导论 | done | 9 |
| 02 | 用超媒体思考与设计 | done | 16 |
| part2 | 第二部分导引:配方的组合 | done | 0 |
| 03 | 超媒体接口设计 | done | 14 |
| 04 | 超媒体客户端 | done | 16 |
| 05 | 超媒体服务 | done | 22 |
| 06 | 分布式数据 | done | 14 |
| 07 | 超媒体工作流 | done | 21 |
| 08 | 结语:按收益渐进采用配方 | done | 4 |
| 09 | 附录A:原则速查 | done | 0 |
| 10 | 附录B:进一步阅读 | done | 0 |
| 11 | 附录C:标准的角色与能力差异 | done | 2 |
| 12 | 附录D:HyperCLI操作参考 | done | 17 |
| 13 | 尾记:封面獴与自然史 | done | 2 |
| spine项 | 类型 | 排除理由 |
|---|---|---|
| 1 OEBPS/cover.xhtml | 非实质正文 | 封面图像,无实质正文 |
| 2 OEBPS/dedication01.xhtml | 非实质正文 | 推荐语与署名,评价阅读价值而未展开独立机制 |
| 3 OEBPS/dedication02.xhtml | 非实质正文 | 作者其他著作的宣传目录,作品名在延伸阅读登记,不凭题名生卡 |
| 4 OEBPS/titlepage01.xhtml | 非实质正文 | 书名、副标题和作者元数据 |
| 5 OEBPS/copyright-page01.xhtml | 非实质正文 | 版权、出版批次与授权信息,已用于身份确认,不按技术章节成卡 |
| 6 OEBPS/dedication03.xhtml | 非实质正文 | 献辞与纪念,未展开可独立的技术解释 |
| 23 OEBPS/ix01.xhtml | 非实质正文 | 索引关键词与页码,用于查找而非实质正文 |
| 24 OEBPS/colophon01.xhtml | 非实质正文 | 作者职业简介,无独立技术机制 |
| 术语名 | 出现章节 | 一句话语境 |
|---|---|---|
| PSD2 | 01 | 共享银行业务词汇示例 |
| ACORD | 01 | 保险领域词汇示例 |
| FHIR | 01 | 医疗信息领域词汇示例 |
| RDF | 01 | 在消息中表达共同语义的技术 |
| JSON-LD | 01 | 面向消息语义的格式示例 |
| Dynabook | 01 | 早期个人计算设备构想 |
| The Mother of All Demos | 01 | 历史演示或教学视频:1968年交互计算演示,视频延伸资料 |
| Licklider Transmission Protocol | 02 | 星际通信协议的历史旁注 |
| IRQL | 02 | 按条件匹配文档的信息检索查询语言 |
| DQL | 02 | 数据库查询语言 |
| HAR | 02 | 记录HTTP交换的归档格式 |
| BPEL | 02 | 集中编排工作流语言 |
| maxTTL | 02 | 流程完成的最长允许时间 |
| GraphQL | 02 | 可支持读写的数据接口候选 |
| SPARQL | 02 | 读写接口候选 |
| OData | 02 | 读写接口候选 |
| JSON:API | 02 | 读写接口候选 |
| Explaining Information Architecture | 02 | 历史演示或教学视频:本体、分类、交互规则教学视频 |
| IANA | 03 | 媒体类型注册机构 |
| Schema.org | 03 | 公开词汇首选来源示例 |
| Microformats.org | 03 | 公开词汇备用来源示例 |
| Dublin Core | 03 | 公开词汇与profile来源 |
| ALPS | 03 | 机器可读语义profile格式 |
| DCAP | 03 | 语义profile候选格式 |
| OpenAPI | 03 | 包含具体接口细节的定义格式 |
| WSDL | 03 | 接口定义格式 |
| AsyncAPI | 03 | 接口定义格式 |
| Hydra | 03 | JSON-LD超媒体词汇 |
| ETag | 03 | 资源版本验证器 |
| CORS | 03 | 原书浏览器跨源限制提醒;不外推当前行为 |
| Hyrum’s Law | 03 | API一切可观察行为可能被依赖 |
| OWL | 04 | 本章仅作为词汇格式或协议背景提名,未进一步教学。 |
| DCAP | 04 | 本章仅作为词汇格式或协议背景提名,未进一步教学。 |
| RFC 6570 | 04 | 本章仅作为词汇格式或协议背景提名,未进一步教学。 |
| RDF | 04 | 本章仅作为词汇格式或协议背景提名,未进一步教学。 |
| Circuit Breaker | 05 | 本章在代理或发现背景下提名。 |
| FHIR | 05 | 本章在代理或发现背景下提名。 |
| BIAN | 05 | 本章在代理或发现背景下提名。 |
| WAP | 05 | 本章在代理或发现背景下提名。 |
| GDPR | 06 | 章引言提醒分布式数据受到地域监管约束,未展开法规规则 |
| SPARQL | 06 | 6.7提到已有HTTP媒体类型,未展开其查询模型 |
| Vary | 06 | 6.9提醒把协商维度纳入缓存匹配 |
| If-Modified-Since / If-Unmodified-Since | 06 | 6.2提名日期条件请求,对比ETag而未展开操作 |
| Defined End Goals (DEGs) | 07 | 7.13回指4.16的既定终点目标,当前章主要展开状态目标 |
| iPaaS | 07 | 7.6提名其他工作流平台选项,未展开架构 |
| Kubernetes | 07 | 7.19作为集群管理产品举例,未展开其机制 |
| WebAPICookbook.com | 08 | 2022年书籍资料入口,现今可用性未在本知识卡主张 |
| ALPS catalog | 08 | 用于配方语义档案的扩展资料目录 |
| AsyncAPI | 11 | 附录C按描述职责分组列名,不在本处展开完整语法 |
| OpenAPI | 11 | 附录C按描述职责分组列名,不在本处展开完整语法 |
| Protobuf | 11 | 附录C按描述职责分组列名,不在本处展开完整语法 |
| RAML | 11 | 附录C按描述职责分组列名,不在本处展开完整语法 |
| Schema Definition Language | 11 | 附录C按描述职责分组列名,不在本处展开完整语法 |
| WSDL | 11 | 附录C按描述职责分组列名,不在本处展开完整语法 |
| WADL | 11 | 附录C按描述职责分组列名,不在本处展开完整语法 |
| DCAP | 11 | 附录C按描述职责分组列名,不在本处展开完整语法 |
| ALPS | 11 | 附录C按描述职责分组列名,不在本处展开完整语法 |
| XMDP | 11 | 附录C按描述职责分组列名,不在本处展开完整语法 |
| POD | 11 | 附录C按描述职责分组列名,不在本处展开完整语法 |
| HAL-FORMS | 11 | 附录C按描述职责分组列名,不在本处展开完整语法 |
| WESTL | 11 | 附录C按描述职责分组列名,不在本处展开完整语法 |
| 标题 | 类型(书/论文/框架/源码项目) | 出现章节 | 一句话语境 |
|---|---|---|---|
| HTTP Developer’s Handbook | 书 | preface | 前言为HTTP、API、数据或流程实现的进一步学习指路,仅列名未展开内容 |
| Building Hypermedia APIs with HTML5 and Node | 书 | preface | 前言为HTTP、API、数据或流程实现的进一步学习指路,仅列名未展开内容 |
| Design and Build Great Web APIs | 书 | preface | 前言为HTTP、API、数据或流程实现的进一步学习指路,仅列名未展开内容 |
| RESTful Web Clients | 书 | preface | 前言为HTTP、API、数据或流程实现的进一步学习指路,仅列名未展开内容 |
| RESTful Web APIs | 书 | preface | 前言为HTTP、API、数据或流程实现的进一步学习指路,仅列名未展开内容 |
| Principles of Web API Design | 书 | preface | 前言为HTTP、API、数据或流程实现的进一步学习指路,仅列名未展开内容 |
| The Design of Web APIs | 书 | preface | 前言为HTTP、API、数据或流程实现的进一步学习指路,仅列名未展开内容 |
| Data Management at Scale | 书 | preface | 前言为HTTP、API、数据或流程实现的进一步学习指路,仅列名未展开内容 |
| Data Governance: The Definitive Guide | 书 | preface | 前言为HTTP、API、数据或流程实现的进一步学习指路,仅列名未展开内容 |
| Practical Process Automation | 书 | preface | 前言为HTTP、API、数据或流程实现的进一步学习指路,仅列名未展开内容 |
| Service Orchestration as Organization | 书 | preface | 前言为HTTP、API、数据或流程实现的进一步学习指路,仅列名未展开内容 |
| Christopher Alexander的模式思想 | 其他(引文) | part1 | 部分题辞以木工动作序列说明小错的可恢复性 |
| RESTful Web APIs | 书 | 01 | 讨论统一语义与魔法字符串 |
| Architectural Styles and the Design of Network-based Software Architectures | 论文 | 01 | REST约束与架构属性来源 |
| Information Management: A Proposal | 论文 | 01 | World Wide Web原始提案 |
| The Vision of Kay and Fielding: Growable Systems that Last for Decades | 论文 | 01 | REST与OOP联系的延伸阅读 |
| Complex Information Processing: A File Structure for the Complex, the Changing and the Indeterminate | 论文 | 01 | hypertext与hypermedia概念来源 |
| As We May Think | 论文 | 01 | 关联式信息工作站的历史探索 |
| Computer Lib/Dream Machines | 书 | 01 | 个人计算与超链接历史 |
| The Senses Considered as Perceptual Systems | 书 | 01 | 可供性概念来源 |
| The Design of Everyday Things | 书 | 01 | 软件和物品交互的可供性 |
| Information Architecture for the World Wide Web | 书 | 01 | 信息架构背景 |
| Domain-Driven Design | 书 | 01 | 通用语言与限界上下文背景 |
| Information Architects | 书 | 02 | 信息架构概念背景 |
| Information Architecture for the World Wide Web | 书 | 02 | 大型信息系统组织方法 |
| RESTful Web Clients | 书 | 02 | 结构化媒体客户端延伸阅读 |
| Apache Lucene | 源码项目 | 02 | 信息检索引擎候选 |
| Apache Solr | 源码项目 | 02 | Lucene上层检索实现 |
| MongoDB | 框架 | 02 | 数据写入技术示例;书中分类不宜机械外推 |
| SQLite | 框架 | 02 | SQL数据存储候选 |
| PostgreSQL | 框架 | 02 | SQL数据存储候选 |
| Apache Kafka | 框架 | 02 | 大量写入的流引擎示例 |
| Apache Pulsar | 框架 | 02 | 大量写入的流引擎示例 |
| XLang | 框架 | 02 | 集中编排的历史背景 |
| Web Services Flow Language | 框架 | 02 | 工作流语言历史 |
| Ballerina | 框架 | 02 | 面向集成的协作语言提名 |
| HTTPLR | 框架 | 03 | 历史POST重试方案提名 |
| POE | 框架 | 03 | 历史POST重试方案提名 |
| RESTful Web Clients | 书 | 03 | 超媒体客户端延伸阅读 |
| Web Service Transition Language (WSTL) | 框架 | 04 | 仅作为工具或格式选项提名,本文未展开完整用法。 |
| JSON HyperSchema | 框架 | 04 | 仅作为工具或格式选项提名,本文未展开完整用法。 |
| JSON Path-Plus | 框架 | 04 | 仅作为工具或格式选项提名,本文未展开完整用法。 |
| OWASP Input Validation Cheat Sheet | 框架 | 04 | 仅作为工具或格式选项提名,本文未展开完整用法。 |
| Hydra ontology | 框架 | 05 | 本章作为服务定义、词汇或平台示例提名,未展开其完整设计。 |
| CloudEvents | 框架 | 05 | 本章作为服务定义、词汇或平台示例提名,未展开其完整设计。 |
| WADL | 框架 | 05 | 本章作为服务定义、词汇或平台示例提名,未展开其完整设计。 |
| WSDL | 框架 | 05 | 本章作为服务定义、词汇或平台示例提名,未展开其完整设计。 |
| JSON Home | 框架 | 05 | 本章作为服务定义、词汇或平台示例提名,未展开其完整设计。 |
| IBM CICS External Call Interface | 框架 | 05 | 本章作为服务定义、词汇或平台示例提名,未展开其完整设计。 |
| Rule of Least Power | 论文 | 06 | 章引言引用Tim Berners-Lee的最小能力规则作为查询接口原则 |
| RFC 6922 | 论文 | 06 | 6.7引用application/sql媒体类型定义 |
| RFC 7234 | 论文 | 06 | 6.9原书采用的HTTP缓存规范版本 |
| RFC 8246 | 论文 | 06 | 6.9引用immutable缓存指令 |
| Extending and Versioning Languages Part 1 | 论文 | 06 | 6.8引向Must Ignore扩展规则 |
| John Gathogo OData over HTTP article | 论文 | 06 | 6.7推荐OData请求写法背景;正文未给文章标题,不补造 |
| Transient Fault Handling | 论文 | 07 | 7.16引用Microsoft Azure文档了解暂时故障处理 |
| RFC 7240 | 论文 | 07 | 7.13引用Prefer头作为状态观察偏好可选通道 |
| Alexander, Christopher. A Pattern Language. New York: Oxford University Press, 1977. | 书 | 10 | 附录B的参考书目条目;本书此处只给出版信息,未展开其知识内容 |
| Alexander, Christopher. The Timeless Way of Building. New York: Oxford University Press, 1979. | 书 | 10 | 附录B的参考书目条目;本书此处只给出版信息,未展开其知识内容 |
| Amundsen, Mike. Building Hypermedia Clients with HTML5 and Node. Sebastapol, CA: O’Reilly Media, Inc., 2011. | 书 | 10 | 附录B的参考书目条目;本书此处只给出版信息,未展开其知识内容 |
| Amundsen, Mike. Design and Build Great Web APIs. Raleigh, NC: Pragmatic Bookshelf, 2020. | 书 | 10 | 附录B的参考书目条目;本书此处只给出版信息,未展开其知识内容 |
| Amundsen, Mike. RESTful Web Clients. Sebastapol, CA: O’Reilly Media, Inc., 2017. | 书 | 10 | 附录B的参考书目条目;本书此处只给出版信息,未展开其知识内容 |
| Amundsen, Mike. What Is Serverless? Sebastapol, CA: O’Reilly Media, Inc., 2020. | 书 | 10 | 附录B的参考书目条目;本书此处只给出版信息,未展开其知识内容 |
| Amundsen, Mike, and Derric Gillig. API Strategy for Decision-Makers. Sebastapol, CA: O’Reilly Media, Inc., 2022. | 书 | 10 | 附录B的参考书目条目;本书此处只给出版信息,未展开其知识内容 |
| Bardini, Thierry. Bootstrapping. Stanford, CA: Stanford University Press, 2000. | 书 | 10 | 附录B的参考书目条目;本书此处只给出版信息,未展开其知识内容 |
| Bass, Len, et al. Software Architecture in Practice, 4th Edition. Boston: Addison-Wesley, 2021. | 书 | 10 | 附录B的参考书目条目;本书此处只给出版信息,未展开其知识内容 |
| Berners-Lee, Tim, and Mark Fishetti. Weaving the Web. New York: Harper-Collins, 2008. | 书 | 10 | 附录B的参考书目条目;本书此处只给出版信息,未展开其知识内容 |
| Evans, Eric. Domain-Driven Design. Sebastapol, CA: O’Reilly Media, Inc., 2003. | 书 | 10 | 附录B的参考书目条目;本书此处只给出版信息,未展开其知识内容 |
| Gibson, James J. The Ecological Approach to Visual Perception. New York: Psychology Press, 1979. | 书 | 10 | 附录B的参考书目条目;本书此处只给出版信息,未展开其知识内容 |
| Gibson, James J. The Senses Considered as Perceptual Systems. Boston: Houghton Mifflin, 1966. | 书 | 10 | 附录B的参考书目条目;本书此处只给出版信息,未展开其知识内容 |
| Hall, Wendy, et al. Rethinking Hypermedia. New York: Springer US, 1996. | 书 | 10 | 附录B的参考书目条目;本书此处只给出版信息,未展开其知识内容 |
| Higginbotham, James. Principles of Web API Design. Boston: Addison-Wesley, 2021. | 书 | 10 | 附录B的参考书目条目;本书此处只给出版信息,未展开其知识内容 |
| Hohpe, Gregor, and Bobby Woolf. Enterprise Integration Patterns. Boston: Addison-Wesley, 2003. | 书 | 10 | 附录B的参考书目条目;本书此处只给出版信息,未展开其知识内容 |
| Lauret, Arnaud. The Design of Web APIs. Shelter Island, NY: Manning Publications, 2019. | 书 | 10 | 附录B的参考书目条目;本书此处只给出版信息,未展开其知识内容 |
| Meadows, Donella. Thinking in Systems. White River Junction, VT: Chelsea Green Publishing, 2008. | 书 | 10 | 附录B的参考书目条目;本书此处只给出版信息,未展开其知识内容 |
| Medjaoui, Mehdi, et al. Continuous API Management, 1st ed. Sebastapol, CA: O’Reilly Media, Inc., 2018. | 书 | 10 | 附录B的参考书目条目;本书此处只给出版信息,未展开其知识内容 |
| Medjaoui, Mehdi, et al. Continuous API Management, 2nd ed. Sebastapol, CA: O’Reilly Media, Inc., 2021. | 书 | 10 | 附录B的参考书目条目;本书此处只给出版信息,未展开其知识内容 |
| Nadareishvili, Irakli, et al. Microservice Architecture. Sebastapol, CA: O’Reilly Media, Inc., 2016. | 书 | 10 | 附录B的参考书目条目;本书此处只给出版信息,未展开其知识内容 |
| Nadareishvili, Irakli, and Ronnie Mitra. Microservices: Up and Running. Sebastapol, CA: O’Reilly Media, Inc., 2020. | 书 | 10 | 附录B的参考书目条目;本书此处只给出版信息,未展开其知识内容 |
| Nelson, Ted. Computer Lib / Dream Machines. Tempus Books, 1974. | 书 | 10 | 附录B的参考书目条目;本书此处只给出版信息,未展开其知识内容 |
| Newman, Sam. Building Microservices. Sebastapol, CA: O’Reilly Media, Inc., 2021. | 书 | 10 | 附录B的参考书目条目;本书此处只给出版信息,未展开其知识内容 |
| Norman, Donald. The Design of Everyday Things. New York, NY: Basic Books, 2013 | 书 | 10 | 附录B的参考书目条目;本书此处只给出版信息,未展开其知识内容 |
| Richardson, Chris. Microservices Patterns. Shelter Island: Manning Publications, 2018. | 书 | 10 | 附录B的参考书目条目;本书此处只给出版信息,未展开其知识内容 |
| Richardson, Leonard, et al. RESTful Web APIs. Sebastapol, CA: O’Reilly Media, Inc., 2013. | 书 | 10 | 附录B的参考书目条目;本书此处只给出版信息,未展开其知识内容 |
| Rosenfeld, Louis, et al. Information Architecture, 4th edition. Sebastapol, CA: O’Reilly Media, Inc., 2015. | 书 | 10 | 附录B的参考书目条目;本书此处只给出版信息,未展开其知识内容 |
| Russell, Stuart, and Peter Norvig. Artificial Intelligence. Engelwood Cliffs, NJ: Prentice-Hall, Inc., 1995. | 书 | 10 | 附录B的参考书目条目;本书此处只给出版信息,未展开其知识内容 |
| Shiflett, Chris. HTTP Developer’s Handbook. Indianapolis, IN: Sams Publishing, 2003. | 书 | 10 | 附录B的参考书目条目;本书此处只给出版信息,未展开其知识内容 |
| Taylor, Richard N., et al. Software Architecture. Hoboken, NJ: John Wiley & Sons, 2008. | 书 | 10 | 附录B的参考书目条目;本书此处只给出版信息,未展开其知识内容 |
| Wolff, Eberhard. Microservices. Boston: Addison-Wesley, 2016. | 书 | 10 | 附录B的参考书目条目;本书此处只给出版信息,未展开其知识内容 |
| Wright, Alex. Cataloging the World. New York: Oxford University Press, 2014. | 书 | 10 | 附录B的参考书目条目;本书此处只给出版信息,未展开其知识内容 |
| Yourdon, Edward, and Larry E. Constantine. Structured Design. Englewood Cliffs, NJ: Prentice-Hall, Inc., 1975. | 书 | 10 | 附录B的参考书目条目;本书此处只给出版信息,未展开其知识内容 |
| HyperCLI / @mamund/hyper | 源码项目 | 12 | 附录操作对象;语法按本书2022年版本保留,未安装或运行 |
| API Strategy for Decision Makers | 书 | 参考书目 | 作者其他著作目录,仅列作品题名,未据此生成内容卡 |
| Continuous API Management | 书 | 参考书目 | 作者其他著作目录,仅列作品题名,未据此生成内容卡 |
| Design and Build Great Web APIs | 书 | 参考书目 | 作者其他著作目录,仅列作品题名,未据此生成内容卡 |
| What Is Serverless? | 书 | 参考书目 | 作者其他著作目录,仅列作品题名,未据此生成内容卡 |
| API Traffic Management 101 | 书 | 参考书目 | 作者其他著作目录,仅列作品题名,未据此生成内容卡 |
| RESTful Web Clients | 书 | 参考书目 | 作者其他著作目录,仅列作品题名,未据此生成内容卡 |
| Microservice Architecture | 书 | 参考书目 | 作者其他著作目录,仅列作品题名,未据此生成内容卡 |
| RESTful Web APIs | 书 | 参考书目 | 作者其他著作目录,仅列作品题名,未据此生成内容卡 |
| Building Hypermedia APIs with HTML5 and Node | 书 | 参考书目 | 作者其他著作目录,仅列作品题名,未据此生成内容卡 |
| 问题标题 | 问题卡 | 解决方案卡(如有) | 出现章节 | 一句话说明 |
|---|---|---|---|---|
| 扣款POST响应丢失引发重复作用风险 | 问题卡 | 解决方案卡 | 响应丢失无法判断扣款是否发生,以条件PUT设计可重复的资源写入,不能仅替换HTTP方法 | |
| 批量涨价中断后重试导致再次涨价 | 问题卡 | 解决方案卡 | 增量百分比不可重放,改为明确新旧值及条件更新 | |
| 转账请求成功响应丢失后重试造成重复转账 | 转账响应丢失的歧义 | 用幂等创建消除重复写入 | 非幂等POST的超时不能区分未执行与已执行。 | |
| 支付延后入队时其他订单步骤已承诺 | 支付入队牵连其他步骤 | 入队响应公开处理进度 | 202需要消费者协调后续动作。 |
| 序号 | 实践标题 | 实践方式 | 状态(pending/done) | 关联章节 | 产出 |
|---|---|---|---|---|---|
| 1 | 深读链接发现与表单能力 | 实现深读 | done | 02/04/05/11 | ideas/idea-001-深读链接发现与表单能力.md;计划与首轮材料交付,未执行完整实践 |
| 2 | 为本批导入选择最小改动 | 决策实践 | done | 08 | ideas/idea-002-为本批导入选择最小改动.md;计划与首轮材料交付,未执行完整实践 |
实践候选筛选:done
已逐个筛选:链接/表单机制采用成熟实现深读;既有系统的小步采用采用本批真实对象的决策实践。HyperCLI命令练习未单独安排安装任务,因成熟实现阅读已能回答当前机制问题,示例站点可用性也未假设;全套工作流引擎自建成本过高且非用户目标,未采用;生态尾记无本轮合格现实干预对象,不凑实践。两项均完成计划及所需首轮材料,实际效果等待后续观测。
全文17个实质spine项已读,8项非正文有具体排除依据;知识卡142张,实践计划2项。
轻量模式:本轮未执行笔记复核、独立审查及审查结果优化。
本书是超媒体 API 配方集:超媒体接口与客户端归 REST 设计,媒体类型与词汇归数据交换格式与契约校验,幂等/重试/条件写归重试与事务,编排与工作流归流程引擎,分布式数据归分拆数据库。未新建主题。
| 卡片标题 | 结论 | 主题文件或原因 |
|---|---|---|
| [[链接降低导航学习成本]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[按问题而非技术选配方]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[配方讨论保留方案取舍]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[模式通过关联共同生效]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[步骤留出纠错余地]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[超媒体连接三要素]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[REST以约束诱导属性]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[最小能力降低门槛]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[极晚绑定支持演进]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[链接表单驱动状态]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[可供性提示下一动作]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[消息隔离本地模型]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[共享词汇弥合语义差]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[为未知使用者守约]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[网络采用独立控制语言]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[信息架构解释位置]] | 已复用 | notes/_topics/information-architecture.md |
| [[客户端绑定稳定抽象]] | 已复用 | notes/_topics/service-adaptation-compatibility.md |
| [[运行期解析请求元数据]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[机器交互需要语义边界]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[客户端掌握工作流目标]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[兼容演进三条承诺]] | 已复用 | notes/_topics/service-adaptation-compatibility.md |
| [[发现绑定自动化接入]] | 已复用 | notes/_topics/service-discovery-gateway.md |
| [[远程数据副本有边界]] | 已复用 | notes/_topics/consistency-models.md |
| [[数据是动作证据]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[存储与外部表示分离]] | 已复用 | notes/_topics/model-implementation-separation.md |
| [[分开处理读写约束]] | 已复用 | notes/_topics/cqrs-read-write-models.md |
| [[检索与数据库查询有别]] | 已复用 | notes/_topics/inverted-index-query.md |
| [[编排协作各有代价]] | 已复用 | notes/_topics/workflow-engine-bpmn.md |
| [[任务作业用动作组合]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[工作流共享状态文档]] | 已复用 | notes/_topics/workflow-engine-bpmn.md |
| [[注册媒体类型促互通]] | 已复用 | notes/_topics/data-interchange-formats.md |
| [[结构与业务内容分层]] | 已复用 | notes/_topics/data-interchange-formats.md |
| [[公开词汇隔离内部命名]] | 已复用 | notes/_topics/openapi-contract-schema-validation.md |
| [[语义档案描述问题域]] | 已复用 | notes/_topics/openapi-contract-schema-validation.md |
| [[嵌入控件表达当前动作]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[扣款超时结果不明]] | 已复用 | notes/_topics/distributed-transactions.md |
| [[条件PUT保护写入]] | 已复用 | notes/_topics/transactions-offline-concurrency.md |
| [[状态传递三种接口]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[涨价批处理重放风险]] | 已复用 | notes/_topics/rpc-retry-timeouts.md |
| [[替换值使批处理可重放]] | 已复用 | notes/_topics/rpc-retry-timeouts.md |
| [[安全重试有两个层次]] | 已复用 | notes/_topics/rpc-retry-timeouts.md |
| [[撤销操作需保存历史]] | 已复用 | notes/_topics/transaction-recovery-logging.md |
| [[消息扩展只增不替换]] | 已复用 | notes/_topics/service-adaptation-compatibility.md |
| [[接口变更保留旧路径]] | 已复用 | notes/_topics/service-adaptation-compatibility.md |
| [[逐步外置服务地址]] | 已复用 | notes/_topics/service-discovery-gateway.md |
| [[保留直接HTTP能力]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[客户端绑定消息结构]] | 已复用 | notes/_topics/data-interchange-formats.md |
| [[用词汇契约识别动作]] | 已复用 | notes/_topics/openapi-contract-schema-validation.md |
| [[运行时核对语义契约]] | 已复用 | notes/_topics/openapi-contract-schema-validation.md |
| [[按媒体类型分派解析]] | 已复用 | notes/_topics/data-interchange-formats.md |
| [[模式标识辅助消息路由]] | 已复用 | notes/_topics/data-interchange-formats.md |
| [[响应元素的四类标识]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[按超媒体控制发请求]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[本地补充链接与表单]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[输入规则随响应更新]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[发送前校验请求正文]] | 已复用 | notes/_topics/openapi-contract-schema-validation.md |
| [[入站消息分三层检查]] | 已复用 | notes/_topics/openapi-contract-schema-validation.md |
| [[仅处理过滤后的输入]] | 已复用 | notes/_topics/openapi-contract-schema-validation.md |
| [[客户端保存交互状态]] | 已复用 | notes/_topics/session-state-management.md |
| [[用目标驱动自动客户端]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[承诺稳定服务起点]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[外部模型独立设计]] | 已复用 | notes/_topics/model-implementation-separation.md |
| [[显式映射外部表示]] | 已复用 | notes/_topics/model-implementation-separation.md |
| [[动作契约遮蔽内部流程]] | 已复用 | notes/_topics/model-implementation-separation.md |
| [[外部枚举保留演进空间]] | 已复用 | notes/_topics/service-adaptation-compatibility.md |
| [[发布可缓存偏好资源]] | 已复用 | notes/_topics/caching-strategies.md |
| [[内容协商的两种选择]] | 已复用 | notes/_topics/data-interchange-formats.md |
| [[词汇描述覆盖数据与动作]] | 已复用 | notes/_topics/openapi-contract-schema-validation.md |
| [[区分词汇与模式文档]] | 已复用 | notes/_topics/openapi-contract-schema-validation.md |
| [[公开服务定义入口]] | 已复用 | notes/_topics/service-discovery-gateway.md |
| [[用元数据汇集API资产]] | 已复用 | notes/_topics/openapi-contract-schema-validation.md |
| [[健康检查保持轻量]] | 已复用 | notes/_topics/observability-metrics.md |
| [[错误也是正式响应]] | 已复用 | notes/_topics/error-handling-mechanisms.md |
| [[注册服务完整生命周期]] | 已复用 | notes/_topics/service-discovery-gateway.md |
| [[客户端预分配资源标识]] | 已复用 | notes/_topics/distributed-lock-id.md |
| [[转账响应丢失的歧义]] | 已复用 | notes/_topics/distributed-transactions.md |
| [[用幂等创建消除重复写入]] | 已复用 | notes/_topics/rpc-retry-timeouts.md |
| [[为每项依赖准备退路]] | 已复用 | notes/_topics/fail-safe-defaults.md |
| [[重试必须理解动作语义]] | 已复用 | notes/_topics/rpc-retry-timeouts.md |
| [[支付入队牵连其他步骤]] | 已复用 | notes/_topics/workflow-engine-bpmn.md |
| [[入队响应公开处理进度]] | 已复用 | notes/_topics/workflow-engine-bpmn.md |
| [[以语义代理接入旧服务]] | 已复用 | notes/_topics/service-adaptation-compatibility.md |
| [[以业务动作隐藏存储]] | 已复用 | notes/_topics/model-implementation-separation.md |
| [[幂等写应区分丢响应]] | 已复用 | notes/_topics/rpc-retry-timeouts.md |
| [[条件写保护资源版本]] | 已复用 | notes/_topics/transactions-offline-concurrency.md |
| [[平面消息隐藏实体关系]] | 已复用 | notes/_topics/data-interchange-formats.md |
| [[用简单查询承载筛选]] | 已复用 | notes/_topics/query-optimization-rewrite.md |
| [[查询元数据帮助修正]] | 已复用 | notes/_topics/query-optimization-rewrite.md |
| [[空集合按请求语义响应]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[查询语言封装为媒体类型]] | 已复用 | notes/_topics/data-interchange-formats.md |
| [[未知字段保留往返]] | 已复用 | notes/_topics/service-adaptation-compatibility.md |
| [[缓存契约权衡新鲜度]] | 已复用 | notes/_topics/caching-strategies.md |
| [[显隐字段支持模型演进]] | 已复用 | notes/_topics/service-adaptation-compatibility.md |
| [[关联键扩展远端数据]] | 已复用 | notes/_topics/dataflow-unbundled-databases.md |
| [[限制总量不同于分页]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[透传代理保存完整快照]] | 已复用 | notes/_topics/distributed-storage-replication.md |
| [[可组合服务的动作契约]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[共享状态独立成资源]] | 已复用 | notes/_topics/workflow-engine-bpmn.md |
| [[代码编排适合稳定流程]] | 已复用 | notes/_topics/workflow-engine-bpmn.md |
| [[专用脚本降低编排成本]] | 已复用 | notes/_topics/workflow-engine-bpmn.md |
| [[声明文档分离执行策略]] | 已复用 | notes/_topics/workflow-engine-bpmn.md |
| [[作业控制分开并行与顺序]] | 已复用 | notes/_topics/workflow-engine-bpmn.md |
| [[进度资源只报告执行]] | 已复用 | notes/_topics/workflow-engine-bpmn.md |
| [[相关动作资源按需展开]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[最近使用链接减少查找]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[工作文档承接长期输入]] | 已复用 | notes/_topics/workflow-engine-bpmn.md |
| [[分页沿可用链接导航]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[部分保存与最终提交]] | 已复用 | notes/_topics/workflow-engine-bpmn.md |
| [[状态观察由客户端定目标]] | 已复用 | notes/_topics/workflow-engine-bpmn.md |
| [[存储查询区分执行与管理]] | 已复用 | notes/_topics/workflow-engine-bpmn.md |
| [[接受响应给出追踪资源]] | 已复用 | notes/_topics/observability-tracing.md |
| [[重试须幂等且受时限约束]] | 已复用 | notes/_topics/rpc-retry-timeouts.md |
| [[直接撤销受历史与权限约束]] | 已复用 | notes/_topics/workflow-engine-bpmn.md |
| [[延时撤销在提交前取消]] | 已复用 | notes/_topics/workflow-engine-bpmn.md |
| [[人工求助携带可恢复上下文]] | 已复用 | notes/_topics/incident-response.md |
| [[队列缓冲集群扩展处理]] | 已复用 | notes/_topics/message-brokers-event-logs.md |
| [[工作流代理优先只读服务]] | 已复用 | notes/_topics/workflow-engine-bpmn.md |
| [[按协作范围安排落地]] | 已复用 | notes/_topics/devops-adoption.md |
| [[统一模式名促进复用]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[共享存储限制配方适配]] | 已复用 | notes/_topics/storage-model-choices.md |
| [[小步改造先验证收益]] | 已复用 | notes/_topics/change-release-safety.md |
| [[超媒体格式能力不同]] | 已复用 | notes/_topics/data-interchange-formats.md |
| [[标准清单须标明时间]] | 已复用 | notes/_topics/data-interchange-formats.md |
| [[启动或批量运行超媒体脚本]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[配置与临时变量分开管理]] | 无需加入 | 附录D HyperCLI 命令参考(CONFIG FILE/SET/REMOVE/SAVE 与临时变量用法),属单书工具操作,无跨书可对照的配置治理议题(2026-11-05 修正:原记已复用 central-config-management 且无成员,该主题文件不存在) |
| [[栈保存当前任务的变量]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[保存与恢复变量栈]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[配置命名OAuth令牌]] | 已复用 | notes/_topics/secrets-credential-management.md |
| [[按语义链接定位请求地址]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[明确HTTP请求参数职责]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[由表单元数据构造请求]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[查看响应历史排查交互]] | 已复用 | notes/_topics/debugging-root-cause.md |
| [[按路径选择响应内容]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[读取CJ控件]] | 已复用 | notes/_topics/data-interchange-formats.md |
| [[读取HAL链接与内嵌资源]] | 已复用 | notes/_topics/data-interchange-formats.md |
| [[读取SIREN动作与实体]] | 已复用 | notes/_topics/data-interchange-formats.md |
| [[读取WSTL状态转移描述]] | 已复用 | notes/_topics/data-interchange-formats.md |
| [[按表示类型选择解析命令]] | 已复用 | notes/_topics/data-interchange-formats.md |
| [[用退出条件控制脚本]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[查看插件与工作目录]] | 已复用 | notes/_topics/rpc-rest-api.md |
| [[夜行习性避开白天高温]] | 无需加入 | 版权页动物说明,不含架构知识 |
| [[单配与繁殖季节不同]] | 无需加入 | 版权页动物说明,不含架构知识 |
从本书的主题进入跨书阅读,对照其他书籍的讲解。下方数量包含主题关联的全部卡片与书籍。
主题索引
比较关系型、键值、列式、文档与全文检索等存储模型的特性取舍与适用场景。
主题索引
比较 GFS、HDFS、BigTable、MongoDB、RabbitMQ 等系统的租约、写确认、副本同步、选主与脑裂处理。
主题索引
时序模型与拉推采集、黄金指标与分位、探针与 APM、容量与负载、监控分层。
主题索引
比较缓存穿透、雪崩、热点等问题的成因与应对方案。
主题索引
比较变更速度、渐进发布、紧急发布与回滚边界的工程控制。
主题索引
比较内部与外部一致性、XA/2PC/3PC、CAP 与 BASE,以及可靠事件队列、TCC、SAGA、AT 等柔性事务方案。
主题索引
比较 RPC 要解决的基本问题与历代框架取舍,以及 REST 的资源抽象、统一接口、成熟度与局限。
主题索引
比较服务发现范式、注册中心的 CAP 取舍与实现路线、网关与 BFF,以及地域与区域的流量边界。
主题索引
比较事故/安全事件的分级、指挥、沟通、演练与交接做法。
主题索引
Trace/Span 模型、标识与上下文传播、采样取舍、OpenTelemetry 与采集器管道。
主题索引
比较顺序一致性、线性一致性、外部一致性等一致性模型,以及 CAP、弱 CAP、HAT、PACELC 对系统取舍的刻画。
主题索引
DevOps 在组织中的适用边界与推进顺序:稳态与敏态系统的区分、工具与流程文化的关系、责任共担取代交接审批、分支模型与团队能力的匹配。
主题索引
比较数据交换格式的简洁性、互通性与安全解析要求。
主题索引
比较服务组合中接口与协议失配的分类、适配器的生成与合成方式,以及兼容性分层与组合验证。
主题索引
跨进程互斥的分布式锁实现与取舍,以及全局唯一 ID 的生成方案和分布式计数。
主题索引
比较日志段与索引、页缓存与零拷贝、批次与压缩、保留清理与压实,以及副本放置对读写路径与堆积的影响。
主题索引
多个数据系统怎样连成一套:分拆数据库与读写路径、CDC 与日志捕获、双写与发件箱、数据共享与缓存复制、数据湖与湖仓分工、端到端正确性与可审计性。
主题索引
比较查询优化器依赖的等价变换、语义优化条件,以及重复行、NULL 与写法选择对优化空间的影响。
主题索引
比较命令与查询的职责、模型及读取路径,并标明薄读取层的适用边界。
主题索引
预写日志与 redo/undo 的分工,检查点与日志截断,崩溃恢复的重做与回滚阶段,以及不同存储引擎在提交、刷盘与恢复时间上的取舍。
主题索引
有状态与无状态会话的取舍,以及会话状态存放在客户端、服务器或数据库的代价与清理。
主题索引
比较全文检索的索引粒度、倒排列表压缩、签名文件与位图、布尔查询加速与索引构造算法,以及压缩索引如何同时省空间和提速。
主题索引
业务事务比系统事务长得多,中间隔着用户思考时间:乐观离线锁与悲观离线锁怎么选、粗粒度锁与隐含锁的代价、版本号与条件更新怎样防止覆盖、预留与冻结怎样替代事后校验,以及离线并发为什么能免则免。
主题索引
比较逻辑模型与物理实现、值与变量、派生视图与存储结构之间的边界。
主题索引
引擎的三大核心功能与部署形态(嵌入、独立、共享引擎),流程实例的持久化、调度与等待不占线程,流程版本与实例迁移,外部任务与人工任务的执行分离,以及故障恢复、撤销与审计数据的落地方式。
主题索引
比较排查系统问题时的假设管理、基线对比与复现方法。
主题索引
比较延迟执行、异常展开、恢复与返回值错误等机制的语义边界。
主题索引
比较 OpenAPI 文档结构、路径与操作、参数/请求/响应、JSON Schema 约束、复用和认证方案,以及规范交互验证的做法。
主题索引
比较远程调用在不同失败语义下的重试条件、幂等边界、总期限与目标节点选择。
主题索引
批处理、actor 模型、有状态函数、代码编排、编舞与服务编排在同一件事上的差别:长期运行与等待、状态归属、可观察性、改流程要不要重新部署,以及低代码与 RPA 各自的能力边界。
主题索引
比较密钥轮换、根密钥分发、紧急凭证与凭证泄露风险的管理方法。
主题索引
比较组件失效时选择开放、关闭或停滞的依据与被利用风险。
主题索引
比较信息架构如何以组织、分类与关联对抗信息焦虑,以及它从 Wurman 到 Web 与 UX 职业化的演变。