アプリエンジニアのためのGraphQL入門.pdf

アプリエンジニアのための GraphQL⼊⾨

note inc. ‧2024年2⽉にnoteにジョイン ‧note Appチームリーダー ‧2015年〜モバイルアプリを専⾨に扱うようになる ‧それ以前はPHPやRubyでのバックエンド開発がメイン Spycwolf Kota KANEKO
2

note inc. GraphQLとは https://graphql.org/ • API のクエリ⾔語であり、既存のデータを使⽤してそれらのクエリを実⾏するためのランタイムです。GraphQL は API
内のデータの完全でわかりやすい説明を提供し、クライアントが必要なものだけを正確に要求できるようにします。 • GraphQL クエリを API に送信すると、必要なものだけが正確に取得されます。それ以上でもそれ以下でもありません。GraphQL クエリは常に予測可能な結果を返します。 • GraphQL クエリは、1 つのリソースのプロパティにアクセスするだけでなく、それらの間の参照もスムーズに追跡します。⼀般的な REST API では複数の URL からの読み込みが必要ですが、GraphQL API では 1 回のリクエストでアプリに必要なすべてのデータを取得します。

note inc. GraphQLとの出会い • GraphQLは元々Facebookの内部で開発されたもので、2015年に⼀般に公開され、その後、2018年に現在のGraphQL Foundationに移譲された • 2017年に新規アプリサービスの開発に伴い、当時のチームメンバーとGraphQL の導⼊を決めた
• APIとクライアントアプリとを並⾏してゼロから開発するタイミングで、関係するエンジニア4⼈全員がAPIもアプリも両⽅を開発していった GraphQL導⼊の判断 • 実装する前段階の設計についてほぼ検討する箇所がない • REST APIは会社ごと、チームごとに設計が異なり、新規に開発するにも設計部分に検討が必要そうだった • 単純に新しいものを使ってみたかった！

note inc. 当時の感想 • 当時はまだ細かい配慮が必要ではあったが、とにかく直感的に実装しやすい • indexとshowの区別を厳密に考慮しなくても後々困ることが少ないため、クライアント側の画⾯要件が固まっていなくてもAPI側の開発を進められる • REST
APIに対しても当時からCodegeneratorはあったが、Apolloが扱いやすい • Grapiqlのようなプレイグラウンド環境が標準で備わっていて、クライアントからのスキーマ確認&レスポンス確認がしやすいサーバーサイドの開発に慣れていないモバイルアプリエンジニアでも実装しやすい！

note inc. 覚えておくべきことはたった3つ

note inc. Schemaを定義する • 取得系はQuery、更新系はMutationという概念 • 基本的にはリソースごとに取得できるカラム情報を定義する •
ここで定義するスキーマは、そのままクライアントからクエリとして指定できるものになる • QueryもMutationもinputとして引数を設定できる • 基本的にはこれだけ

note inc. Resolverを定義する • Resolverはリソースとスキーマとの関連を定義する • データベースから取得したデータをそのままスキーマに当てはめる場合が多いが、取得したデータを加⼯して返却する場合もある
• UseCase的なレイヤー

note inc. Serviceを定義する • データベースとのやり取りは別定義にするケースが多い • ここで定義したデータ取得する、もしくは更新系の処理を⾏う •
Repository、DataSource的な役割

note inc. プロジェクトの覗きかた • graphqlはエンドポイントが1つなので、/grapql というディレクトリを探す • その配下に schema や
resolver などが⾒つかるはず • データリソースへのアクセスは resolverから辿れるはず • レスポンスを確認したいときは schema のネーミングから、該当する resolver を探す • resolver の定義を確認すれば何をしているのか、どこからデータを持ってきているのか、どこでデータを処理しているのかがわかるはず

note inc. 実際にプロダクトで扱うには3つだけ理解しておけばいいなんてことはありません！

note inc. 普段あまりAPIの実装をしたことがない⽅もチャレンジしてみてください

Thank you   !

アプリエンジニアのためのGraphQL入門.pdf

アプリエンジニアのためのGraphQL入門.pdf

spycwolf

More Decks by spycwolf

Other Decks in Technology

Featured

Transcript

アプリエンジニアのための GraphQL⼊⾨

note inc. ‧2024年2⽉にnoteにジョイン ‧note Appチームリーダー ‧2015年〜モバイルアプリを専⾨に扱うようになる ‧それ以前はPHPやRubyでのバックエンド開発がメイン Spycwolf Kota KANEKO

note inc. GraphQLとは https://graphql.org/ • API のクエリ⾔語であり、既存のデータを使⽤してそれらのクエリを実⾏するためのランタイムです。GraphQL は API

note inc. 覚えておくべきことはたった3つ

note inc. Schemaを定義する • 取得系はQuery、更新系はMutationという概念 • 基本的にはリソースごとに取得できるカラム情報を定義する •

note inc. Resolverを定義する • Resolverはリソースとスキーマとの関連を定義する • データベースから取得したデータをそのままスキーマに当てはめる場合が多いが、取得したデータを加⼯して返却する場合もある

note inc. Serviceを定義する • データベースとのやり取りは別定義にするケースが多い • ここで定義したデータ取得する、もしくは更新系の処理を⾏う •

note inc. プロジェクトの覗きかた • graphqlはエンドポイントが1つなので、/grapql というディレクトリを探す • その配下に schema や

note inc. 実際にプロダクトで扱うには3つだけ理解しておけばいいなんてことはありません！

note inc. 普段あまりAPIの実装をしたことがない⽅もチャレンジしてみてください

Thank you   !