モチベーション

• GraphQL を触るようになったので、設計ができる程度には技術を身につけるべくメモする。

学習リソース

• 主に https://www.oreilly.co.jp/books/9784873118932/ を用いる
• 公式ドキュメントをなるべく参照する
• 必要に応じて一般的な記事を貼り付ける
  https://graphql.org/

GraphQL とは、 API のための 問い合わせ言語である。
このサイトでQuery を試すことができる
https://graphql.org/swapi-graphql

言語使用については、下記から参照できる
https://spec.graphql.org/

設計原則

• GraphQL はAPIの実装を規定しない
• サービスの設計に関するガイドラインを示す

階層構造

• クエリは階層構造になる。フィールドはほかのフィールドの入れ子になり。クエリはレスポンスの構造と同じになる

プロダクト中心

• GraphQL はクライアントの言語やランタイムに従って実装される

強い型付け

• GraphQL サーバーは GraphQL の型システムに補償される。
• フィールドは固有の型を持ちバリデーションされる

クライアントごとのクエリ

• GraphQLサーバーはクライアントが必要とする機能を提供する

自己参照

• GraphQL 言語 は GraphQL サーバー 自身の型システムに問い合わせられる