Utilitários integrados - AWS AppSync GraphQL
Utilitários de codificaçãoUtilitários de geração de IDUtilitários de erroUtilitários de correspondência de tipos e padrõesUtilitários de comportamento do valor de retornoUtilitários de autorização do resolvedor

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Utilitários integrados

A variável util contém métodos utilitários gerais para ajudar você a trabalhar com dados. A menos que especificado o contrário, todos os utilitários usam o conjunto de caracteres UTF-8.

Utilitários de codificação

util.urlEncode(String)

Retorna a string de entrada como uma string codificada application/x-www-form-urlencoded.

util.urlDecode(String)

Decodifica uma string codificada application/x-www-form-urlencoded de volta ao seu formato não codificado.

util.base64Encode(string) : string

Codifica a entrada em uma string codificada em base64.

util.base64Decode(string) : string

Decodifica os dados de uma string codificada em base64.

Utilitários de geração de ID

util.autoId()

Retorna um UUID de 128 bits gerado aleatoriamente.

util.autoUlid()

Retorna um identificador lexicograficamente classificável universalmente exclusivo (ULID) de 128 bits gerado aleatoriamente.

util.autoKsuid()

Retorna um identificador exclusivo classificável por K (KSUID) de 128 bits gerado aleatoriamente, codificado em base62, como uma string com comprimento de 27.​

Utilitários de erro

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

Lança um erro personalizado. Isso pode ser usado em modelos de mapeamento da solicitação ou resposta se o modelo detectar um erro com a solicitação ou com o resultado da invocação. Além disso, é possível especificar os campos errorType, data e errorInfo. O valor data será adicionado ao bloco error correspondente em errors na resposta do GraphQL.

nota

data será filtrado com base no conjunto de seleção da consulta. O valor errorInfo será adicionado ao bloco error correspondente em errors na resposta do GraphQL.

errorInfo não será filtrado com base no conjunto de seleção da consulta.

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

Anexa um erro personalizado no final. Isso pode ser usado em modelos de mapeamento da solicitação ou resposta se o modelo detectar um erro com a solicitação ou com o resultado da invocação. Além disso, é possível especificar os campos errorType, data e errorInfo. Diferente de util.error(String, String?, Object?, Object?), a avaliação do modelo não será interrompida para que os dados possam ser retornados ao chamador. O valor data será adicionado ao bloco error correspondente em errors na resposta do GraphQL.

nota

data será filtrado com base no conjunto de seleção da consulta. O valor errorInfo será adicionado ao bloco error correspondente em errors na resposta do GraphQL.

errorInfo não será filtrado com base no conjunto de seleção da consulta.

Utilitários de correspondência de tipos e padrões

util.matches(String, String) : Boolean

Retorna verdadeiro se o padrão especificado no primeiro argumento corresponde aos dados fornecidos no segundo argumento. O padrão deve ser uma expressão regular, como util.matches("a*b", "aaaaab"). A funcionalidade se baseia em Padrão, que você pode consultar para obter documentação adicional.

util.authType()

Retorna uma String que descreve o tipo de autenticação múltipla que está sendo usado por uma solicitação, retornando "Autorização do IAM", "Autorização de grupo de usuários", "Autorização do Open ID Connect" ou "Autorização de chave de API".

Utilitários de comportamento do valor de retorno

util.escapeJavaScript(String)

Retorna a string de entrada como uma string JavaScript de escape.

Utilitários de autorização do resolvedor

util.unauthorized()

Lança Unauthorized para o campo a ser resolvido. Use em modelos de mapeamento de solicitação ou resposta para determinar se é preciso ou não permitir que o chamador resolva o campo.