知识卡片
为未知使用者守约
开放网络上的服务可能被未曾见面的使用者组合,用于最初未预想的问题,并持续远超原定寿命。接口因此需要携带使用所需上下文、保持词汇一致,并支持长期独立演进。设计目标不是预测所有用例,而是用低门槛、明确约定和可组合动作容纳未来用途。
这张卡片看不懂?
这张卡片的反馈已满 10 条,暂时无法继续提交。
已有反馈 · 0 / 10 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 1 处
- RESTful Web API导论 · 查看原书依据
For this reason, it is important to carefully and explicitly define our service interfaces with coherent and consistent vocabularies. We need to apply Eric Evans’s ubiquitous language across services. We need to make it easy for people to understand the intent of the service without having to hear us explain it. Our implementations need to be—to borrow Fielding’s phrase—“state-less”; they need to carry with them all the context needed to understand and successfully use the service.
参考来源
- 位置:《RESTful Web API Patterns and Practices Cookbook Connecting and Orchestrating Microservices and Distributed Data (Mike Amundsen)》第01章《RESTful Web API导论》(来源项目 book-sources;源文件:extracted/RESTful Web API Patterns and Practices Cookbook Connecting and Orchestrating Microservices and Distributed Data (Mike Amundsen)/_epub-src/OEBPS/ch01.xhtml;小节:词汇与长期原则)
- 结论依据:原文以开放网络上的服务可能被未曾见面的使用者组合,用于最初未预想的问题,并持续远超原定寿命的机制或场景为依据;同小节余文补充本卡所列条件,按2022年原书语境整理。
- 原始内容:For this reason, it is important to carefully and explicitly define our service interfaces with coherent and consistent vocabularies. We need to apply Eric Evans’s ubiquitous language across services. We need to make it easy for people to understand the intent of the service without having to hear us explain it. Our implementations need to be—to borrow Fielding’s phrase—“state-less”; they need to carry with them all the context needed to understand and successfully use the service.