8. GraphQL

GraphQL fue desarrollado por Facebook para facilitar la consulta de información. Por ejemplo una aplicación para celulares suele contener menos información que una aplicación web, por lo cual en lugar de crear 2 servicios uno para web y otro para la app, se crea un servicio Graph para traer solamente la información que se necesita.

De momento no cuenta con librería oficial por parte de Microsoft. Hay 2 paquetes de Graphql Hotchocolate y grapqhl for .net. El que esta teniendo mas popularidad es Hotchocolate.

La estructura de GraphQL esta formada por 3 partes:

  1. Operación

  2. Tabla y/o datos

  3. Campos de la tabla

GraphQL se basa en enviar las peticiones por medio de consultas, se tienen 3 tipos:

  1. Query: Para consultar información

  2. Mutation: Para modificar información (crear, borrar, modificar)

  3. Subscription: Para WebSockets (con WebSockets puedes por ejemplo recibir notificaciones cuando ocurre algún evento).

Un ejemplo para obtener la clave y nombre de los clientes sería el siguiente:

http://myapi/graphql?query={clientes{clave, nombre}}

Esta petición genera el siguiente resultado

{
  "data": {
    "clientes": [
      {gr
        "Clave": 1,
        "Nombre": "John Doe"
      },
      {
        "Clave": "2",
        "Nombre": "Alicia Smith"
      }
    ]
  }
}

Agregar paquetes Nuget para habilitar graphQL en .NET Core

Vamos a agregar los siguientes paquetes Nuget para habilitar GraphQL en nuestro proyecto

Install-Package HotChocolate.AspNetCore
Install-Package HotChocolate.Data.EntityFramework

Para poder probar los servicios podemos utilizar el siguiente paquete el cual es similar a Swagger ya que nos genera la documentación y nos ayuda a probar nuestros servicios

Install-Package GraphQL.Server.UI.Playground

La estructura básica es la siguiente:

  • GraphType: Permite indicar los campos del modelo que están disponibles para el servicio, los tipos de datos comunes de .net como int, string tienen su equivalente para graphQL

  • Query: Permite configurar nuestro objeto GraphType (Modelo) con nuestra base de datos para llenar los campos del modelo.

  • Schema: Nos permite definir las operaciones a realizar: Query (Consulta información), Mutation: (Crear, Borrar, Modificar) y Suscripción (Operaciones con WebSockets).

Vamos a crear nuestra tabla caducidad la cual contendrá los datos del cliente y del producto para realizar la consulta de la siguiente manera:

{
    "query": "query {
		caducidades {
			id
			producto {
				id
				clave
				nombre
			}
			cliente
			{
				id
				nombreComercial
			}			
	      }	
   }"
} 

Este método se podrá consultar por GET o por POST, es mas cómodo realizarlo por POST.

Last updated