Kotlin + DGS で始めるスキーマファーストな GraphQL サーバー開発

サーバーサイドKotlin LT大会 vol.11 の発表資料です！
https://server-side-kotlin-meetup.connpass.com/event/309183/

Transcript

1. Kotlin + DGS で始める スキーマファーストな GraphQL サーバー開発 Server-Side Kotlin meetup 2024/03/08 @sukechannnn
2. 自己紹介 小幡 洋介 （@sukechannnn） アルダグラム EM & PdM • 2022年12月にアルダグラムにジョイン • Kotlin 歴は10ヶ月 ◦ 新規プロダクトを Kotlin + GraphQL で開発 ◦ Rails × React で GraphQL な開発してきました
3. KANNA(カンナ) は、 建設業、不動産業、製造業など、 世界中のノンデスクワーク業界における 現場の生産性アップを実現する「プロジェクト管理アプリ」です。 事務作業や移動、コミュニケーションの手間を カンナのように削り、作業の生産性を最大化します。 スマホでの使いやすさが支持され、 業界・国境を越えて高い評価をいただいております。 PRODUCT
4. PRODUCT Kotlin + GraphQL で開発してる CQRS で イベントソーシングなプロダクトです
5. Kotlin + DGS でスキーマファーストなGraphQL開発の良いところ • DGSとは • スキーマファーストで開発をするための支援機能がいい感じ • Relay-style cursor pagination が簡単に定義できる • GraphQL クライアントを graphql.schema から自動生成できる • テスト実行がしやすい便利機能がある 今日話すこと
6. Netflix DGS (Domain Graph Service) Framework とは、 • Netflixによって開発されているGraphQLのフレームワーク • GraphQL Java がベース • Spring Boot でスキーマベースな開発ができる • マイクロサービスの実装をすることを念頭に作られている • 外部GraphQLサーバー用クライアント生成をサポート • もちろんモノリシックなサーバーとして開発することも可能 • Kotlin にも対応してる！しかもより便利に使える！ DGSとは
7. スキーマを定義すると スキーマファーストで開発をするための支援機能がいい感じ
8. こんなデータクラスが生成され スキーマファーストで開発をするための支援機能がいい感じ
9. こんな感じで実装できます！ スキーマファーストで開発をするための支援機能がいい感じ
10. GraphQL で利用するデータクラスの Nullability をより適切に扱うこともできます（まだ Experimental ですが） GraphQL ではクライアント側で取得する field を自由に選択できます。つまり、Kotlin でデータを返そうとした時にデ ータクラスの一部のプロパティが欠落した状態が発生し得ます。そのため、単純に Kotlin のデータクラスの全てのプロ パティを non-null として定義することができません。 generateKotlinNullableClasses = true を追加すると、そこらへんの取り回しを考慮したクラスを生成してくれます。 スキーマファーストで開発をするための支援機能がいい感じ
11. スキーマベースで開発する時に面倒なのが Pagination Relay-style cursor pagination が簡単に定義できる
12. スキーマベースで開発する時に面倒なのが Pagination Relay-style cursor pagination が簡単に定義できる DGS なら @connection ディレクティブを 付けるだけ
13. 外部 GraphQL の graphql.schema を使ってクライアントを自動生成できます （ただ、書き方にけっこうクセがあります...） GraphQL クライアントを graphql.schema から自動生成できる
14. と思っていたら、Kotlin で GQL っぽく書けるオプションがありました！ まだちゃんと試せていないので、改めて試したらブログ書こうと思います GraphQL クライアントを graphql.schema から自動生成できる
15. DgsQueryExecutor というクラスがあって、GraphQL 実行後の結果を簡単に検証できる テスト実行がしやすい便利機能がある
16. Kotlin + DGS でスキーマファーストなGraphQL開発の良いところ • DGSを使うとスキーマ駆動開発する上で面倒なところがサポートされてる • 外部 GraphQL へのリクエストもスキーマを読み取っていい感じにできる • サーバーサイド、サーバー間、Webフロント、アプリとスキーマベースで 設計&議論しながら開発することで、実装開始後の齟齬を減らせる より詳しい内容は以下の記事をご覧ください！ https://zenn.dev/aldagram_tech/articles/0d43033077f595 まとめ
17. べんり！
18. Kotlinエンジニア積極採用中です！！！