問題タブ [swagger-ui]
For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.
groovy - swagger の groovy モデル クラスのメタクラス プロパティを除外する
「グルーヴィーな」クラスのモデルのメタクラス プロパティを応答として除外するにはどうすればよいですか? 私は、swagger @ApiModel で注釈が付けられたグルーヴィーなオブジェクトを返す Jax-Rs リソースを持っています。Swagger UI にグルーヴィーな特定の属性が多すぎます。シリアル化から除外するにはどうすればよいですか?
pogo-json シリアライゼーションに Jackson を使用しているようですか？Groovy クラスに注釈を付けて、メタクラス プロパティが json のシリアル化された文字列に入らないようにするにはどうすればよいですか? JsonIgnoreProperties アノテーションを使用してみましたが、役に立ちませんでした。
java - Swagger UI、Jersey、およびファイルのアップロードを構成する方法は?
私は、次のようなファイルアップロード方法を備えたジャージーサービスを持っています(簡略化):
それは機能し、Chrome の Postman 拡張機能を使用して正常にテストできます。
ただし、Swagger は「file」という名前の 2 つのパラメーターを認識します。InputStreamどういうわけか、パラメーターとFormDataContentDispositionパラメーターが実際には同じfileパラメーターの2つの部分であることを理解しているようですが、パラメーターについてはそれがわかりませんFormDataBodyPart。
これは、パラメーターの Swagger JSON です。
その結果、Swagger UI はファイル ピッカー フィールドと、FormDataBodyPart 引数用の追加のテキスト フィールドを生成します。
そのため、Swagger UI でファイルを選択してフォームを送信すると、アップロードされたファイルのコンテンツではなく、InputStream のテキスト フィールドのコンテンツを読み取ることになります。テキストフィールドを空のままにすると、ファイルの名前が取得されます。
FormDataBodyPart パラメータを無視するように Swagger に指示するにはどうすればよいですか?
または、回避策として、アップロードされたファイルのメディア タイプを FormDataBodyPart オブジェクトなしで取得するにはどうすればよいですか?
私は Jersey 2.7 と swagger-jersey2-jaxrs_2.10 バージョン 1.3.4 を使用しています。
jhipster - http://localhost:9000/api-docs/ から swagger JSON を読み取れません
api-docs は以前は正常に機能していました。それは動作を停止し、今私は得る
src/main/webapp/swagger-ui/index.html を変更すると
「サーバーから読み取れません。適切なアクセス制御元の設定がない可能性があります。」
swagger - Swagger UI は別のアプリケーションにする必要があります
私は現在、春の MVC RESTful サービス プロジェクトのスワッガー構成と戦っています。私はswagger-springに従うことにしましたが、 swaggerのUI部分がまったく別のプロジェクトであるべきなのか、それともコンテナの同じコンテキストにあるべきなのか理解できませんか?
spring mvc ベースの RESTFul サービスからの swagger json は、次のようなリンクに正しく表示されhttp://<server>:<port>/<context>/api-docsますが、アプリケーション (JSP、CSS、および JS ファイル) に swagger UI コンポーネントを配置するたびに、swagger UI にアクセスできません。このように。
swagger - 複数の RESTFul サービスの Swagger UI
私はここで次のことを読みました：
現在、Swagger には、クライアントまたはサーバーの観点から複数の API バージョンをサポートするための提案は含まれていません。バージョン管理情報 (仕様と基になる API 実装の両方) が宣言されています。
私が知りたいのは、複数のサービス、つまり異なるサーバーに存在するサービスの API を表示するように swagger UI を構成する方法です。別のサーバーで Swagger UI を構成しようとしましたが、次のエラーが発生します。
サーバーから読み取れません。適切な access-control-origin 設定がない可能性があります。
サーバーでCORSを有効にすることについて読んだことがありますが、サービスがlibertyプロファイルで実行されるため、私の場合は役に立ちませんでした。
Swagger UI はローカルで実行される WAS の liberty プロファイルで構成され、サービスは別の WAS インスタンスで実行されます。
私が進めている方向は、複数のサービスに UI を持たせることですが、これは論理的な出発点だと思いました。
spring-boot - スプリング ブートで Swagger UI を取得できない
http://raibledesigns.com/rd/entry/documenting_your_spring_api_withの記事をフォローしています。
すべて正常に動作しますが、Swagger UI を統合できません。
/error リダイレクトが発生します。