知识卡片

普通读书笔记卡 · 2274.n.7.b.2

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;实际生成版本的响应契约需对照验证。

这张卡片看不懂?

已有反馈 · 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);