「GraphQL」徹底入門 ─ RESTとの比較、API・フロント双方の実装から学ぶ

この記事では、Web APIの規格のひとつであるGraphQL（グラフキューエル）について解説します。筆者（gfx）は2017年からGraphQL APIをプロダクションで運用しており、GraphQLのDX（Developer Experience) に大きな魅力を感じているソフトウェアエンジニアです。

GraphQLは、RESTful Web API（REST）の持つ問題を解決するために開発された規格です。そこで、この記事の前半では、RESTと比較しつつ、GraphQLの利点や欠点、そしてその機能の詳細を見ていきます。そして記事の後半では、筆者が使っているGraphQL Ruby（graphql-ruby）を題材に、RailsアプリにGraphQL APIを実装してみます。

• GraphQLとは何か
  • GraphQLのシンプルな例
  • GraphQLの起源とこれから
  • なぜGraphQLの採用が増えているのか
  • GraphQLの利点
    • クエリとレスポンスにおける構造の対応関係
    • スキーマとそれを利用するツールによる開発サポート
    • クエリの学習コストが小さいこと
  • GraphQLの欠点
    • パフォーマンスの分析が難しい
    • GraphQL処理系を実装するのが難しい
    • 画像や動画などの大容量バイナリの扱いが難しい
• GraphQLを触ってみる
  • GitHub API v4について
  • The GraphiQL IDEについて
• GraphQLのコンポーネント
• スキーマ言語 - GraphQLのコンポーネント その1
  • Type
  • Field
  • Interface
  • Union
  • Scalar
  • Enum
  • Directive
  • Description
• クエリ言語 - GraphQLのコンポーネント その2
  • Query
    • Queryの命名
    • オブジェクトグラフの表現
  • Mutation
    • Mutationの命名
    • Mutationにおける部分更新
  • Variables
  • Fragment
  • Relay Server Specification
    • Relay Node
    • Relay Connection
    • Relay Mutation
• GraphQL APIを実装してみる
  • graphql-rubyの特徴
  • サンプルアプリケーション: graphql-blog
  • インストール
  • GraphiQLで確認する
  • Railsアプリの実装1 - GET /articlesをGraphQLのqueryとして移植
    • クエリの設計
    • クエリの実装
  • Railsアプリの実装2 - POST /articlesをGraphQLのmutationとして移植
• GraphQLを使うフロントエンドアプリを実装してみる
• まとめ

GraphQLとは何か