Création de requêtes de base (JavaScript)

Connectez-vous à la AppSync console Console de gestion AWS et ouvrez-la.

1. Dans le tableau de bord des API, choisissez votre API GraphQL.

2. Dans la barre latérale, choisissez Schéma.

Entrez les détails de votre schéma et de votre source de données. Consultez les sections Conception de votre schéma et Joindre une source de données pour plus d'informations.

À côté de l'éditeur de schéma, il y a une fenêtre appelée Résolveurs. Cette zone contient la liste des types et des champs tels que définis dans votre fenêtre Schéma. Vous pouvez associer des résolveurs aux champs. Vous associerez très probablement des résolveurs à vos opérations sur le terrain. Dans cette section, nous allons examiner les configurations de requêtes simples. Sous le type de requête, choisissez Joindre à côté du champ de votre requête.

Sur la page Attacher un résolveur, sous Type de résolveur, vous pouvez choisir entre un résolveur de pipeline ou un résolveur unitaire. Pour plus d'informations sur ces types, consultez la section Résolveurs. Ce guide utiliserapipeline resolvers.

Pour Resolver Runtime, choisissez APPSYNC_JS d'activer le JavaScript runtime.

Vous pouvez activer la mise en cache pour cette API. Nous vous recommandons de désactiver cette fonctionnalité pour le moment. Choisissez Créer.

Sur la page Modifier le résolveur, il existe un éditeur de code appelé Resolver code qui vous permet d'implémenter la logique du gestionnaire du résolveur et de la réponse (étapes avant et après). Pour plus d'informations, consultez la présentation JavaScript des résolveurs.

import {util} from '@aws-appsync/utils';

export function request(ctx) {
    return {};
}

export function response(ctx) {
    return ctx.prev.result;
}

En dessous de cette section se trouve un tableau intitulé Fonctions. Les fonctions vous permettent d'implémenter du code qui peut être réutilisé sur plusieurs résolveurs. Au lieu de réécrire ou de copier constamment le code, vous pouvez stocker le code source sous forme de fonction à ajouter à un résolveur chaque fois que vous en avez besoin.

Les fonctions constituent la majeure partie de la liste des opérations d'un pipeline. Lorsque vous utilisez plusieurs fonctions dans un résolveur, vous définissez l'ordre des fonctions et elles seront exécutées dans cet ordre de manière séquentielle. Ils sont exécutés après l'exécution de la fonction de demande et avant le début de la fonction de réponse.

Pour ajouter une nouvelle fonction, sous Fonctions, choisissez Ajouter une fonction, puis Créer une nouvelle fonction. Vous pouvez également voir un bouton Créer une fonction vous permettant de choisir à la place.

1. Choisissez une source de données. Il s'agira de la source de données sur laquelle le résolveur agira.

   Note

   Dans notre exemple, nous joignons un résolveur pourgetPost, qui récupère un Post objet par. id Supposons que nous ayons déjà configuré une table DynamoDB pour ce schéma. Sa clé de partition est réglée sur id et est vide.

2. Entrez unFunction name.

3. Sous Code de fonction, vous devez implémenter le comportement de la fonction. Cela peut prêter à confusion, mais chaque fonction aura son propre gestionnaire local de requêtes et de réponses. La demande est exécutée, puis la source de données est invoquée pour gérer la demande, puis la réponse de la source de données est traitée par le gestionnaire de réponses. Le résultat est stocké dans l'objet de contexte. Ensuite, la fonction suivante de la liste sera exécutée ou sera transmise au gestionnaire de réponses after step s'il s'agit de la dernière.

   Note

   Dans notre exemple, nous associons un résolveur àgetPost, qui obtient une liste d'Postobjets à partir de la source de données. Notre fonction de requête demandera les données de notre table, la table transmettra sa réponse au contexte (ctx), puis la réponse renverra le résultat dans le contexte. AWS AppSync La force de l'entreprise réside dans son interconnexion avec d'autres services. AWS Comme nous utilisons DynamoDB, nous disposons d'une suite d'opérations pour simplifier ce type de choses. Nous avons également quelques exemples types pour d'autres types de sources de données.

   Notre code ressemblera à ceci :

   import { util } from '@aws-appsync/utils';
   
   /**
    * Performs a scan on the dynamodb data source
    */
   export function request(ctx) {
     return { operation: 'Scan' };
   }
   
   /**
    * return a list of scanned post items
    */
   export function response(ctx) {
     return ctx.result.items;
   }

   Au cours de cette étape, nous avons ajouté deux fonctions :

   • request: le gestionnaire de requêtes effectue l'opération de récupération sur la source de données. L'argument contient l'objet de contexte (ctx), ou certaines données disponibles pour tous les résolveurs effectuant une opération particulière. Par exemple, il peut contenir des données d'autorisation, les noms de champs en cours de résolution, etc. L'instruction return exécute une Scan opération (voir des exemples ici). Comme nous travaillons avec DynamoDB, nous sommes autorisés à utiliser certaines des opérations de ce service. Le scan effectue une recherche de base de tous les éléments de notre tableau. Le résultat de cette opération est stocké dans l'objet de contexte en tant que result conteneur avant d'être transmis au gestionnaire de réponses. Le request est exécuté avant la réponse dans le pipeline.

   • response: Le gestionnaire de réponses qui renvoie la sortie durequest. L'argument est l'objet de contexte mis à jour et l'instruction return l'estctx.prev.result. À ce stade du guide, cette valeur ne vous est peut-être pas familière. ctxfait référence à l'objet de contexte. prevfait référence à l'opération précédente dans le pipeline, qui était la nôtrerequest. resultContient le ou les résultats du résolveur au fur et à mesure de son déplacement dans le pipeline. Si vous mettez tout cela ensemble, ctx.prev.result renvoie le résultat de la dernière opération effectuée, qui était le gestionnaire de requêtes.

