Rails開発者向けGraphQL入門

Slide 1

Slide 1 text

Slide 2

Slide 2 text

©iCARE Co., Ltd All rights reserved 自己紹介  2 名前：安田俊之関わってきた技術 Ruby on Rails, Vue.js, AngularJS PHP： Symfony, FuelPHP, CakePHP Java： Androidアプリ、Spring Perl： CGI DB： PostgreSQL, MySQL, Oracle, PL/SQL その他： Terraform, Ansible, Chef, Nginx, etc.

Slide 3

Slide 3 text

Slide 4

Slide 4 text

Slide 5

Slide 5 text

Slide 6

Slide 6 text

©iCARE Co., Ltd All rights reserved GraphQLってなに？  6 無理やり、RESTに問い合わせ言語の概念を付与すると https://some.where/users の /users や https://some.where/users/1 の /users/1 の部分が問い合わせ言語になると言えるでしょうか。パッと見て分かる通り、RESTの仕様では、userのどういう属性を取得できるかは、問い合わせ内容からは不明ですし、どの属性が欲しくて、どの属性がいらないかの選択もできないことがわかるかと思います。

Slide 7

Slide 7 text

Slide 8

Slide 8 text

©iCARE Co., Ltd All rights reserved どんなメリットを得られるのか？  8 REST https://some.where/users GET GraphQL https://some.where/graphql POST query { users { name email } } ※他のデータへの問い合わせもエンドポイントは同じ/graphql リクエストの形式

Slide 9

Slide 9 text

©iCARE Co., Ltd All rights reserved どんなメリットを得られるのか？  9 問い合わせを受け取る実装 REST app/controllers/users_controller.rb class UsersController def index @users = User.some_scope end end GraphQL app/graphql/types/query_type.rb module Types class QueryType < Types::BaseObject field :users, [UserType], null: true def users @users = User.some_scope end end end ※GraphQL用のコントローラはあるが、全ての問い合わせで共通のコントローラ

Slide 10

Slide 10 text

©iCARE Co., Ltd All rights reserved どんなメリットを得られるのか？  10 レスポンス（もしくはレスポンス可能なもの）を定義する実装 REST app/views/users/index.json.jbuilder json.users @usrs do | c | json.name c.name json.email c.email ... end ↑ 該当のリクエスト専用の定義のため再利用不可 GraphQL app/graphql/types/user_type.rb module Types class UserType < Types::BaseObject field :name, String field :email, String end end ↑ 該当のリクエスト専用の定義ではないので再利用可能（ActiveRecordの定義同様）

Slide 11

Slide 11 text

Slide 12

Slide 12 text

©iCARE Co., Ltd All rights reserved どんなメリットを得られるのか？  12 実際のレスポンス REST { "users":[ { "name":"山田太郎", "email":"taro@yamada", } ] } GraphQL { "data":{ "users":[ { "name":"山田太郎", "email":"taro@yamada", } ] } }

Slide 13

Slide 13 text

©iCARE Co., Ltd All rights reserved どんなメリットを得られるのか？  13 1回のリクエストで得られるレスポンス REST userに紐づくorders（注文）を取得するときは、 userごとに別途リクエストをする必要がある GraphQL GraphQL側の型定義さえあれば、１回のクエリで入れ子構造のデータを取得することができる query { usrs { name email orders { price datetime } } } ※N+1問題に気をつける必要がある

Slide 14

Slide 14 text

©iCARE Co., Ltd All rights reserved どんなメリットを得られるのか？  14 まとめ 1. エンドポイントが一つ(/graphql)になるので、Webサーバーにエンドポイントをどう作るかについて悩む必要がなくなる 2. データ定義を資産として再利用できる（RESTの場合のjbuilderだと再利用できない） 3. リクエスト側から入れ子構造でデータを問い合わせることができるため、1回のリクエストで複雑な構造のデータを柔軟に取得することができる。（ので、サーバー側に、たくさんエンドポイントを用意する必要がなくなる） 4. GraphiQL（ブラウザインターフェース）でスキーマ（どんなフィールドがあるか）の確認および動作確認ができる