graphql учебник
Начало работы с graphql

замечания

Версии

Установка и внедрение сервера

GraphQL.js

GraphQL.js - эталонная реализация JavaScript для GraphQL. Вы можете установить его через npm:

• Инициализируйте npm в своем проекте, если вы еще этого не сделали: npm init
• Установите GraphQL.js из npm: 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 Middleware
• Hapi GraphQL Middleware
• Программное обеспечение Koa GraphQL

Язык запросов GraphQL (GQL)

Вместо определения конечных точек URL для каждого ресурса данных в GraphQL вы определяете одну конечную точку, которая принимает запросы GraphQL. В отличие от традиционных языков запросов базы данных, язык запросов (GQL) GraphQL представляет собой проекцию данных, возвращаемых запросом на уровень корня. Схема GraphQL будет определять модели данных и запросы и мутации корневого уровня. GQL выполняет эти запросы и определяет, какие данные должны возвращаться.

Запрос для всех титулов фильмов из схемы «Звездных войн»

Запрос GraphiQL

Запрос жителям планеты на фильм Звездных войн «Новая надежда»

Запрос GraphiQL

Обратите внимание на то, как корневой запрос film() принимает параметр id в фильме «Новая надежда», а проекция из GQL возвращает название, планеты, связанные с фильмом, а затем резидентные имена планет. Просмотрите сайт Star Wars GraphiQL, чтобы экспериментировать с запросами в GraphQL.

Определение схемы

В GraphQL схема определяет корневые запросы и мутации, а также типы данных.

Тип объекта схемы

Тип Person имеет два поля, один - стандартный тип Scalar, а другой - отношение к списку других типов Person, которые являются «друзьями». Связывание других типов - вот что делает GraphQL настолько мощным. Теперь в языке запросов GUQL (GQL) клиент может перемещать график друзей без какого-либо дополнительного кода или расширенного запроса.

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

Запрос схемы

Запрос person ищет одного человека по его идентификатору. Это точка входа в ваши данные для клиентов, использующих GQL.

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

Друзья Друга друга друга друга друга друга друга друга

Теперь, когда у нас есть тип Person и запрос root для человека, мы можем найти человека и столько же разлуки, что мы хотим от сети друзей человека.

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