知识卡片
领域命令不必强凑资源名
把每个领域动作都硬改写成资源名,可能让 API 名称远离已建模的业务方法。可在聚合资源路径下保留明确的命令段:例如关闭订单用 PUT /Orders/{orderId}/_commands/Close,_commands 避免与实体属性同名;书中生成的实体方法带幂等处理,所以此例选 PUT。领域服务的转账示例则用 POST /TransferService/Transfer。这是一种允许部分 RPC 风格路径的工程取舍,应在接口文档中说明其方法语义与重复调用行为,不能仅凭 URI 外形断言符合严格 REST。
这张卡片看不懂?
这张卡片的反馈已满 10 条,暂时无法继续提交。
已有反馈 · 0 / 10 条
还没有人提交反馈。
原书出处
参考来源
- 位置:《深入实践DDD:以DSL驱动复杂软件开发》第148章《13.1.1 没有必要绞尽脑汁地寻找名词》(源文件:_epub-src/OEBPS/Text/chapter150.xhtml)
- 结论依据:原文先举 GitHub 用资源式加星的例子,再主张无需为每个 DDD 方法强凑名词,并分别给出命令路径的 PUT 例子和领域服务的 POST 例子及其理由。
- 原始内容:在这个URL中使用_commands是为了避免和Order实体的属性名称冲突。默认情况下,我们的工具为实体的方法生成的代码包含了幂等处理逻辑,所以这里使用的是HTTP PUT方法。