Usuari:Gonso96/GraphQL

Gonso96/GraphQL

Versió inicial	Implementacions en Java, JavaScript, Ruby, Scala, i altres.
Versió estable	Octubre 2021 (2021-10)
Equip
Creador/s	Meta Platforms
Desenvolupador(s)	Open source
Més informació
Lloc web	graphql.org

GraphQL és un llenguatge de consulta i manipulació de dades per a API, que permet al client especificar quines dades necessita ("obtenció declarativa de dades"). Un servidor GraphQL pot obtenir dades de fonts separades en una sola consulta de client i presentar els resultats en un gràfic unificat, de manera que no està lligat a cap base de dades o motor d'emmagatzematge específic.

El motor d'execució de GraphQL és de codi obert.

Història

Facebook va començar el desenvolupament de GraphQL el 2012 i el va llançar com a codi obert el 2015. El 2018, GraphQL es va traslladar a una nova fundació creada, sense ànim de lucre, amb el nom GraphQL Foundation, allotjada per la Linux Foundation.

El 9 de febrer de 2018, el llenguatge de definició de l'esquema GraphQL va passar a formar part de l'especificació.

Moltes API públiques populars van adoptar GraphQL com a forma predeterminada d'accedir-hi. Aquestes inclouen les API públiques de Facebook, GitHub, Yelp, Shopify i l'API de Google Directions.

Disseny

GraphQL admet la lectura, l'escriptura (mutació) i la subscripció als canvis de dades (actualitzacions en temps real, implementades habitualment amb WebSockets). Es crea un servei GraphQL definint tipus amb camps i, a continuació, proporcionant funcions per resoldre les dades de cada camp. Els tipus i camps formen el que es coneix com a definició d'esquema.

Les funcions que recuperen i relacionen les dades s'anomenen resolutors.

Funcionament de les consultes

Després de validar-se amb l'esquema, el servidor executa una consulta GraphQL. El servidor retorna un resultat que reflecteix la forma de la consulta original, normalment com a JSON .

Sistema de tipus

GraphQL es un llenguatge tipat, es a dir, els camps han de tenir un tipus, o format, definit. Hi ha diversos tipus bàsics, anomenats escalars, per a representar coses com cadenes de text, números i identificadors. Es poden crear altres tipus que defineixen els camps i els objectes que el servidor GraphQL pot retornar.

Els camps es defineixen de manera predeterminada com a anul·lables i es pot utilitzar un signe d'exclamació al final per fer que un camp sigui obligatori (no anul·lable).

Un camp es pot definir com a una llista envoltant el tipus del camp entre claudàtors (per exemple, authors: [String] ).

El tipus arrel d'un esquema GraphQL, Query per defecte, conté tots els camps que es poden consultar.

type Query {
 currentUser: User
}

type User {
 id: ID!
 name: String!
}

Consultes

Una consulta GraphQL defineix la forma exacta de les dades que necessita el client.

query CurrentUser {
 currentUser {
  name
  age
 }
}

Un cop validades i executades pel servidor GraphQL, les dades es retornen amb la mateixa forma.

{
 "currentUser": {
  "name": "John Doe"
  "age": 23
 }
}

mutation CreateUser($name: String!, $age: Int!) {
 createUser(userName: $name, age: $age) {
  name
  age
 }
}

Mutacions

Una mutació GraphQL permet crear, actualitzar o suprimir dades. Les mutacions generalment contenen variables, que permeten que les dades es passin al servidor des del client. La mutació també defineix la forma de les dades que es retornaran al client un cop finalitzada l'operació.

{
 "name": "Han Solo",
 "age": 42
}

Les variables es passen com un objecte amb camps que coincideixen amb els noms de variables de la mutació.

{
 "data": {
  "createUser": {
   "name": "Han Solo",
   "age": 42
  }
 }
}

Un cop completada l'operació, el servidor GraphQL retornarà dades que coincideixen amb la forma definida per la mutació.

subscription {
 newPerson {
  name
  age
 }
}

Subscripcions

GraphQL també admet actualitzacions en directe enviades des del servidor al client en una operació anomenada subscripció. De nou, el client defineix la forma de les dades que necessita cada vegada que es fa una actualització.

Quan es fa una mutació a través del servidor GraphQL que actualitza el camp associat, les dades s'envien a tots els clients subscrits en el format configurat mitjançant la subscripció.

Comparació amb altres idiomes de consulta

GraphQL no proporciona un llenguatge de consulta de gràfics complet, com ara SPARQL, ni tan sols en dialectes d'SQL que admeten el tancament transitiu . Per exemple, una interfície GraphQL que informa dels pares d'un individu no pot retornar, en una sola consulta, el conjunt de tots els seus avantpassats.

Prova

Les API de GraphQL es poden provar manualment o amb eines automatitzades que emeten sol·licituds de GraphQL i verifiquen la correcció dels resultats. També és possible la generació automàtica de proves. Es poden generar noves sol·licituds mitjançant tècniques basades en la cerca a causa d'un esquema tipificat i capacitats d'introspecció.

Algunes de les eines de programari utilitzades per provar les implementacions de GraphQL inclouen Postman, GraphiQL, Apollo Studio, GraphQL Editor i Step CI.

Vegeu també

• Consulta per exemple
• Especificació OpenAPI
• Microserveis

Referències

• Gonso96/GraphQL - Lloc web oficial
• GraphQL: The Documentary a YouTube

[[Categoria:Arquitectura de programari]] [[Categoria:Llenguatges de consulta]] [[Categoria:Pàgines amb traduccions sense revisar]]