4. Choisissez Créer une fois que vous avez terminé.

De retour sur l'écran du résolveur, sous Fonctions, choisissez la liste déroulante Ajouter une fonction et ajoutez votre fonction à votre liste de fonctions.

Choisissez Enregistrer pour mettre à jour le résolveur.

Connectez-vous à la AppSync console Console de gestion AWS et ouvrez-la.

1. Dans le tableau de bord des API, choisissez votre API GraphQL.

2. Dans la barre latérale, choisissez Schéma.

Dans la section Résolveurs et dans le type de mutation, choisissez Joindre à côté de votre champ.

Sur la page Attacher un résolveur, sous Type de résolveur, choisissez. pipeline resolvers Pour rappel, vous pouvez trouver plus d'informations sur les résolveurs ici. Pour Resolver Runtime, choisissez APPSYNC_JS d'activer le JavaScript runtime.

Vous pouvez activer la mise en cache pour cette API. Nous vous recommandons de désactiver cette fonctionnalité pour le moment. Choisissez Créer.

Choisissez Ajouter une fonction, puis choisissez Créer une nouvelle fonction. Vous pouvez également voir un bouton Créer une fonction pour choisir à la place.

1. Choisissez votre source de données . Il doit s'agir de la source dont vous allez manipuler les données avec la mutation.

2. Entrez unFunction name.

3. Sous Code de fonction, vous devez implémenter le comportement de la fonction. Comme il s'agit d'une mutation, la requête effectuera idéalement une opération de changement d'état sur la source de données invoquée. Le résultat sera traité par la fonction de réponse.

   Note

   createPostajoute, ou « met », un nouveau Post dans le tableau avec nos paramètres comme données. Nous pourrions ajouter quelque chose comme ceci :

   import { util } from '@aws-appsync/utils';
   
   /**
    * Sends a request to `put` an item in the DynamoDB data source
    */
   export function request(ctx) {
     return {
       operation: 'PutItem',
       key: util.dynamodb.toMapValues({id: util.autoId()}),
       attributeValues: util.dynamodb.toMapValues(ctx.args.input),
     };
   }
   
   /**
    * returns the result of the `put` operation
    */
   export function response(ctx) {
     return ctx.result;
   }

   Au cours de cette étape, nous avons également ajouté request et response des fonctions :

   • request: Le gestionnaire de requêtes accepte le contexte comme argument. L'instruction return du gestionnaire de requêtes exécute une PutItem commande, qui est une opération DynamoDB intégrée (voir ici ou ici pour des exemples). La PutItem commande ajoute un Post objet à notre table DynamoDB en utilisant la key valeur de la partition (générée automatiquement parutil.autoid()) et attributes à partir de l'entrée de l'argument de contexte (ce sont les valeurs que nous allons transmettre dans notre requête). Les key arguments du champ id et attributes sont les arguments du title champ date et. Ils sont tous deux préformatés via l'util.dynamodb.toMapValuesassistant pour fonctionner avec la table DynamoDB.

   • response: La réponse accepte le contexte mis à jour et renvoie le résultat du gestionnaire de requêtes.

4. Choisissez Créer une fois que vous avez terminé.

De retour sur l'écran du résolveur, sous Fonctions, choisissez la liste déroulante Ajouter une fonction et ajoutez votre fonction à votre liste de fonctions.

Choisissez Enregistrer pour mettre à jour le résolveur.