Swagger/OpenAPIのメモ
MicroProfile
Jakarta EE(標準)勢として(?)、OpenAPIを使った実装例
SpringFox
メモ
ぱっと調べると SpringでSwaggerは SpringFox くらいの 感じだったし、既存のプロジェクトでも使っていたから採用はしたものの、最新バージョン(3_0_0
)にすると SpringBoot2.6系にしたら 起動が出来なかった。
swagger-starter3.0 not support springBoot2.6.x version · Issue #3934 · springfox/springfox · GitHub (他にも類似のissueがあった気もするけど見つけられなかった)
メンテナンスも止まっているみたい(最終コミットが 2020年10月)
Commits · springfox/springfox · GitHub
positon
の順番が効かないとかもあるし、このまま使い続けるのは良くないかも。。
リンク
とはいえ、色々と参考になる(調べるときのヒントになる)かもしれないので気になる情報はメモしておく。
SpringFoxでのSwaggerのリクエスト・レスポンス説明の共通化 | GROUP DEV BLOG | TECHNO DIGITAL
springdoc-openapi
OpenAPI 3 Library for spring-boot
メモ
SpringFoxよりも こっちを使うようにした方が良いかも、、 ということで まずは情報収集。
少なくとも Swagger用ライブラリで SpringBootのバージョンアップの弊害になっているのは困る。
私のプロジェクトは始まったばかり。今なら間に合う。
リンク
SpringFoxからspringdoc-openapiに移行してみた #SpringBoot - Qiita
Documenting a Spring REST API Using OpenAPI 3.0 | Baeldung
Configure default response Message · Issue #381 · springdoc/springdoc-openapi · GitHub
springdoc-openapiでOpenAPI形式のAPIドキュメントを生成する - BullよりElk
Springdoc Openapiで全APIに認証の設定(security scheme)を指定する方法 #SpringBoot - Qiita
OpenAPI(Jakarta EE/MicroProfile OpenAPI)
リンク
MicroProfile OpenAPI 3.0の新機能と既存機能の比較 | 豆蔵デベロッパーサイト
みんなのためのMicroProfile OpenAPI - 赤帽エンジニアブログ
OpenAPI (Swagger) 3.0 で Bearer トークンの使用を定義する | Articles | Riotz.works
Eclipse MicroProfile JWT Authentication API :: Payara Enterprise Documentation