Einfache Abfragen erstellen (JavaScript)

Melden Sie sich bei der an AWS Management Console und öffnen Sie die AppSyncKonsole.

1. Wählen Sie im APIsDashboard Ihr GraphQL API aus.

2. Wählen Sie in der Seitenleiste Schema.

Geben Sie die Details Ihres Schemas und Ihrer Datenquelle ein. Weitere Informationen finden Sie in den Abschnitten Entwerfen Ihres Schemas und Anhängen einer Datenquelle.

Neben dem Schema-Editor befindet sich ein Fenster mit dem Namen Resolvers. Dieses Feld enthält eine Liste der Typen und Felder, wie sie in Ihrem Schemafenster definiert sind. Sie können Resolver an Felder anhängen. Höchstwahrscheinlich werden Sie Resolver an Ihre Feldoperationen anhängen. In diesem Abschnitt werden wir uns einfache Abfragekonfigurationen ansehen. Wählen Sie unter dem Abfragetyp neben dem Feld Ihrer Abfrage die Option Anhängen aus.

Auf der Seite Resolver anhängen können Sie unter Resolvertyp zwischen Pipeline- und Unit-Resolvern wählen. Weitere Informationen zu diesen Typen finden Sie unter Resolver. In diesem Handbuch werden verwendet. pipeline resolvers

Wählen Sie für die Resolver-Runtime, ob Sie APPSYNC_JS die Laufzeit aktivieren möchten. JavaScript

Sie können dafür das Caching aktivieren. API Wir empfehlen, diese Funktion vorerst auszuschalten. Wählen Sie Create (Erstellen) aus.

Auf der Seite Resolver bearbeiten gibt es einen Code-Editor namens Resolver-Code, mit dem Sie die Logik für den Resolver-Handler und die Antwort (vor und nach den Schritten) implementieren können. Weitere Informationen finden Sie in der Übersicht über die JavaScript Resolver.

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

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

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

Unterhalb dieses Abschnitts befindet sich eine Tabelle mit dem Namen Functions. Mit Funktionen können Sie Code implementieren, der für mehrere Resolver wiederverwendet werden kann. Anstatt Code ständig neu zu schreiben oder zu kopieren, können Sie den Quellcode als Funktion speichern, die Sie einem Resolver hinzufügen können, wann immer Sie ihn benötigen.

Funktionen machen den Großteil der Operationsliste einer Pipeline aus. Wenn Sie mehrere Funktionen in einem Resolver verwenden, legen Sie die Reihenfolge der Funktionen fest, und sie werden nacheinander in dieser Reihenfolge ausgeführt. Sie werden ausgeführt, nachdem die Anforderungsfunktion ausgeführt wurde und bevor die Antwortfunktion beginnt.

Um eine neue Funktion hinzuzufügen, wählen Sie unter Funktionen die Option Funktion hinzufügen und dann Neue Funktion erstellen aus. Alternativ wird Ihnen möglicherweise die Schaltfläche Funktion erstellen angezeigt, aus der Sie stattdessen auswählen können.

1. Wählen Sie eine Datenquelle aus. Dies ist die Datenquelle, auf die der Resolver reagiert.

   Anmerkung

   In unserem Beispiel hängen wir einen Resolver für angetPost, der ein Objekt von abruft. Post id Nehmen wir an, wir haben bereits eine DynamoDB-Tabelle für dieses Schema eingerichtet. Ihr Partitionsschlüssel ist auf „gesetzt“ id und leer.

2. Geben Sie einFunction name.

