Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Konfiguration und Verwendung von Pipeline-Resolvern in AWS AppSync () VTL

AWS AppSync führt Resolver auf einem GraphQL-Feld aus. In einigen Fällen müssen Anwendungen mehrere Operationen ausführen, um ein einziges GraphQL-Feld aufzulösen. Mit Pipeline-Resolvern können Entwickler jetzt Operationen, sogenannte Funktionen, zusammenstellen und sie nacheinander ausführen. Pipeline-Resolver sind nützlich für Anwendungen, die z. B. eine Autorisierungsprüfung ausführen müssen, bevor sie Daten für ein Feld abrufen.

Ein Pipeline-Resolver besteht aus einer Zuweisungsvorlage für Vorher, einer Zuweisungsvorlage für Nachher und einer Liste von Funktionen. Jede Funktion verfügt über eine Vorlage für die Zuordnung von Anfragen und Antworten, die sie anhand einer Datenquelle ausführt. Da ein Pipeline-Resolver die Ausführung an eine Liste von Funktionen delegiert, ist er mit keiner Datenquelle verknüpft. Unit-Resolver und Funktionen sind Primitive, die Operationen an Datenquellen ausführen. Weitere Informationen finden Sie in der Übersicht über die Resolver-Mapping-Vorlagen.

Schritt 1: Einen Pipeline-Resolver erstellen

Rufen Sie in der AWS AppSync Konsole die Schemaseite auf.

Speichern Sie das folgende Schema:

schema {
    query: Query
    mutation: Mutation
}

type Mutation {
    signUp(input: Signup): User
}

type Query {
    getUser(id: ID!): User
}

input Signup {
    username: String!
    email: String!
}

type User {
    id: ID!
    username: String
    email: AWSEmail
}

Wir werden einen Pipeline-Resolver mit dem signUpFeld des Typs Mutation verbinden. Wählen Sie im Bereich Mutationstyp auf der rechten Seite neben dem signUp Mutationsfeld die Option Anhängen aus. Klicken Sie auf der Seite „Resolver erstellen“ auf Aktionen und dann auf Laufzeit aktualisieren. Wählen SiePipeline Resolver, wählen Sie dann VTL und wählen Sie dann Aktualisieren. Die Seite sollte nun drei Abschnitte enthalten: einen Textbereich Vor dem Zuordnen der Vorlage, einen Abschnitt mit Funktionen und einen Textbereich Nach dem Zuordnen der Vorlage.

Unser Pipeline-Resolver meldet einen Benutzer an, indem er zuerst die eingegebene E-Mail-Adresse validiert und den Benutzer dann im System speichert. Wir werden die E-Mail-Validierung in einer validateEmailFunktion und das Speichern des Benutzers in einer saveUserFunktion zusammenfassen. Die validateEmailFunktion wird zuerst ausgeführt, und wenn die E-Mail gültig ist, wird die saveUserFunktion ausgeführt.

Der Ausführungsablauf sieht wie folgt aus:

Da wir die validateEmailFunktion wahrscheinlich in anderen Resolvern auf unserem wiederverwenden werdenAPI, möchten wir den Zugriff vermeiden, $ctx.args da sich diese von einem GraphQL-Feld zum anderen ändern. Wir können stattdessen $ctx.stash verwenden, um das E-Mail-Attribut aus dem Eingabefeldargument signUp(input: Signup) zu speichern.

BEFOREVorlage für die Zuordnung:

## store email input field into a generic email key
$util.qr($ctx.stash.put("email", $ctx.args.input.email))
{}

Die Konsole stellt eine standardmäßige AFTERPassthrough-Mapping-Vorlage bereit, die wir verwenden werden:

$util.toJson($ctx.result)

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

Schritt 2: Eine Funktion erstellen

Klicken Sie auf der Pipeline-Resolver-Seite im Abschnitt Funktionen auf Funktion hinzufügen und dann auf Neue Funktion erstellen. Es ist auch möglich, Funktionen zu erstellen, ohne die Resolver-Seite aufrufen zu müssen. Rufen Sie dazu in der AWS AppSync Konsole die Seite Funktionen auf. Wählen Sie die Schaltfläche Create function (Funktion erstellen). Wir erstellen eine Funktion, die prüft, ob eine E-Mail gültig ist und von einer bestimmten Domäne stammt. Sofern die E-Mail nicht gültig ist, löst die Funktion einen Fehler aus. Andernfalls leitet sie sämtliche Eingaben weiter.

