知识卡片
客户端SDK复用DTO契约
DDDML 不只生成 Java/C# 服务端 RESTful API,也能生成多语言客户端 SDK。书中服务端接口的输入和返回值通常是带 Dto 后缀的静态类型,客户端 SDK 以这些类型为基础,承载状态、命令、事件等对象。对 Java、C# 这样的静态语言,生成类型让调用方在编译期和 IDE 中看到字段与方法契约,减少手写 Map/Dictionary 时的键名与类型猜测。生成客户端 DTO 的价值来自接口契约与调用代码保持一致;模型变更后仍须同步重新生成和核对兼容性。
这张卡片看不懂?
这张卡片的反馈已满 10 条,暂时无法继续提交。
已有反馈 · 0 / 10 条
还没有人提交反馈。
原书出处
参考来源
- 位置:《深入实践DDD:以DSL驱动复杂软件开发》第163章《13.5 生成Client》(源文件:_epub-src/OEBPS/Text/chapter165.xhtml)
- 结论依据:原文说明工具生成多语言 Client SDK,包含状态、命令、事件等静态类型,且服务端参数与返回 DTO 是 SDK 基础;同步生成与兼容性为据此作出的维护推论。
- 原始内容:在为静态语言(比如Java、C#等)生成的Client SDK中包含并使用各种对象(包括状态对象、命令对象、事件对象等)的静态类型是绝对有必要的。
- 补充原文:在默认情况下,工具生成的服务端RESTful API层的代码中,输入参数以及返回结果的类型都是静态类型(它们一般带有Dto后缀),这些静态类型也是生成Client SDK的基础。