問題タブ [springdoc-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.
spring-boot - Swagger 宣言 schema = @Schema(implementation = Map.class) は、swagger-ui でスキーマを String として表します
私はspringdoc
swaggerドキュメントを作成しようとしています.データ型を持つリクエストボディをクライアントにとってより読みやすい方法で表現したいと思いMap<String, Object>
ます. しかし@io.swagger.v3.oas.annotations.parameters.RequestBody(content = @Content(schema = @Schema(implementation = Map.class)
、スキーマが次のようになると宣言するとString
(下のスクリーンショットを添付)
メソッド宣言
Spring ブートはメソッド シグネチャに基づいて型を自動的に推測しますが、データ型については明確ではありませんMap
。たとえば、デフォルトでは、タイプ Map<String, Object> は次のように推測されます。
しかし、API を参照するクライアントにとって、よりわかりやすい方法でスキーマを表示したいと考えています。Githubに適切な解決策がないクローズド チケットがあることがわかりました。私の要件によると、リクエストの本文はタイプにとらわれず、動的なキーと値のペアである必要があるため、リクエストを として受け取る以外に方法はありませんMap<String, Object>
。Map
カスタムのリクエスト/レスポンスモデルを作成するよりも、タイプを使ってより良い方法を実装した人はいますか?
spring-boot - Spring Data REST を使用した Spring Boot OpenAPI 3
Spring Data REST API を OpenAPI で文書化することに失敗しています。swagger-ui のホームページ (および明らかに /v3/api-docs ) には何も表示されません。
これが私の依存関係からの抜粋です:
そして、私のJPAリポジトリがあります:
そして、これは私のSpring Bootのセットアップです:
もちろん、私の CRUD API は /people PATH で問題ありません。/profile/people PATH でさえ正しいようです。
私は何かが欠けている必要があります...助けてくれてありがとう。
openapi - SpringDoc/OpenApiでプロパティの代わりにJava構成を使用して複数のjsonファイルを読み取る方法は?
この問題は、以下のコード スニペットの swaggerfox で既に解決されています -
========================================
springdoc/openapi でこのコードを置き換える必要がありますか? 以下のプロパティフィールドがあります-
springdoc.swagger-ui.urls[0].url=/swaggerdoc/openapi.json
springdoc.swagger-ui.urls[0].name=openapi
しかし、プロパティ駆動の状態では、カスタム実装が必要であり、スプリングブート構成での実装が必要ですか?