View a markdown version of this page

Built-in Dienstprogramme - AWS AppSync GraphQL

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.

Built-in Dienstprogramme

Die util Variable enthält allgemeine Hilfsmethoden, die Ihnen bei der Arbeit mit Daten helfen. Sofern nicht anders angegeben, verwenden alle Hilfsprogramme den UTF-8 Zeichensatz.

Hilfsprogramme für die Kodierung

util.urlEncode(String)

Gibt die Eingabezeichenfolge als eine application/x-www-form-urlencoded-kodierte Zeichenfolge zurück.

util.urlDecode(String)

Dekodiert eine application/x-www-form-urlencoded-kodierte Zeichenfolge zurück in ihre nicht kodierte Form.

util.base64Encode(string) : string

Verschlüsselt die Eingabe in eine base64-kodierte Zeichenfolge.

util.base64Decode(string) : string

Decodiert die Daten einer base64-verschlüsselten Zeichenfolge.

Hilfsprogramme zur ID-Generierung

util.autoId()

Gibt eine zufällig generierte 128-Bit-UUID zurück.

util.autoUlid()

Gibt eine zufällig generierte 128-Bit-ULID (Universally Unique Lexicographically Sortable Identifier) zurück.

util.autoKsuid()

Gibt eine zufällig generierte 128-Bit-KSUID (K-Sortable Unique Identifier) base62 zurück, die als Zeichenfolge mit einer Länge von 27 kodiert ist.

Fehler: Utils

util.error(String, String?, Object?, Object?)

Gibt einen benutzerdefinierte Fehler aus. Dies kann in Anforderungs- oder Antwortzuweisungsvorlagen verwendet werden, wenn die Vorlage einen Fehler bei der Anforderung oder beim Aufrufergebnis erkennt. Zusätzlich können ein errorType Feld, ein data Feld und ein errorInfo Feld angegeben werden. Der data-Wert wird zum entsprechenden error-Block in errors in der GraphQL-Antwort hinzugefügt.

Anmerkung

datawird auf der Grundlage des Abfrageauswahlsatzes gefiltert. Der errorInfo-Wert wird zum entsprechenden error-Block in errors in der GraphQL-Antwort hinzugefügt.

errorInfowird nicht auf der Grundlage des Abfrageauswahlsatzes gefiltert.

util.appendError(String, String?, Object?, Object?)

Fügt einen benutzerdefinierten Fehler an. Dies kann in Anforderungs- oder Antwortzuweisungsvorlagen verwendet werden, wenn die Vorlage einen Fehler bei der Anforderung oder beim Aufrufergebnis erkennt. Zusätzlich können ein errorType Feld, ein data Feld und ein errorInfo Feld angegeben werden. Im Gegensatz zu util.error(String, String?, Object?, Object?) wird die Vorlagenbewertung nicht unterbrochen, sodass die Daten an den Aufrufer zurückgegeben werden können. Der data-Wert wird zum entsprechenden error-Block in errors in der GraphQL-Antwort hinzugefügt.

Anmerkung

datawird auf der Grundlage des Abfrageauswahlsatzes gefiltert. Der errorInfo-Wert wird zum entsprechenden error-Block in errors in der GraphQL-Antwort hinzugefügt.

errorInfowird nicht auf der Grundlage des Abfrageauswahlsatzes gefiltert.

Hilfsprogramme für den Typ- und Mustervergleich

util.matches(String, String) : Boolean

Gibt "true" zurück, wenn das angegebene Muster im ersten Argument den bereitgestellten Daten im zweiten Argument entspricht. Das Muster muss ein regulärer Ausdruck sein, wie z. B. util.matches("a*b", "aaaaab"). Die Funktionalität basiert auf Pattern, worauf Sie zur weiteren Dokumentation verweisen können.

util.authType()

Gibt eine Zeichenfolge zurück, die den von einer Anfrage verwendeten Multiauth-Typ beschreibt. Dabei wird entweder „IAM-Autorisierung“, „Benutzerpool-Autorisierung“, „Open ID Connect-Autorisierung“ oder „API-Schlüsselautorisierung“ zurückgegeben.

Verhaltenswerkzeuge für Rückgabewerte

util.escapeJavaScript(String)

Gibt die Eingabezeichenfolge als JavaScript Escape-Zeichenfolge zurück.

Tools für die Resolver-Autorisierung

util.unauthorized()

Gibt Unauthorized für das Feld aus, das aufgelöst wird. Verwenden Sie dies in Vorlagen für die Anfrage- oder Antwortzuordnung, um zu bestimmen, ob der Anrufer das Feld auflösen kann.