問題タブ [swagger-codegen]

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

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

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

言語:

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

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

• https://github.com/grokify/api-specs/blob/master/official_codegen_sdks.tsv

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

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

• https://github.com/grokify/go-aha
• https://github.com/grokify/go-ringcentral
• https://github.com/grokify/go-visa
• https://github.com/grokify/go-voicebase-v3

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

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

swagger コード gen を使用して、swagger.json ファイルから大量の csharp ファイルを生成する方法を学習しています。

CSharpClientCodeGen.class には、API およびモデルの cs ファイルを生成する apiPackage および modelPackage の変数があることに気付きました。apiPackage と modelPackage に似た新しいパッケージを作成したいと考えています。

次のコードに追加してみました

その後、クライアント コードをビルドしましたが、そこに新しいパッケージ フォルダーが表示されません。

これを行う方法がわからない。これを行う方法に関するリソースを教えていただければ幸いです。

ありがとう

swagger-codegenクライアント側の C# クラスを生成するために使用しています。それは仕事をしますが、カスタマイズしたいことがいくつかあります：

1) 最も重要なのは、使用する名前空間、またはおそらく基本名前空間をどのように指定するかです。現在、生成されたすべてのクラスにIO.Swagger.Model名前空間があります。これを変更するにはどうすればよいですか?

2) 生成されたすべてのモデルは I で始まります... ICustomer のように... クラス名が 2 つの大文字で始まり、最初の文字が I である場合、最初に I をオートストリップする方法はありますか?

3) 2 が実行できる場合、: を追加する方法はありますIWhateverか? したがって、 gen しようとしている場合は、次のICustomerことを確認したいと思います。

これはできますか？

4) 最後の質問では、次のコマンドラインを使用しています。

問題は、これがパスに追加されることです: src\main\csharp\IO\Swagger

これをパスに追加しない方法はありますか?

5) 最後に、最も重要なこととして、4 つのフォルダー ( Api、Client、Model、および ) が生成されPropertiesます。ClientおよびModelフォルダーのみを生成する方法はありますか?

同じモジュールのコントローラーから Angularjs サービス内の変数の値を変更できる必要があります。TL;DR バージョンは以下です...

私は、swagger ファイルで記述された RESTful API を備えた組み込みシステムを持っています。Angularjs アプリ経由でアクセスしています。このアプリを作成するために、swagger-codegen を使用してサービスを自動生成しました。これにより、$http への呼び出しからサービス内で使用されるベースパスがサービスに渡されます。サービスは次のようになります。

angular app.js ファイルには、次のものがあります。

これはすべてうまくいきます。ただし、アプリケーション内からデバイスのベースパス (具体的には IP アドレス) を設定できるようにしたいと考えています。しかし、サービスは最初から開始されており、コントローラーがサービス変数 basePath_ を更新できるようにする方法がわかりません。

basepath をパラメーターとして受け入れるようにサービス関数を書き直すことはできますが、swagger-codegen によって自動生成されるサービスは書き直したくありません。

私はどんな解決策にもオープンです - これを行うための全体的な最善の方法についてのアドバイスを探しています.

更新: 2016 年 5 月 24 日 - 誰かが私にスワッガー コードを投稿するように依頼しました。これは、初期サービス関数とメソッドを含むファイルの 1 つの関連部分です...

swagger-codegen maven プラグインを使用して API 用の JAX-RS サーバー スタブを生成したいのですが、生成されたものではなく、独自のサービス実装クラスを使用したいと考えています。このクラス以外のすべてを生成する方法はありますか? 私の API では、ツールは ProfilesApi、ProfilesApiService、ProfilesApiServiceFactory、および ProfilesApiServiceImpl の 4 つの API クラスを生成します。

私の現在のmaven構成：

私はこの闊歩の定義を持っています

しかし、それは私に以下のエラーを与えます

✖ Swagger エラー 有効なパラメーター定義ではありません 6996 行目にジャンプ 詳細 オブジェクト コード: "ONE_OF_MISSING" params: 配列 [0] メッセージ: "無効なパラメーター定義" パス: 配列 [5] schemaId: " http://swagger.io /v2/schema.json# " inner: Array [2] level: 900 type: "Swagger Error" description: "Not a valid parameter definition" lineNumber: 6996

私は C# で多くの API を作成し、Swashbuckle を使用して "Swagger" ドキュメント Web サイトを作成しました。

認証 REST 呼び出しでは、ヘッダーで API キーを使用します。

ここに記載されているように、任意のプログラミング言語の特定のクライアントをダウンロードできるページを作成しました: https://generator.swagger.io

ユーザーが自分の API キーを使用してクライアントを生成できるようにして、コードで API キーを手動で設定する必要がないようにしたいと考えています。

私の Swagger JSON には、次のセキュリティ定義があります。

Swagger Client Generator のページで、クライアント オプションの設定を許可するこのモデルを見つけましたが、クライアント コードで API キーをハード コード (またはその他の種類の承認) する方法 (およびその場合) を見つけることができません。

AuthorizationValue オブジェクトを設定する必要があると思いますが、それに関するドキュメントはありません (または見つかりません)。

生成されたクライアント ライブラリで、すべてのリクエストに任意の HTTP ヘッダーを追加できれば十分です。

その場合、次のように追加できます。

誰にもアイデアがありますか？

どうもありがとう！

ここにswagger-codegen-maven-plugin説明があります。目的とは何invokerPackageですか？そして、それはどのように異なりapiPackageますか？

ここに未解決の問題を残しました

カスタム codegen を作成しようとしています。ファイルを codegen プロジェクト内に配置することで機能させることができましたが、次のように機能させたい: https://github.com/swagger-api/swagger-codegen#独自のコード生成モジュールの作成

自動生成されたプロジェクトをまったく変更していませんが、取得し続けています:

これはコマンドラインです：

ここからjarを取得しましたhttps://mvnrepository.com/artifact/io.swagger/swagger-codegen-project/2.1.6 これは私がやっていることです:

1. 実行 java -jar swagger-codegen-cli-2.1.6.jar meta \ -o output/myLibrary -n myClientCodegen -p com.my.company.codegen してコスチューム コードジェンを作成する

2. mvn packageoutput/myLibrary で実行

3. java -cp output/myLibrary/target/myCustomCodegen-swagger-codegen-1.0.0.jar:swagger-codegen-cli-2.1.6.jar io.swagger.codegen.SwaggerCodegen generate -i https://watson-api-explorer.mybluemix.net/listings/conversation-v1-experimental.json -l com.my.company.codegen.Mycustomcodegengenerator -o outputlocationswagger-codege-cli-2.1.6.jar と出力フォルダーの両方を含むフォルダーで実行します。

最初の部分を削除するとクラスは見つかりますが、新しい言語は見つかりません。

「エラー：メインクラスが見つからないか、ロードできませんでした」という問題の回答を見てきましたが、修正できませんでした。

ここにjarへのリンクがあります