graphql チュートリアル
graphqlを使い始める

備考

バージョン

サーバーのインストールと実装

GraphQL.js

GraphQL.jsは、 GraphQLのJavaScriptリファレンス実装です。 npm経由でインストールできます：

• まだ完了していない場合は、プロジェクトのnpmを初期化してください： npm init
• npmからGraphQL.jsをnpm install --save graphql ： npm install --save graphql

サンプルサーバー

var { graphql, buildSchema } = require('graphql');

// Construct a schema, using GraphQL schema language
var schema = buildSchema(`
  type Query {
    hello: String
  }
`);

// The root provides a resolver function for each API endpoint
var root = {
  hello: () => {
    return 'Hello world!';
  },
};

// Run the GraphQL query '{ hello }' and print out the response
graphql(schema, '{ hello }', root).then((response) => {
  console.log(response);
});

サーバーミドルウェアの代替案

• Express GraphQLミドルウェア
• Hapi GraphQLミドルウェア
• Koa GraphQLミドルウェア

GraphQLクエリ言語（GQL）

GraphQLでは、各データリソースのURLエンドポイントを定義する代わりに、GraphQLクエリを受け入れる単一のエンドポイントを定義します。従来のデータベースクエリ言語とは異なり、GraphQLクエリ言語（GQL）は、ルートレベルのクエリによって返されるデータの投影です。 GraphQLスキーマは、データモデルとルートレベルのクエリと突然変異を定義します。 GQLはこれらのクエリを実行し、返すデータを定義します。

Star Warsスキーマからすべての映画タイトルのクエリ

GraphiQLクエリ

スター・ウォーズ映画「新しい希望」への惑星居住者への質問

GraphiQLクエリ

ルートクエリーfilm()が映画「A New Hope」のidパラメータをどのようにとっているかに注目してください。GQLからの投影は、タイトル、惑星と映画に接続した後、惑星の居住者名を返します。 スター・ウォーズのGraphiQLサイトをチェックして、 GraphQLのクエリーを試してみてください。

スキーマの定義

GraphQLでは 、スキーマはルート実行クエリと突然変異 、およびデータの型を定義します。

スキーマオブジェクト型

Person型には2つのフィールドがあり、1つは標準的なScalar型であり、もう1つは「friends」である他のPerson型のリストとの関係を表します。他のタイプをリンクすることは、GraphQLを非常に強力にするものです。 GraphQLクエリ言語（GQL）では、クライアントは追加のコードや高度なクエリを実行することなく、フレンドグラフをトラバースできます。

type Person {
  id: ID
  name: String
  friends: [Person]
}

スキーマ問合せ

personクエリは、そのpersonのIDによって1人のperson検索します。これは、GQLを使用するクライアントのデータへのエントリポイントです。

type Query {   
  person(id: ID!): Person
}

Nickさんのフレンドフレンドのフレンドを検索する

PersonタイプとPersonルートクエリーを取得したので、私たちは人物を検索することができます。

query {
  person(id: 'nick'){
    id
    name
    friends{
      id
      name
      friends{
        id
        name
        friends{
          id
          name
        }
      }
    }
  }
}