android - RX JAVA + Retrofit sdk 使用 Swagger codegen 生成

Question

我想使用 swagger codegen 生成 sdk，它可以给我生成的带有 Observable 作为回调的 sdk，如下所示:

@POST("oauth/token")
Observable < TokenResponse> getRepository(@Query("grant_type") String grantType);

Answer 1

您可以使用以下命令作为示例生成一个启用了 RxJava 的 Java Retrofit API 客户端:

java -jar modules/swagger-codegen-cli/target/swagger-codegen-cli.jar generate \
-l java -i http://petstore.swagger.io/v2/swagger.json \
-c /var/tmp/retrofit2rx/java-petstore-retrofit2rx.json \
-o /var/tmp/retrofit2rx 

和 JSON 配置文件 (/var/tmp/retrofit2rx/java-petstore-retrofit2rx.json) 定义了以下内容:

{
  "library": "retrofit2",
  "artifactId": "swagger-petstore-retrofit2-rx",
  "useRxJava": true,
  "hideGenerationTimestamp": true
}

然后您可以在 /var/tmp/retrofit2rx 文件夹下找到自动生成的代码。

请改用最新稳定版的 Swagger Codegen:https://github.com/swagger-api/swagger-codegen/releases ，或拉取最新的 swagger-codegen 大师以享受增强功能和错误修复。

要获取用于自定义 Java API 客户端的选项列表，请运行以下命令:

java -jar modules/swagger-codegen-cli/target/swagger-codegen-cli.jar config-help -l java

更新:2018 年 5 月，大约 50 名 Swagger Codegen 的顶级贡献者和模板创建者决定 fork Swagger Codegen 以维护一个名为 OpenAPI Generator 的社区驱动版本。 .请引用Q&A了解更多信息。