GraphQL入門

⼊⾨ 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"] ["github.com/japan-clojurians/clojure-site-ja"]) :contributes

• https://twitter.com/lagenorhynque

とは 2. クエリ⾔語 3. スキーマ⾔語 4. 便利な機能 5. 便利なツール/ライブラリ 1. GraphQL

とは 1. GraphQL

GraphQL API に対するクエリ⾔語とクエリを実現するための実 ⾏エンジンについての仕様 cf. GraphQL Speci cation

• http://spec.graphql.org/
• https://graphql.org/

2. クエリ⾔語

操作(operation) query mutation subscription

• https://graphql.org/learn/queries/#fields
• https://graphql.org/learn/queries/#mutations

3. スキーマ⾔語

GraphQL SDL (schema de nition language) type scalar enum interface union input

• https://graphql.org/learn/schema/#object-types-and-fields
• https://graphql.org/learn/schema/#scalar-types
• https://graphql.org/learn/schema/#enumeration-types
• https://graphql.org/learn/schema/#interfaces
• https://graphql.org/learn/schema/#union-types
• https://graphql.org/learn/schema/#input-types

4. 便利な機能

クライアント側で便利な機能 エイリアス(alias)によるフィールドの別名指定 フラグメント(fragment)によるフィールドセット の再利⽤ 変数(variable)によるクエリのパラメータ化

• https://graphql.org/learn/queries/#fragments
• https://graphql.org/learn/queries/#variables
• https://graphql.org/learn/queries/#aliases

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

クライアント GUI GraphiQL GraphQL Playground Altair etc.

• https://github.com/graphql/graphiql
• https://github.com/prisma-labs/graphql-playground
• https://github.com/imolorhe/altair

代表的なフレームワーク Apollo GraphQL Relay etc.

• https://www.apollographql.com/
• https://relay.dev/

パフォーマンス/セキュリティ関連 のライブラリ DataLoader 実装 cf. superlifter: Clojure graphql-depth-limit graphql-validation-complexity graphql-query-complexity graphql-cost-analysis etc.

• https://github.com/oliyh/superlifter
• https://github.com/graphql/dataloader
• https://github.com/stems/graphql-depth-limit
• https://github.com/4Catalyzer/graphql-validation-complexity
• https://github.com/slicknode/graphql-query-complexity
• https://github.com/pa-bru/graphql-cost-analysis

cf. How to GraphQL > Security

• https://www.howtographql.com/advanced/4-security/

Further Reading GraphQL | A query language for your API: サイト 公式 GitHub ⼊⾨書 ⽇本語版: 『初めてのGraphQL』 Learning GraphQL: chentsulin/awesome-graphql: Awesome list of GraphQL & Relay: awesome list

• https://graphql.org/
• https://github.com/chentsulin/awesome-graphql
• https://github.com/graphql
• https://www.oreilly.com/library/view/learning-graphql/9781492030706/
• https://www.oreilly.co.jp/books/9784873118932/

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 な の代表例

• https://www.howtographql.com/
• https://developer.github.com/v4/

「GraphQL」徹底⼊⾨ ─ RESTとの⽐較、API・ フロント双⽅の実装から学ぶ - エンジニアHub Lacinia: Clojureの代表的なGraphQL実装 Lacinia-Pedestal : Clojure Lacinia GraphQL API - Qiita 参考 の してみた で 開発

• https://github.com/walmartlabs/lacinia
• https://qiita.com/lagenorhynque/items/eebb9a36859789520dbf
• https://employment.en-japan.com/engineerhub/entry/2018/12/26/103000
• https://github.com/walmartlabs/lacinia-pedestal