Utilitaires intégrés

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

Utilitaires d'encodage

Liste des 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'identifiants

Liste des utilitaires de génération d'identifiants

util.autoId()

Renvoie un 128 bits généré aléatoirement. UUID

util.autoUlid()

Renvoie un identifiant de 128 bits généré aléatoirement ULID (identifiant lexicographiquement triable universellement unique).

util.autoKsuid()

Renvoie une base 62 de 128 bits générée aléatoirement KSUID (K-Sortable Unique Identifier) codée sous forme de chaîne d'une longueur de 27.

Utils d'erreur

Liste des utilitaires 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

Liste d'utilitaires correspondant au type et au modèle

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, renvoyant soit « IAM Authorization », soit « User Pool Authorization », « Open ID Connect Authorization », soit « API Key Authorization ».

Utilitaires de comportement des valeurs renvoyées

Liste des utilitaires relatifs au comportement des valeurs renvoyées

util.escapeJavaScript(String)

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

Utilitaires d'autorisation du résolveur

Liste des 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 convient d'autoriser l'appelant à résoudre le champ.