graphql Tutorial
Empezando con graphql

Observaciones

Versiones

Instalación e implementación del servidor

GraphQL.js

GraphQL.js es una implementación de referencia de JavaScript para GraphQL. Puedes instalarlo vía npm:

• Inicialice npm en su proyecto si aún no lo ha hecho: npm init
• Instale GraphQL.js desde npm: npm install --save graphql

Servidor de ejemplo

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);
});

Alternativas de middleware de servidor

• Express GraphQL Middleware
• Hapi GraphQL Middleware
• Koa GraphQL Middleware

Lenguaje de consulta GraphQL (GQL)

En lugar de definir los puntos finales de URL para cada recurso de datos, en GraphQL se define un solo punto final que acepta consultas GraphQL. A diferencia de los lenguajes de consulta de base de datos tradicionales, GraphQL Query Language (GQL) es una proyección de datos devueltos por una consulta de nivel raíz. El esquema GraphQL definirá el modelo de datos y las consultas y mutaciones a nivel raíz. GQL ejecuta esas consultas y define qué datos devolver.

Consulta de todos los títulos de películas del esquema de Star Wars

Consulta GraphiQL

Consulta para los residentes del planeta a la película de Star Wars "Una nueva esperanza"

Consulta GraphiQL

Observe cómo la film() consulta raíz film() toma el parámetro id de la película "A New Hope" y la proyección de GQL devuelve el título, los planetas conectados a la película y luego los nombres residentes de los planetas. Visite el sitio de Star Wars GraphiQL para experimentar con la consulta en GraphQL.

Definición de esquema

En GraphQL, el esquema define las consultas de ejecución raíz y las mutaciones , así como los tipos para sus datos.

Tipo de objeto de esquema

El tipo de Person tiene dos campos, uno es un tipo escalar estándar y el otro representa una relación con una lista de otros tipos de personas que son "amigos". Vincular otros tipos es lo que hace a GraphQL tan poderoso. Ahora en GraphQL Query Language (GQL), el cliente puede recorrer el gráfico de amigos sin ningún código adicional o consulta avanzada.

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

Consulta de esquema

La consulta de person busca una sola persona por su id. Este es el punto de entrada a sus datos para clientes que utilizan GQL.

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

Los amigos de Query Nick's Friend

Ahora que tenemos un tipo de persona y una consulta de raíz de persona, podemos buscar una persona y tantos grados de separación queremos de la red de amigos de la persona.

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