Utilidades integradas - AWS AppSync
Utilidades de codificaciónUtilidades de generación de IDUtilidades de errorUtilidades de coincidencia de tipos y patronesUtilidades de comportamiento del valor devueltoUtilidades de autorización del solucionador

Utilidades integradas

La variable util contiene métodos de utilidad generales que ayudan a trabajar con los datos. A menos que se especifique lo contrario, todas las utilidades usan el juego de caracteres UTF-8.

Utilidades de codificación

util.urlEncode(String)

Devuelve la cadena de entrada como una cadena application/x-www-form-urlencoded codificada.

util.urlDecode(String)

Descodifica una cadena application/x-www-form-urlencoded codificada y la devuelve a su forma no codificada.

util.base64Encode(string) : string

Codifica la entrada en una cadena codificada en base64.

util.base64Decode(string) : string

Descodifica los datos de una cadena codificada en base64.

Utilidades de generación de ID

util.autoId()

Devuelve un UUID de 128 bits generado de forma aleatoria.

util.autoUlid()

Devuelve un ULID (identificador ordenable lexicográficamente único y universal) de 128 bits generado de forma aleatoria.

util.autoKsuid()

Devuelve un KSUID (identificador único ordenable por K) de 128 bits generado de forma aleatoria codificado en base62 como una cadena con una longitud de 27.

Utilidades de error

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

Genera un error personalizado. Se puede utilizar en las plantillas de mapeo de solicitud o de respuesta si la plantilla detecta un error en la solicitud o en el resultado de la invocación. También se pueden especificar los campos errorType, data y errorInfo. El valor de data se añadirá al bloque error correspondiente dentro de errors en la respuesta de GraphQL.

nota

data se filtrará en función de la selección de consulta establecida. El valor de errorInfo se añadirá al bloque error correspondiente dentro de errors en la respuesta de GraphQL.

errorInfo no se filtrará en función de la selección de consulta establecida.

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

Adjunta un error personalizado. Se puede utilizar en las plantillas de mapeo de solicitud o de respuesta si la plantilla detecta un error en la solicitud o en el resultado de la invocación. También se pueden especificar los campos errorType, data y errorInfo. A diferencia de util.error(String, String?, Object?, Object?), la evaluación de la plantilla no se interrumpirá, de modo podrán devolverse datos al intermediario. El valor de data se añadirá al bloque error correspondiente dentro de errors en la respuesta de GraphQL.

nota

data se filtrará en función de la selección de consulta establecida. El valor de errorInfo se añadirá al bloque error correspondiente dentro de errors en la respuesta de GraphQL.

errorInfo no se filtrará en función de la selección de consulta establecida.

Utilidades de coincidencia de tipos y patrones

util.matches(String, String) : Boolean

Devuelve un valor true si el patrón especificado en el primer argumento coincide con los datos proporcionados en el segundo argumento. El patrón tiene que ser una expresión regular, por ejemplo util.matches("a*b", "aaaaab"). La funcionalidad se basa en Pattern, que puede consultar para obtener más información.

util.authType()

Devuelve una cadena que describe el tipo de autenticación múltiple que utiliza una solicitud y devuelve "Autorización de IAM", "Autorización del grupo de usuarios", "Autorización de Open ID Connect" o "Autorización de la clave de API".

Utilidades de comportamiento del valor devuelto

util.escapeJavaScript(String)

Devuelve la cadena de entrada como una cadena de escape de JavaScript.

Utilidades de autorización del solucionador

util.unauthorized()

Genera el código Unauthorized para el campo que se está resolviendo. Utilícela en las plantillas de mapeo de solicitudes o de respuestas para determinar si se debe permitir al intermediario que resuelva el campo.