問題タブ [swagger]
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.
api - Swagger と ServiceStack を使用して応答クラスを文書化する
wordnikのペットストアの例では、応答クラスのドキュメントが提供されています。/pet/{petId} エンドポイントで例を確認できます。
次のパラメーターをサポートしているようです。
- オプション (プロパティが常に応答に含まれるかどうかを指定するフラグ)
- 許容値
- 説明
ServiceStack 実装でこれを達成する方法はありますか?
jakarta-ee - Swagger は、カスタム オブジェクトのシリアル化をオーバーライドすることが可能です
API サービスの事実上のドキュメントとして使用するために、swagger をテストしています。永続化レイヤーに休止状態を使用しており、すべての応答がエンティティにバインドされています。問題は、これらのエンティティには他のエンティティとの依存関係があり、@ApiOperation 応答でオブジェクトを渡すときにこれらのエンティティを表示しないように、swagger を調整したいということです。私がオンラインで見つけることができる唯一の考えは、githubページからのこのリンクです。
私はこれをやってみました：
しかし、私はこのエラーが発生しています:
org.json4s.package$MappingException: java.lang.String に変換できる値が見つかりませんでした
一部のクラスをフィールドまたはリストで見つけたときにシリアル化を回避する方法はありますか?
java - JerseyJaxrsConfig クラスをグリズリーにサーブレットとして追加する方法
API ドキュメントを生成するためにSwaggerの実装に取り組んでいます。私はここの構成ガイドに従っています: https://github.com/wordnik/swagger-core/wiki/Java-JAXRS-Quickstartしかし、それはすべて XML ベースであり、実行時に同等であると信じていることを実行しようとすると構成 グリズリーが文句を言う - Cannot resolve method 'addServlet(java.lang.String, com.wordnik.swagger.jersey.config.JerseyJaxrsConfig)'.
JerseyJaxrsConfig extends HttpServletの代わりにそれのようですServlet。私ができることについて何か提案はありますか？
spring - NoSuchMethodError: com.sun.jersey.core.reflection.ReflectionHelper.getOsgiRegistryInstance()Lcom/sun/jersey/core/osgi/OsgiRegistry;
解決方法がわからない依存関係の競合があるようです。アプリケーションにSwaggerを実装しようとしています。Pom とスタック トレースを含めました。問題をよりよく説明するために他に何か含めることができる場合は、お知らせください。これをデバッグする方法がわかりません...
pom.xml
scala - java.lang.NoSuchMethodError: scala.Predef$.augmentString(Ljava/lang/String;)Lscala/collection/immutable/StringOps;
ここでエラーが発生しています。これは、依存関係との競合のようなものです。ソースを見ると手がかりが得られると思ったので、http:org.fusesource.scalate.jersey.ScalateTemplateProcessor //scalate.fusesource.org/maven/1.3/scalate-core/scaladocs/org/fusesource/scalate/jersey/ScalateTemplateProcessor.html にアクセスしました。. このクラスで、何を参照しているのかを理解するのに役立つ何かを見つけたいと思っていました。残念ながら、ここで実際に何が起こっているのか、私はまだ非常に混乱しています。java.lang.NoSuchMethodError: scala.Predef$.augmentString(Ljava/lang/String;)Lscala/collection/immutable/StringOps;
どのクラスをscala.Predef$.augmentString(Ljava/lang/String;)Lscala/collection/immutable/StringOps;参照していますか?
私のpom.xml
spring - json の代わりに xml 応答を吐き出す Swagger
私は春に生後1週間です。Spring + maven + Jackson を使用して、純粋な RESTful API サービスを開発しています。いくつかのベスト プラクティスを検討しているときに、これに遭遇したため、ドキュメントには spring mvc (および swaggerUI) で swagger を使用することにしました。私がやりたいことをするために、これとこのチュートリアルをやりました。/api-docs を押した後、チュートリアルやその他の場所での JSON 応答とは対照的に、XML 応答を受け取ったことに気付くまで、すべてが順調に進んでいました。SwaggerUI を追加するとうまくいきません。後で、swaggerUI が json を想定していることをここで知りました。私はいつでも戻って、サーバー統合なしで Swagger を使用できました ( https://github.com/wordnik/swagger-core/wiki/Adding-Swagger-to-your-API）、しかし、それは私のニーズを本当に満たすことはありません。
pom.xml の内容は次のとおりです。
サーブレット コンテキスト:
swagger.properties
「Accept」ヘッダーを「application/json」に設定して、chrome dev http ツールで GET /api-docs/ を試しましたが、うまくいきました。これは、どこかでリクエスト ヘッダーを手動で設定する必要があるということですか? 念のため web.xml を追加しています。
web.xml:
私は、swagger が特別な注釈を必要としないと考えているので、私の Java コードベースは同じままです。
この質問は長すぎますか？私はSOが初めてなので、許してください。編集して提案してください。
コントローラ クラス: