システム開発で思うところ

Javaで主にシステム開発をしながら思うところをツラツラを綴る。主に自分向けのメモ。EE関連の情報が少なく自分自身がそういう情報があったら良いなぁということで他の人の参考になれば幸い

Swagger/OpenAPIのメモ

SpringFox

SpringFox by 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

OpenAPI 文書のカスタマイズ

Documenting a Spring REST API Using OpenAPI 3.0 | Baeldung

@RestControllerAdvice and @ResponseStatus(HttpStatus.OK) overriding default response for @RestController methods · Issue #565 · springdoc/springdoc-openapi · GitHub

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 - 赤帽エンジニアブログ

OpenAPI (Swagger) 3.0 で Bearer トークンの使用を定義する | Articles | Riotz.works

Eclipse MicroProfile JWT Authentication API :: Payara Enterprise Documentation

MicroProfile OpenAPIによるAPI管理(Part2):MicroProfile OpenAPI annotationを利用しドキュメント化する|富士通技術者ブログ~Javaミドルウェア~ : 富士通

コードサンプル

https://github.com/extact-io/msa-rms-platform/blob/main/platform-fw/src/main/java/io/extact/msa/rms/platform/fw/webapi/server/CommonOpenApiModelReader.java

Payara-Examples/microprofile/openapi-example at dc53549a804017f7690450b9f897f4c7f9aabf07 · payara/Payara-Examples · GitHub

openapi-ext/openapi-examples/basic-example/pom.xml at main · microprofile-extensions/openapi-ext · GitHub

OpenAPI Generator

OpenAPI Generatorに適したOpenAPIの書き方 - ZOZO TECH BLOG