使用Swagger codegen生成RX JAVA + Retrofit sdk

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月,Swagger Codegen的大约50名顶级贡献者和模板创建者决定使用Swagger Codegen来维护一个名为OpenAPI Generator的社区驱动版本.有关更多信息,请参阅问答.