Einfache Abfragen erstellen (JavaScript)

Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die AppSync Konsole.

1. Wählen Sie im API-Dashboard Ihre GraphQL-API aus.

2. Wählen Sie in der Seitenleiste Schema aus.

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, die 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 Attach Resolver können Sie unter Resolver-Typ zwischen Pipeline- und Unit-Resolvern wählen. Weitere Informationen zu diesen Typen finden Sie unter Resolver. https://docs.aws.amazon.com/appsync/latest/devguide/resolver-components.html In diesem Handbuch werden verwendet. pipeline resolvers

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

Sie können das Caching für diese API aktivieren. Wir empfehlen, diese Funktion vorerst auszuschalten. Wählen Sie 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 JavaScript Resolver-Übersicht.

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

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

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

Unter diesem Abschnitt 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, um ihn bei Bedarf einem Resolver hinzuzufügen.

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 können Sie stattdessen eine Schaltfläche „Funktion erstellen“ sehen, die Sie auswählen können.

1. Wählen Sie eine Datenquelle aus. Dies wird die Datenquelle sein, auf der der Resolver agiert.

   Anmerkung

   In unserem Beispiel fügen 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 den gesetzt id und ist leer.

2. Geben Sie ein einFunction name.

3. Unter Funktionscode müssen Sie das Verhalten der Funktion implementieren. Das mag verwirrend sein, aber jede Funktion hat ihren eigenen lokalen Anfrage- und Antworthandler. Die Anforderung wird ausgeführt, dann wird die Datenquelle aufgerufen, um die Anforderung zu verarbeiten, und dann wird die Datenquellenantwort vom Antworthandler verarbeitet. Das Ergebnis wird im https://docs.aws.amazon.com/appsync/latest/devguide/resolver-context-reference-js.html Kontextobjekt gespeichert. Danach wird die nächste Funktion in der Liste ausgeführt oder an den After-Step-Response-Handler übergeben, falls es sich um die letzte handelt.

   Anmerkung

   In unserem Beispiel fügen wir einen Resolver angetPost, der eine Liste von Post Objekten aus der Datenquelle abruft. Unsere Anforderungsfunktion fordert die Daten aus unserer Tabelle an, die Tabelle übergibt ihre Antwort an den Kontext (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 durch. Das Argument enthält das Kontextobjekt (ctx) oder einige Daten, die allen Resolvern zur Verfügung stehen, die eine bestimmte Operation ausführen. Es könnte beispielsweise Autorisierungsdaten, die aufgelösten Feldnamen usw. enthalten. Die Return-Anweisung führt eine Scan Operation aus (Beispiele finden Sie hier). Da wir mit DynamoDB arbeiten, dürfen wir einige der Operationen aus diesem Dienst 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 Response-Handler übergeben wird. Der request wird vor der Antwort in der Pipeline ausgeführt.

   • response: Der Response-Handler, der die Ausgabe von zurückgibtrequest. Das Argument ist das aktualisierte Kontextobjekt, und die Rückgabeanweisung istctx.prev.result. An dieser Stelle im Handbuch sind Sie möglicherweise nicht mit diesem Wert 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 zuletzt ausgeführten Operation zurückgegeben, bei der es sich um den Request-Handler handelte.

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

Zurück auf dem Resolver-Bildschirm wählen Sie unter Funktionen das Dropdownmenü 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-Managementkonsole und öffnen Sie die AppSync Konsole.

1. Wählen Sie im API-Dashboard Ihre GraphQL-API aus.

2. Wählen Sie in der Seitenleiste Schema aus.

Wähle im Abschnitt Resolvers und unter dem Mutationstyp neben deinem Feld die Option Anhängen aus.

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

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

Wählen Sie Funktion hinzufügen und dann Neue Funktion erstellen. Alternativ wird möglicherweise eine Schaltfläche „Funktion erstellen“ angezeigt, die 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 Anforderung idealerweise eine Zustandsänderungsoperation für die aufgerufene Datenquelle durch. Das Ergebnis wird von der Antwortfunktion verarbeitet.

   Anmerkung

   createPostfügt der Tabelle etwas Neues Post hinzu oder „fügt“ es ein, wobei unsere Parameter als Daten dienen. 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 Rückgabeanweisung des Anforderungshandlers führt einen PutItem Befehl aus, bei dem es sich um eine integrierte DynamoDB-Operation 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). Das key ist das id und attributes sind die date title Feldargumente und. Sie sind beide durch das util.dynamodb.toMapValues Hilfsprogramm 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 Erstellen, wenn Sie fertig sind.

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

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