知识卡片
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方法应该保证幂等性。