Day1 15:00 ~ 15:20 Play Framework プロジェクトにおける Swagger (OpenAPI) ドキュメントの自動生成

[Javakky-pxv]

Title / タイトル

Play Framework プロジェクトにおける Swagger (OpenAPI) ドキュメントの自動生成

Summary / 概要

play-swagger を利用した OpenAPI ドキュメントの生成方法を紹介します。
特に、 Scaladoc を利用した埋め込みや複数の XML ファイルを分割することで routes ファイルを汚染しないための Tips を解説します。
また、 Swagger UI や Stoplight Elements などの OpenAPI ビューワーの比較と Play 連携についても解説します。

Enter your Discord server nickname / Discord サーバーニックネーム を記入してください

Javakky

Do you have any materials (slides, etc.) for your presentation? Check if yes. / 発表に使う資料（スライドなど）はございますか？ ※ある場合はチェック

• Yes / ある

How many minutes of LT do you plan to give? (Basically 20 minutes per slot) / 何分くらいの LT を予定していますか？（基本的に 1 枠 20 分となります）

20 min

By signing below, you agree to ScalaMatsuri's Code of conduct / 下記 ☑ をして、ScalaMatsuri の Code of conduct に同意してください

Code of conduct - ScalaMatsuri

https://scalamatsuri.org/ja/code-of-conduct

• I agree to ScalaMatsuri's Code of conduct. / ScalaMatsuri の Code of conduct に同意します

Other / その他

Please review the following and check all that apply. / 下記を確認し、すべてチェックしてください

Please note that your application may not always be accepted. Please understand beforehand. / 必ず採択されるとは限りません。予めご了承ください。

• Yes, I agree. / 承知しました

We will conduct a CoC check on the session content. Please be advised that we may reject your application as a result. / セッション内容について CoC チェックを行います。その結果、不採択とすることがありますのでご了承ください。

• Yes, I agree. / 承知しました

Please note that simultaneous translation will not be provided for the open mic conference. / 飛び入りカンファレンスでは、同時通訳は提供されないことにご注意ください。

Please be aware that while a open mic conference is a conference created by all participants, due to management and other circumstances, we may not be able to meet all expectations. / 飛び入りカンファレンスは参加者が全員でつくりあげるカンファレンスですが、運営やその他事情により、すべてのご期待に添えない場合がございますことを、予めご了承ください。

• Yes, I agree. / 承知しました

Link's リンク集

• Time table here
• Open Mic Conference - ScalaMatsuri 2023 CFP here
• Open Mic Conference - ScalaMatsuri 2023 Repository here

ScalaMatusri 2023

[https://scalamatsuri.org/:embed:cite]