問題タブ [swagger-3.0]

Java で swagger codegen を使用して OAS 仕様の yaml ファイルを生成する方法を探すのに何時間も費やしましたが、あきらめました。Java ソース内のすべての API 仕様データをコード アノテーションとして提供したいと考えています。Maven経由で公開するのは素晴らしいことです。

私の知る限り、 swagger-codegen-maven-pluginを使用する必要がありますが、ソースコードをスキャンして OAS yaml または JSON ファイルを生成することはできませんでした。

有効な codegen プラグイン構成を含む pom.xml のスニペットをいただければ幸いです。

この使用例は 2.x で単純に処理されたので、おそらく以前の Swagger に戻る必要があります。今、私は3.xのアプローチに不満を感じています。

Swagger を使用して、オブジェクト配列パラメーターを持つ API POST 呼び出しを文書化しようとしています。しかし、Swagger UI でテストしようとすると、 ではexplode: true無視されているようencoding:filtersです。これは私のコードです：

たとえば、パラメーターとして使用する場合

次に、Swagger UI は以下を使用して呼び出しを生成します (読みやすくするために URL エンコーディングを省略した場合)。

どうすれば生産できるようになりますか

代わりは？

「エンコーディング オブジェクト」のOpenAPI 3.0.2 ドキュメントには、「explodeリクエスト ボディのメディア タイプが application/x-www-form-urlencoded でない場合、プロパティを無視する必要がある」と記載されています。ただし、ここでは application/x-www-form-urlencoded を使用しています。それともドキュメントが間違っていて、「リクエストボディのメディアタイプ」ではなく「現在のオブジェクトのコンテンツタイプ」と記載する必要がありますか? しかし、その後、パラメータ値として実際の配列を取得すると想定していました。つまり、

問題がある場合: Swagger UI バージョン 3.24.3 を使用しています。