Creazione di interrogazioni di base () JavaScript

Accedi a AWS Management Console e apri la AppSync console.

1. Nella APIsdashboard, scegli il tuo GraphQLAPI.

2. Nella barra laterale, scegli Schema.

Inserisci i dettagli dello schema e della fonte di dati. Per ulteriori informazioni, consulta le sezioni Progettazione dello schema e Collegamento di un'origine dati.

Accanto all'editor dello schema, c'è una finestra chiamata Resolvers. Questa casella contiene un elenco dei tipi e dei campi definiti nella finestra Schema. È possibile allegare resolver ai campi. Molto probabilmente allegherai dei resolver alle tue operazioni sul campo. In questa sezione, esamineremo semplici configurazioni di query. Nella sezione Tipo di query, scegli Allega accanto al campo della query.

Nella pagina Attach resolver, in Tipo di resolver, puoi scegliere tra resolver pipeline o unit. Per ulteriori informazioni su questi tipi, consulta Resolvers. Questa guida utilizzerà. pipeline resolvers

Per Resolver runtime, scegli di abilitare il runtime. APPSYNC_JS JavaScript

A tale scopo è possibile abilitare la memorizzazione nella cache. API Ti consigliamo di disattivare questa funzionalità per ora. Scegli Create (Crea) .

Nella pagina Modifica resolver, c'è un editor di codice chiamato Resolver code che consente di implementare la logica per il gestore e la risposta del resolver (prima e dopo i passaggi). Per ulteriori informazioni, consulta la panoramica dei resolver. JavaScript

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

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

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

Sotto questa sezione, c'è una tabella chiamata Funzioni. Le funzioni consentono di implementare codice che può essere riutilizzato su più resolver. Invece di riscrivere o copiare costantemente il codice, puoi memorizzare il codice sorgente come funzione da aggiungere a un resolver ogni volta che ne hai bisogno.

Le funzioni costituiscono la maggior parte dell'elenco delle operazioni di una pipeline. Quando si utilizzano più funzioni in un resolver, si imposta l'ordine delle funzioni e queste verranno eseguite in quell'ordine in sequenza. Vengono eseguiti dopo l'esecuzione della funzione di richiesta e prima dell'inizio della funzione di risposta.

Per aggiungere una nuova funzione, in Funzioni, scegli Aggiungi funzione, quindi Crea nuova funzione. In alternativa, potresti invece visualizzare il pulsante Crea funzione tra cui scegliere.

1. Scegli una fonte di dati. Questa sarà la fonte di dati su cui agisce il resolver.

   Nota

   Nel nostro esempio, stiamo collegando un resolver pergetPost, che recupera un oggetto tramite. Post id Supponiamo di aver già impostato una tabella DynamoDB per questo schema. La sua chiave di partizione è impostata su id ed è vuota.

2. Inserisci unFunction name.