Wählen Sie auf der Seite „Neue Funktionen“ die Option „Aktionen“ und dann „Laufzeit aktualisieren“. Wählen Sie „VTLAktualisieren“. Stellen Sie sicher, dass Sie eine Datenquelle dieses NONETyps erstellt haben. Wählen Sie diese Datenquelle in der Liste Datenquellenname aus. Geben Sie für den Funktionsnamen in einvalidateEmail. Überschreiben Sie im Funktionscode-Bereich alles mit diesem Snippet:

#set($valid = $util.matches("^[a-zA-Z0-9_.+-]+@(?:(?:[a-zA-Z0-9-]+\.)?[a-zA-Z]+\.)?(myvaliddomain)\.com", $ctx.stash.email))
#if (!$valid)
    $util.error("$ctx.stash.email is not a valid email.")
#end
{
    "payload": { "email": $util.toJson(${ctx.stash.email}) }
}

Fügen Sie dies in die Antwortzuordnungsvorlage ein:

$util.toJson($ctx.result)

Überprüfen Sie Ihre Änderungen und wählen Sie dann Erstellen aus. Wir haben gerade unsere validateEmailFunktion erstellt. Wiederholen Sie diese Schritte, um die saveUserFunktion mit den folgenden Vorlagen für die Zuordnung von Anfragen und Antworten zu erstellen (Der Einfachheit halber verwenden wir eine NONEDatenquelle und tun so, als ob der Benutzer nach der Ausführung der Funktion im System gespeichert wurde. ):

Zuweisungsvorlage für Anforderungen:

## $ctx.prev.result contains the signup input values. We could have also
## used $ctx.args.input.
{
    "payload": $util.toJson($ctx.prev.result)
}

Zuweisungsvorlage für Antworten:

## an id is required so let's add a unique random identifier to the output
$util.qr($ctx.result.put("id", $util.autoId()))
$util.toJson($ctx.result)

Wir haben gerade unsere saveUserFunktion erstellt.

Schritt 3: Hinzufügen einer Funktion zu einem Pipeline-Resolver

Unsere Funktionen hätten automatisch zu dem Pipeline-Resolver hinzugefügt werden sollen, den wir gerade erstellt haben. Wenn dies nicht der Fall war oder Sie die Funktionen über die Seite Funktionen erstellt haben, können Sie auf der Resolver-Seite auf Funktion hinzufügen klicken, um sie anzuhängen. Fügen Sie dem Resolver validateEmailsowohl die als auch die saveUserFunktionen hinzu. Die validateEmailFunktion sollte vor der saveUserFunktion stehen. Wenn Sie weitere Funktionen hinzufügen, können Sie die Optionen „Nach oben“ und „Nach unten“ verwenden, um die Reihenfolge der Ausführung Ihrer Funktionen neu zu organisieren. Überprüfen Sie Ihre Änderungen und wählen Sie dann Speichern.

Schritt 4: Eine Abfrage ausführen

Rufen Sie in der AWS AppSync Konsole die Seite Abfragen auf. Stellen Sie im Explorer sicher, dass Sie Ihre Mutation verwenden. Wenn nicht, wählen Sie Mutation in der Drop-down-Liste und dann+. Geben Sie die folgende Abfrage ein:

mutation {
  signUp(input: {
    email: "nadia@myvaliddomain.com"
    username: "nadia"
  }) {
    id
    email
  }
}

Dies sollte etwa Folgendes zurückgeben:

{
  "data": {
    "signUp": {
      "id": "256b6cc2-4694-46f4-a55e-8cb14cc5d7fc",
      "email": "nadia@myvaliddomain.com"
    }
  }
}

Wir haben mit einem Pipeline-Resolver unseren Benutzer erfolgreich angemeldet und die eingegebene E-Mail validiert. Ein detailliertes Tutorial zu Pipeline-Resolvern finden Sie unter Tutorial: Pipeline-Resolver