2

Carma swagger-jaxrs-doclet を使用して、 maven ビルド サイクル中にswagger service.jsonおよびその他のresource.jsonを生成しています。その後、成果物を swagger-ui と共に Web サーバーにデプロイすると、生成されたドキュメントを参照できます。これは、アプリケーションで swagger Bean をデプロイしていないことを意味します。

swagger は主に API 実装に沿ってデプロイされるため、swagger-ui がドキュメントを実行可能にするためにどのアプローチを取るのか疑問に思っていました。swagger-ui ドキュメントから実際の実装にリダイレクトしますか、それともservice.json に基づいてモック バックエンドを作成しますか? service.json に基づいて node.js でバックエンドを作成できることを読みましたが、Web ページでそれを行う方法がわかりません。Web ページ内から可能であれば、私は今でもしませんか?

4

1 に答える 1

1

Swagger-ui は、公開する swagger 仕様を読み取り、文書化されている API を実行できるようにする html アプリケーションを公開します。バックエンドは作成せず、swagger-js プロジェクトを使用して仕様を動的に読み取り、呼び出しを実行します。

したがって、JavaScript ベースのアプリケーションには swagger-js がありますが、クライアントを生成したい場合は、swagger-codegen ( https://github.com/wordnik/swagger-codegen ) を使用できます。これは、所有している仕様ファイルを読み取り、許可します。クライアント、サーバー、静的ドキュメントなどの作成など、さまざまなタスクを実行できます。

于 2014-10-16T17:59:55.833 に答える