知识卡片
Retrofit映射聚合API
DDDML 可在 Java DTO 之上生成 Retrofit2 的 CarsClient 接口:@GET 方法返回 Call<List<CarStateDto>> 或 Call<WheelStateDto>,@Path 指定聚合和内部实体 ID,@Query 传排序、过滤及删除命令元数据,@Body 传创建、补丁或 Rotate 命令。这样客户端接口声明与服务端资源路径一一对应,调用者用静态类型组装请求。书中示例把 PUT/PATCH/DELETE/Rotate 返回类型写成 Call<String>,而前文生成的服务端方法多为 void;实际生成版本的响应契约需对照验证。
这张卡片看不懂?
这张卡片的反馈已满 10 条,暂时无法继续提交。
已有反馈 · 0 / 10 条
还没有人提交反馈。
原书出处
参考来源
- 位置:《深入实践DDD:以DSL驱动复杂软件开发》第166章《13.5.3 使用Retrofit2》(源文件:_epub-src/OEBPS/Text/chapter168.xhtml)
- 结论依据:原文给出 CarsClient 的 GET、PUT、PATCH、DELETE 和 Rotate Retrofit 注解签名;若干客户端写操作使用 `Call<String>`,而前文服务端方法签名为 `void`。书中没有端到端响应体证据,不能据此断定实际返回字符串。
- 原始内容:@GET("Cars") Call<List<CarStateDto>> getAll(@Query("sort") String sort, @Query("fields") String fields, @Query("firstResult") int firstResult, @Query("maxResults") int maxResults, @Query("filter") String filter);
- 补充原文:@DELETE("Cars/{id}") Call<String> delete(@Path("id") String id, @Query("commandId") String commandId, @Query("version") String version, @Query("requesterId") String requesterId);