SpringBoot で API 仕様書をコードから自動生成する方法を少し調べた
SpringBoot で API 仕様書をコードから自動生成する方法を少し調べたのでメモしておく。
- SpringFox
- 使ったことある、使うの簡単
- メンテ止まっている、OpenAPI 3.0 の対応もあやしい... Springfox 3.0 Progress report...
- springdoc-openapi
- メンテもされてる、Spring5 以降の新しい機能にも対応していそう Question: differentiation to springfox-project
- Spring REST Docs
- asciidoctor でドキュメントを書ける
- Spring MVC Test でテスト書くとドキュメント化してくれるらしい (この機能は結構好き)
(あんまりちゃんと調べてないので間違っているかも)
springdoc-openapi がいいかなーと思った。 SpringFox から乗り換えたい。