3. In Codice funzione, dovrai implementare il comportamento della funzione. Ciò potrebbe creare confusione, ma ogni funzione avrà il proprio gestore locale di richieste e risposte. La richiesta viene eseguita, quindi viene effettuata la chiamata all'origine dati per gestire la richiesta, quindi la risposta dell'origine dati viene elaborata dal gestore della risposta. Il risultato viene archiviato nell'oggetto contestuale. Successivamente, verrà eseguita la funzione successiva nell'elenco o verrà passata al gestore di risposte post-passaggio se è l'ultima.

   Nota

   Nel nostro esempio, stiamo collegando un resolver agetPost, che ottiene un elenco di Post oggetti dalla fonte di dati. La nostra funzione di richiesta richiederà i dati dalla nostra tabella, la tabella passerà la sua risposta al contesto (ctx), quindi la risposta restituirà il risultato nel contesto. AWS AppSync la forza di questa soluzione risiede nella sua interconnessione con altri servizi. AWS Poiché utilizziamo DynamoDB, disponiamo di una suite di operazioni per semplificare cose come queste. Abbiamo anche alcuni esempi standard per altri tipi di fonti di dati.

   Il nostro codice sarà simile a questo:

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

   In questo passaggio, abbiamo aggiunto due funzioni:

   • request: Il gestore della richiesta esegue l'operazione di recupero sulla fonte di dati. L'argomento contiene l'oggetto context (ctx) o alcuni dati disponibili per tutti i resolver che eseguono una particolare operazione. Ad esempio, potrebbe contenere dati di autorizzazione, i nomi dei campi da risolvere, ecc. L'istruzione return esegue un'Scanoperazione (vedi qui per alcuni esempi). Poiché lavoriamo con DynamoDB, siamo autorizzati a utilizzare alcune delle operazioni di quel servizio. La scansione esegue un recupero di base di tutti gli elementi della nostra tabella. Il risultato di questa operazione viene archiviato nell'oggetto di contesto come result contenitore prima di essere passato al gestore delle risposte. requestViene eseguito prima della risposta nella pipeline.

   • response: Il gestore di risposte che restituisce l'output di. request L'argomento è l'oggetto di contesto aggiornato e l'istruzione return èctx.prev.result. A questo punto della guida, potresti non avere familiarità con questo valore. ctxsi riferisce all'oggetto contestuale. prevsi riferisce all'operazione precedente nella pipeline, che era la nostrarequest. resultContiene il/i risultato/i del resolver mentre si muove attraverso la pipeline. Se metti tutto insieme, ctx.prev.result restituisce il risultato dell'ultima operazione eseguita, che era il gestore della richiesta.

4. Scegli Crea dopo aver finito.

Tornando alla schermata del resolver, in Funzioni, scegli il menu a discesa Aggiungi funzione e aggiungi la tua funzione all'elenco delle funzioni.

Scegli Salva per aggiornare il resolver.

Accedi a AWS Management Console e apri la console. AppSync

1. Nella APIsdashboard, scegli il tuo GraphQLAPI.

2. Nella barra laterale, scegli Schema.

Nella sezione Resolver e nel tipo di mutazione, scegli Allega accanto al tuo campo.

Nella pagina Allega resolver, in Tipo di risolutore, scegli. pipeline resolvers Come promemoria, puoi trovare ulteriori informazioni sui resolver qui. Per Resolver runtime, scegli di abilitare il runtime. APPSYNC_JS JavaScript

A tale scopo è possibile abilitare la memorizzazione nella cache. API Ti consigliamo di disattivare questa funzionalità per ora. Scegli Create (Crea) .

Scegli Aggiungi funzione, quindi scegli Crea nuova funzione. In alternativa, potresti invece visualizzare un pulsante Crea funzione tra cui scegliere.

1. Scegli l'origine dati. Questa dovrebbe essere la fonte di cui manipolerai i dati con la mutazione.

2. Inserisci un. Function name

3. In Codice funzione, dovrai implementare il comportamento della funzione. Questa è una mutazione, quindi la richiesta eseguirà idealmente alcune operazioni di modifica dello stato sulla fonte di dati richiamata. Il risultato verrà elaborato dalla funzione di risposta.

   Nota

   createPoststa aggiungendo, o «inserendo», un nuovo Post nella tabella con i nostri parametri come dati. Potremmo aggiungere qualcosa del genere:

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

   In questo passaggio, abbiamo anche aggiunto request response funzioni:

   • request: Il gestore della richiesta accetta il contesto come argomento. L'istruzione return del gestore di richieste esegue un PutItemcomando, che è un'operazione DynamoDB integrata (vedi qui o qui per alcuni esempi). Il PutItem comando aggiunge un Post oggetto alla nostra tabella DynamoDB prendendo il valore della key partizione (generato automaticamente util.autoid() da) attributes e dall'input dell'argomento di contesto (questi sono i valori che passeremo nella nostra richiesta). Gli argomenti key è id e attributes sono gli date e title i campi. Sono entrambi preformattati tramite l'util.dynamodb.toMapValueshelper per funzionare con la tabella DynamoDB.

   • response: La risposta accetta il contesto aggiornato e restituisce il risultato del gestore della richiesta.

4. Scegli Crea dopo aver finito.

Tornando alla schermata del resolver, in Funzioni, scegli il menu a discesa Aggiungi funzione e aggiungi la tua funzione all'elenco delle funzioni.

Scegli Salva per aggiornare il resolver.