View a markdown version of this page

Built-in services publics - AWS AppSync GraphQL

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Built-in services publics

La util variable contient des méthodes utilitaires générales pour vous aider à utiliser les données. Sauf indication contraire, tous les utilitaires utilisent le jeu de UTF-8 caractères.

Utilitaires d'encodage

util.urlEncode(String)

Renvoie la chaîne en entrée sous la forme d'une chaîne codée application/x-www-form-urlencoded.

util.urlDecode(String)

Décode une chaîne codée application/x-www-form-urlencoded sous sa forme initiale non codée.

util.base64Encode(string) : string

Code les données d'entrée en une chaîne codée en base64.

util.base64Decode(string) : string

Décode les données d’une chaîne encodée en base64.

Utilitaires de génération d'ID

util.autoId()

Renvoie un UUID 128 bits généré de façon aléatoire.

util.autoUlid()

Renvoie un ULID (Universally Unique Lexicographically Sortable Identifier) généré aléatoirement sur 128 bits.

util.autoKsuid()

Renvoie un KSUID (identifiant K-Sortable unique) base62 généré de manière aléatoire de 128 bits, codé sous forme de chaîne d'une longueur de 27.

Utils d'erreur

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

Lève une erreur personnalisée. Peut être utilisé dans les modèles de mappage de demande ou de réponse si le modèle détecte une erreur associée à la demande ou au résultat de l'appel. En outre, un errorType champ, un data champ et un errorInfo champ peuvent être spécifiés. La valeur data sera ajoutée au bloc error correspondant à l'intérieur d'errors dans la réponse GraphQL.

Note

datasera filtré en fonction de l'ensemble de sélection de requêtes. La valeur errorInfo sera ajoutée au bloc error correspondant à l'intérieur d'errors dans la réponse GraphQL.

errorInfone sera pas filtré en fonction de l'ensemble de sélection de requêtes.

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

Ajoute une erreur personnalisée. Peut être utilisé dans les modèles de mappage de demande ou de réponse si le modèle détecte une erreur associée à la demande ou au résultat de l'appel. En outre, un errorType champ, un data champ et un errorInfo champ peuvent être spécifiés. Contrairement à util.error(String, String?, Object?, Object?), l'évaluation du modèle n'est pas interrompue et, par conséquent, les données peuvent être retournées à l'appelant. La valeur data sera ajoutée au bloc error correspondant à l'intérieur d'errors dans la réponse GraphQL.

Note

datasera filtré en fonction de l'ensemble de sélection de requêtes. La valeur errorInfo sera ajoutée au bloc error correspondant à l'intérieur d'errors dans la réponse GraphQL.

errorInfone sera pas filtré en fonction de l'ensemble de sélection de requêtes.

Utilitaires de correspondance de types et de modèles

util.matches(String, String) : Boolean

Renvoie la valeur true si le modèle spécifié dans le premier argument correspond aux données fournies dans le deuxième argument. Le modèle doit être une expression régulière, telle que util.matches("a*b", "aaaaab"). La fonctionnalité est basée sur Pattern, que vous pouvez référencer à titre de documentation ultérieure.

util.authType()

Renvoie une chaîne décrivant le type d'authentification multiple utilisé par une demande, en renvoyant soit « Autorisation IAM », « Autorisation du pool d'utilisateurs », « Autorisation Open ID Connect », soit « Autorisation par clé API ».

Utilitaires relatifs au comportement des valeurs de retour

util.escapeJavaScript(String)

Renvoie la chaîne d'entrée sous forme de chaîne JavaScript échappée.

Utilitaires d'autorisation du résolveur

util.unauthorized()

Lève Unauthorized pour le champ en cours de résolution. Utilisez-le dans les modèles de mappage de demandes ou de réponses pour déterminer s'il faut autoriser l'appelant à résoudre le champ.