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

Connectez-vous à la AppSyncconsole AWS Management Console et ouvrez-la.

1. Dans le APIstableau de bord, choisissez votre GraphQLAPI.

2. Dans la barre latérale, choisissez Schema.

Entrez les détails de votre schéma et de votre source de données. Consultez les sections Conception de votre schéma et Attachement d'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 Resolvers. Cette zone contient une liste des types et des champs tels que définis dans votre fenêtre de schéma. Vous pouvez associer des résolveurs aux champs. Vous allez probablement associer 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 des résolveurs de type pipeline ou unitaire. Pour plus d'informations sur ces types, consultez la section Résolveurs. Ce guide utiliserapipeline resolvers.

Pour le moteur d'exécution du résolveur, choisissez d'APPSYNC_JSactiver le JavaScript moteur d'exécution.

Vous pouvez activer la mise en cache pour celaAPI. Nous vous recommandons de désactiver cette fonctionnalité pour le moment. Sélectionnez Create (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 de résolution et de la réponse (avant et après les étapes). Pour plus d'informations, consultez la présentation des JavaScript résolveurs.

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

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

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

Sous cette section, il y a un tableau appelé Fonctions. Les fonctions vous permettent d'implémenter du code qui peut être réutilisé dans plusieurs résolveurs. Au lieu de constamment réécrire ou copier 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 l'essentiel 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 pour 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 attachons 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 définie 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 de requêtes et de réponses local. La demande est exécutée, puis la source de données est invoquée pour traiter 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 s'exécutera ou sera transmise au gestionnaire de réponses après étape s'il s'agit de la dernière.

   Note

   Dans notre exemple, nous attachons 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 sa force réside dans son interconnexion avec les autres AWS services. Parce que nous utilisons DynamoDB, nous disposons d'une suite d'opérations pour simplifier ce type de choses. Nous avons également quelques exemples standard 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 demandes effectue l'opération de récupération par rapport à la source de données. L'argument contient l'objet de contexte (ctx) ou certaines données accessibles à 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 Scanopération (voir ici pour des exemples). Comme nous travaillons avec DynamoDB, nous sommes autorisés à utiliser certaines des opérations de ce service. L'analyse effectue une extraction de base de tous les éléments de notre tableau. Le résultat de cette opération est stocké dans l'objet de contexte sous forme de 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 le résultat durequest. L'argument est l'objet de contexte mis à jour, et l'instruction de retour 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. resultIl contient le ou les résultats du résolveur lorsqu'il se déplace dans le pipeline. Si vous mettez le tout ensemble, ctx.prev.result il renvoie le résultat de la dernière opération effectuée, à savoir le gestionnaire de demandes.

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

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

Choisissez Enregistrer pour mettre à jour le résolveur.

Connectez-vous à la AppSyncconsole AWS Management Console et ouvrez-la.

1. Dans le APIstableau de bord, choisissez votre GraphQLAPI.

2. Dans la barre latérale, choisissez Schema.

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

Sur la page Joindre un résolveur, sous Type de résolveur, sélectionnez. pipeline resolvers Pour rappel, vous trouverez plus d'informations sur les résolveurs ici. Pour le moteur d'exécution du résolveur, choisissez d'APPSYNC_JSactiver le JavaScript moteur d'exécution.

Vous pouvez activer la mise en cache pour celaAPI. Nous vous recommandons de désactiver cette fonctionnalité pour le moment. Sélectionnez Create (Créer).

Choisissez Ajouter une fonction, puis 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 demande 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

   createPostc'est ajouter, ou « mettre », 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 des response fonctionnalités :

   • request: Le gestionnaire de requêtes accepte le contexte comme argument. L'instruction return du gestionnaire de requêtes exécute une PutItemcommande, 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 prenant la valeur de la key partition (générée automatiquement util.autoid() par) attributes et à partir de l'argument de contexte saisi (ce sont les valeurs que nous transmettrons dans notre demande). Les arguments du title champ key est id date et attributes sont le 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 demandes.

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

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

Choisissez Enregistrer pour mettre à jour le résolveur.