知识卡片
PATCH不等于合并补丁
DDDML 生成的 PATCH /Cars/{id} 接受 MergePatchCarDto,把它作为 MergePatchCar 命令交给应用服务,并先核对路径 ID 与命令 ID。但书中明确说明,这个接口虽叫 MergePatch,实际没有实现 JSON Merge Patch 规范;客户端也无需发送 Content-Type: application/merge-patch+json。因此不能仅凭 HTTP 方法或 DTO 名称推断补丁文档的语义,集成时须按生成接口的实际契约处理字段更新与删除。
这张卡片看不懂?
这张卡片的反馈已满 10 条,暂时无法继续提交。
已有反馈 · 0 / 10 条
还没有人提交反馈。
原书出处
参考来源
- 位置:《深入实践DDD:以DSL驱动复杂软件开发》第154章《13.2.3 PATCH》(源文件:_epub-src/OEBPS/Text/chapter156.xhtml)
- 结论依据:原文给出 PATCH 的生成方法,并明确否认其支持 JSON Merge Patch 规范;契约风险是由两者名称相近而语义不同推得。
- 原始内容:虽然这里使用了MergePatch这个说法,但是展示的(由作者制作的DDDML工具生成的)RESTful API并没有真正支持JSON Merge Patch规范。这里的PATCH就是一个普普通通的Patch,客户端不需要在请求中添加如下的头信息: Content-Type: application/merge-patch+json