GraphQL入門

introduction-to-graphql.md

GraphQL入門

---

lagénorhynque

(defprofile lagénorhynque
  :id           @lagenorhynque
  :reading      "/laʒenɔʁɛ̃k/"
  :aliases      ["カマイルカ🐬"]

  :languages    [Clojure Haskell English français]

  :interests    [programming language-learning law mathematics]

  :commits      ["github.com/lagenorhynque/duct.module.pedestal"
                 "github.com/lagenorhynque/duct.module.cambium"]
  :contributes  ["github.com/japan-clojurians/clojure-site-ja"])

---

1. GraphQLとは

2. クエリ言語

3. スキーマ言語

4. 便利な機能

5. 便利なツール/ライブラリ

---

1. GraphQLとは

---

GraphQL

APIに対するクエリ言語とクエリを実現するための実行エンジンについての仕様

cf. GraphQL Specification

---

2. クエリ言語

---

操作(operation)

• query

• mutation

• subscription

---

3. スキーマ言語

---

GraphQL SDL

(schema definition language)

• type

• scalar

• enum

• interface

• union

• input

---

4. 便利な機能

---

クライアント側で便利な機能

• エイリアス(alias)によるフィールドの別名指定

• フラグメント(fragment)によるフィールドセットの再利用

• 変数(variable)によるクエリのパラメータ化

---

5. 便利なツール/ライブラリ

---

GUIクライアント

• GraphiQL

• GraphQL Playground

• Altair

• etc.

---

代表的なフレームワーク

• Apollo GraphQL

• Relay

• etc.

---

パフォーマンス/セキュリティ関連のライブラリ

• DataLoader

  • cf. superlifter: Clojure実装

• graphql-depth-limit

• graphql-validation-complexity

• graphql-query-complexity

• graphql-cost-analysis

• etc.

cf. How to GraphQL > Security

---

Further Reading

• GraphQL | A query language for your API: 公式サイト

  • GitHub

• Learning GraphQL: 入門書

  • 日本語版: 『初めてのGraphQL』

• chentsulin/awesome-graphql: Awesome list of GraphQL & Relay: awesome list

---

• How to GraphQL - The Fullstack Tutorial for GraphQL: チュートリアル集

  • バックエンド: Node.js, Elixir, Ruby, Java, Python, Scala
  • フロントエンド: React + Apollo, React + urql, etc.

• GitHub GraphQL API v4 | GitHub Developer Guide: publicなGraphQL APIの代表例

---

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

• Lacinia: Clojureの代表的なGraphQL実装

  • Lacinia-Pedestal
  • 参考: ClojureのLaciniaでGraphQL API開発してみた - Qiita

start-presentation.sh

#!/usr/bin/env bash

# npm install -g reveal-md

reveal-md introduction-to-graphql.md --theme night --highlight-theme monokai-sublime -w $@