3. Unter Funktionscode müssen Sie das Verhalten der Funktion implementieren. Das mag verwirrend sein, aber jede Funktion wird ihren eigenen lokalen Anfrage- und Antworthandler haben. Die Anforderung wird ausgeführt, dann erfolgt der Datenquellenaufruf, um die Anfrage zu bearbeiten, und dann wird die Datenquellenantwort vom Antworthandler verarbeitet. Das Ergebnis wird im Kontextobjekt gespeichert. Danach wird die nächste Funktion in der Liste ausgeführt oder an den Antworthandler nach dem Schritt übergeben, falls es sich um die letzte handelt.

   Anmerkung

   In unserem Beispiel hängen wir einen Resolver angetPost, der eine Liste von Post Objekten aus der Datenquelle erhält. Unsere Anforderungsfunktion fordert die Daten aus unserer Tabelle an, die Tabelle leitet ihre Antwort an den Kontext weiter (ctx), dann gibt die Antwort das Ergebnis im Kontext zurück. AWS AppSync Die Stärke liegt in der Vernetzung mit anderen Diensten. AWS Da wir DynamoDB verwenden, verfügen wir über eine Reihe von Operationen, um solche Dinge zu vereinfachen. Wir haben auch einige Standardbeispiele für andere Datenquellentypen.

   Unser Code wird so aussehen:

   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 diesem Schritt haben wir zwei Funktionen hinzugefügt:

   • request: Der Anforderungshandler führt den Abrufvorgang für die Datenquelle aus. Das Argument enthält das Kontextobjekt (ctx) oder einige Daten, die allen Resolvern zur Verfügung stehen, die eine bestimmte Operation ausführen. Es kann beispielsweise Autorisierungsdaten, die aufgelösten Feldnamen usw. enthalten. Die Return-Anweisung führt eine ScanOperation aus (Beispiele finden Sie hier). Da wir mit DynamoDB arbeiten, dürfen wir einige der Operationen dieses Dienstes verwenden. Der Scan führt einen einfachen Abruf aller Elemente in unserer Tabelle durch. Das Ergebnis dieser Operation wird im Kontextobjekt als result Container gespeichert, bevor es an den Antworthandler übergeben wird. Das request wird vor der Antwort in der Pipeline ausgeführt.

   • response: Der Antworthandler, der die Ausgabe von zurückgibtrequest. Das Argument ist das aktualisierte Kontextobjekt und die Rückgabeanweisung istctx.prev.result. Zu diesem Zeitpunkt in der Anleitung sind Sie mit diesem Wert möglicherweise noch nicht vertraut. ctxbezieht sich auf das Kontextobjekt. prevbezieht sich auf die vorherige Operation in der Pipeline, die unsere warrequest. Der result enthält die Ergebnisse des Resolvers, während er sich durch die Pipeline bewegt. Wenn Sie alles zusammenfügen, ctx.prev.result wird das Ergebnis der letzten ausgeführten Operation zurückgegeben, bei der es sich um den Request-Handler handelte.

4. Wenn Sie fertig sind, wählen Sie Create.

Zurück auf dem Resolver-Bildschirm wählen Sie unter Funktionen das Drop-down-Menü Funktion hinzufügen und fügen Sie Ihre Funktion zu Ihrer Funktionsliste hinzu.

Wählen Sie Speichern, um den Resolver zu aktualisieren.

Melden Sie sich bei der an AWS Management Console und öffnen Sie die AppSyncKonsole.

1. Wählen Sie im APIsDashboard Ihr GraphQL API aus.

2. Wählen Sie in der Seitenleiste Schema.

Wählen Sie unter dem Abschnitt Resolver und dem Mutationstyp neben Ihrem Feld die Option Anhängen aus.

Wählen Sie auf der Seite Attach Resolver unter Resolver-Typ die Option. pipeline resolvers Zur Erinnerung: Weitere Informationen zu Resolvern finden Sie hier. Wählen Sie für Resolver Runtime aus, ob Sie APPSYNC_JS die Laufzeit aktivieren möchten. JavaScript

Sie können dafür das Caching aktivieren. API Wir empfehlen, diese Funktion vorerst auszuschalten. Wählen Sie Create (Erstellen) aus.

Wähle „Funktion hinzufügen“ und dann „Neue Funktion erstellen“. Alternativ wird Ihnen möglicherweise die Schaltfläche Funktion erstellen angezeigt, aus der Sie stattdessen auswählen können.

1. Wählen Sie Ihre -Datenquelle aus. Dies sollte die Quelle sein, deren Daten Sie mit der Mutation manipulieren werden.

2. Geben Sie einFunction name.

3. Unter Funktionscode müssen Sie das Verhalten der Funktion implementieren. Da es sich um eine Mutation handelt, führt die Anfrage idealerweise einen Vorgang zur Änderung des Zustands an der aufgerufenen Datenquelle durch. Das Ergebnis wird von der Antwortfunktion verarbeitet.

   Anmerkung

   createPostfügt der Tabelle ein neues Post hinzu oder „fügt“ es mit unseren Parametern als Daten ein. Wir könnten so etwas hinzufügen:

   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 diesem Schritt haben wir request auch response Funktionen hinzugefügt:

   • request: Der Request-Handler akzeptiert den Kontext als Argument. Die Return-Anweisung des Request-Handlers führt einen PutItemBefehl aus, bei dem es sich um einen integrierten DynamoDB-Vorgang handelt (Beispiele finden Sie hier oder hier). Der PutItem Befehl fügt unserer DynamoDB-Tabelle ein Post Objekt hinzu, indem er den key Partitionswert (automatisch generiert vonutil.autoid()) und attributes die Eingabe des Kontextarguments verwendet (dies sind die Werte, die wir in unserer Anfrage übergeben werden). Die key Feldargumente attributes sind id und sind die date title Feldargumente. Sie sind beide über den util.dynamodb.toMapValuesHelper vorformatiert, um mit der DynamoDB-Tabelle zu arbeiten.

   • response: Die Antwort akzeptiert den aktualisierten Kontext und gibt das Ergebnis des Request-Handlers zurück.

4. Wählen Sie Create, wenn Sie fertig sind.

Zurück auf dem Resolver-Bildschirm wählen Sie unter Funktionen das Drop-down-Menü Funktion hinzufügen und fügen Sie Ihre Funktion zu Ihrer Funktionsliste hinzu.

Wählen Sie Speichern, um den Resolver zu aktualisieren.