← 返回刚才阅读的位置

知识卡片

普通读书笔记卡 · 1969.l

资源契约遵循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服务设计的关键是从资源的角度思考服务设计……强调组件之间要有一个统一的接口。