知识卡片

普通读书笔记卡 · 3437.a.4

HTTP方法承载不同操作语义

理解等级:初级

使用 HTTP 与 JSON 并不自动等于严格的 REST 设计;接口至少应按方法表达操作意图。按本书的简化说明:

方法 常见意图 关键约束
GET 读取资源 安全,不改变资源状态
PUT 用请求内容替换资源,必要时创建 应保持幂等
PATCH 提交局部变化 只更新指定部分
DELETE 删除资源 应保持幂等
POST 提交实体以触发处理 通常会改变状态

“幂等”指同一请求重复执行的预期效果与执行一次相同;它不等于首次执行不修改状态。具体接口仍要核对其实现是否兑现这些语义。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    原书出处

    参考来源

    - 位置:《深入实践DDD:以DSL驱动复杂软件开发》第147章《13.1 RESTful》(源文件:_epub-src/OEBPS/Text/chapter149.xhtml) - 结论依据:原文先区分 HTTP+JSON 与严格 REST,再逐一列出五种 HTTP 方法的用途,并明确 GET 安全、PUT 与 DELETE 应幂等。幂等的解释是对该约束的必要释义。 - 原始内容:·GET:表示获取数据。它不会改变资源的状态,所以这是一个安全的操作。 ·PUT:表示使用请求发送过来的内容完全代替现有的数据。如果资源还不存在,那么就创建它。PUT方法应该保证幂等性。