16

Swagger Code Generator は、多くの言語で SDK を生成できます (Github プロジェクト ページから以下にリストされています)。Swagger の自動生成された SDK を、アルファ版/ベータ版と GA 版の両方で本番環境で使用している人はいますか? また、使用している場合、どの組織で、どの言語に対して使用していますか?

私はいくつかのGoogle検索を行い、周りに尋ねました. Swagger UI がデプロイされた例は数多く見つかりましたが、Code Gen SDK はまだ見つかりませんでした。

プロジェクトページ: https://github.com/swagger-api/swagger-codegen

言語:

$ ls -1 modules/swagger-codegen/src/main/java/com/wordnik/swagger/codegen/languages/
AndroidClientCodegen.java
AsyncScalaClientCodegen.java
CSharpClientCodegen.java
JavaClientCodegen.java
JaxRSServerCodegen.java
NodeJSServerCodegen.java
ObjcClientCodegen.java
PhpClientCodegen.java
PythonClientCodegen.java
RubyClientCodegen.java
ScalaClientCodegen.java
ScalatraServerCodegen.java
SpringMVCServerCodegen.java
StaticDocCodegen.java
StaticHtmlGenerator.java
SwaggerGenerator.java
SwaggerYamlGenerator.java
TizenClientCodegen.java

更新 - メジャー プロジェクトの公式 SDK 追跡 (2018 年 6 月)

私は、採用をより適切に追跡するために、ここで大規模な組織からの識別可能な公式のコード生成 SDK を追跡しています。一部の codegen プロジェクトを使用していると自称する組織の多くは、GitHub アカウントで SDK を公開していません。

更新 - 個人的な経験 (2017 年 12 月)

現在、Swagger Codegen for Go (2.2.3 - 2.3.1) を積極的に使用しています。これまでのところ、私の経験では、まともな仕事をしていますが、機能する SDK を取得するにはさまざまな手の微調整が必​​要になる可能性があるため、GitHub パッケージ/リポジトリは依然として優れています。私が管理している SDK の GitHub の問題でいくつかの問題を確認できます。codegen/swagger_codegen_command.shまた、各レポのファイルに後処理を追加します。

更新 - OpenAPI ジェネレーターの追加 (2018 年 7 月)

OpenAPI Generator は Swagger Codegen のフォークであるため、これについても言及されています。

4

4 に答える 4

10

Github で検索したところ、Swagger-Codegen によって生成されたプロジェクト (SDK) がいくつか見つかりました。

一例を次に示します。Online Convert API2 Swift SDK

Swagger-Codegenのユース ケースに関する議論については、 Swagger-Codegen Github ページも参照してください。

更新: 本番環境で Swagger Codegen を使用しているすべてではありませんが、一部の企業/プロジェクトを以下に示します: https://github.com/swagger-api/swagger-codegen#companiesprojects-using-swagger-codegen

注: 2017 年 7 月の時点で、Swagger Codegen は、API クライアント、サーバー スタブ、および API ドキュメント用に 70 を超えるジェネレーターを提供しています。

更新: 2018 年 5 月、約 50 人の Swagger Codegen のトップ コントリビューターとテンプレート作成者が、Swagger Codegen をフォークして、OpenAPI Generatorと呼ばれるコミュニティ主導のバージョンを維持することを決定しました。詳しくはQ&Aをご覧ください。

于 2015-07-12T04:29:52.357 に答える
2

これを使って spring codegen に基づいて API をブートストラップし、今ではそれを使ってドメイン モデルと API エンドポイントを変更および追加しています。生成されたクラスのいくつかの側面を変更する必要がありますが、リファクタリングが非常に簡単になり、技術的負債を積み上げるのを防ぐことができます。手動テスト用に生成された swagger-ui があると非常に役立ちます。また、スタブを生成する Postman に仕様をインポートできるため、テストを作成するための開始点と TODO の概要を把握できます。

ただし、SDK はまだ使用していません。さまざまな js クライアントを使用しようとしましたが、単純なフェッチ ライブラリよりも利点がありませんでした。

コード生成には、Angular や React + Redux などのより複雑な js フレームワークやテストの自動化の大きな可能性があると考えています。

于 2017-07-06T11:00:57.617 に答える