知识卡片

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

删除命令元数据传参

理解等级:中级

DDDML 生成的 Car 删除接口使用 DELETE /Cars/{id},将 commandId、version 和可选的 requesterId 放在查询参数中。生成方法以这些参数构造 DeleteCar 命令,核对路径 ID 后交给应用服务;commandId 与 version 在方法签名中为必填。书中这样设计的理由是避免依赖 DELETE 请求体。这里描述的是该工具的接口契约,客户端应按它传入命令标识和聚合版本,不能只发送资源路径。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    原书出处

    参考来源

    - 位置:《深入实践DDD:以DSL驱动复杂软件开发》第155章《13.2.4 DELETE》(源文件:_epub-src/OEBPS/Text/chapter157.xhtml) - 结论依据:原文给出带查询参数的 DELETE 路径、`@NotNull` 标注和构造 DeleteCar 命令的代码,并说明不使用请求体的理由。 - 原始内容:{BASE_URL}/Cars/{id}?commandId={commandId}&version={version}&requesterId={ requesterId} 为支持这个方法而生成的Java代码如下: @Path("{id}") @DELETE public void delete(@PathParam("id") String id, @NotNull @QueryParam("commandId") String commandId, @NotNull @QueryParam("version") @Min(value = -1) Long version, @QueryParam("requesterId") String requesterId) - 补充原文:因为HTTP DELETE请求一般来说是不应该携带消息体的,所以需要通过查询参数来传递聚合根的版本号等信息。