OpenAPI Generator 使ってみる（Java女子部ハロウィンLT）

Java女子部ハロウィンLT大会（2021.10.31）でのLT資料です
https://javajo.doorkeeper.jp/events/128695

Transcript

1. OpenAPI Generator 使ってみる Java⼥⼦部ハロウィンLT
2. ぽんしゅきーの振り返りもかねて OpenAPIのドキュメントを書いて OpenAPI Generatorでコードを ⾃動⽣成してみることにしました https://github.com/mii1004/SylvanianHalloween あらすじ
3. やること • なにつくるか決める • ドキュメントを書く • プロジェクトを作る • OpenAPI Generatorを動かす
4. つくるもの 昨⽇⾏ったシルバニアハロウィンが めっちゃ良かったので そんな感じのAPIを作る
5. Stoplight StudioでAPI仕様を書く https://stoplight.io/studio/ Mac版を使いました。GUIでぽちぽちすればOpenAPIの仕様書が書けます。
6. シルバニアハロウィンのコラボメニューを 全件 or おすすめ１件取得できるような APIにしてみました
7. YAMLでExportできた◎
8. Spring initializerで Gradleプロジェクトを作る https://start.spring.io/
9. OpenAPI Generatorのドキュメントと ぽんしゅきーのリポジトリを参考にしながら build.gradleにOpenAPI Generatorを 追加してゆく https://openapi-generator.tech/docs/plugins/ https://github.com/java-women/Ponsyukey バージョン差異にめちゃくちゃはまる （Gradle7.x でエラーになり、OpenAPI 3.1.xでもエ ラーになる）
10. ちょっと怒られつつもOpenAPI Generatorで⾃動⽣成できた︕
11. • ⼤体ぽちぽちだけで Controllerの⾃動⽣成まで できた • シルバニアはとてもいい • ぽんしゅきーよろしくね