知识卡片
资源契约遵循REST
资源契约从调用者要操作的对象建模:查询订单面向Orders,统计分析也可识别AnalysisResults,而不只暴露一个含混的AnalysisService。完整资源契约还要交代动作、请求/响应表述和状态信息。
本书以HTTP介绍统一接口。按RFC 9110,幂等比较重复请求对服务端的预期效果,并不要求响应完全相同;安全方法的语义不请求业务状态变更,允许日志等附带行为。GET安全且幂等,PUT/DELETE幂等但不安全;POST不保证幂等,PATCH也不自带幂等保证,具体补丁可按幂等方式设计。原文OPTION应为OPTIONS,POST也不限于创建资源。
补充核验(2026-10-24):RFC 9110 §9.2、RFC 5789 §2。这些补充用于限定原书简表,不把选好动词等同于完成REST设计。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 1 处
- 第11章 服务契约设计 · 查看原书依据
REST服务设计的关键是从资源的角度思考服务设计:“资源是基于Web系统的基础构建块,在某种程度上,Web经常被称作是‘面向资源的’。一个资源可以是我们暴露给Web的任何东西,从一个文档或视频片段,到一个业务过程或设备。从消费者的观点看,资源可以是消费者能够与之交互以达成某种目标
参考来源
- 位置:《解构领域驱动设计》第11章11.2.2(源文件:extracted/解构领域驱动设计/_epub-src/OEBPS/022.xhtml)
- 结论依据:Fielding统一接口约束论述、表11-1常用HTTP动词幂等/安全指标。
- 原始内容:REST服务设计的关键是从资源的角度思考服务设计……强调组件之间要有一个统一的接口。