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 de outra forma, todos os utilitários usam o conjunto UTF de caracteres -8.

Utilitários de codificação

Lista de 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

Lista de utilitários de geração de ID

util.autoId()

Retorna um arquivo de 128 bits gerado aleatoriamente. UUID

util.autoUlid()

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

util.autoKsuid()

Retorna uma base62 de 128 bits gerada aleatoriamente KSUID (K-Sortable Unique Identifier) codificada como uma String com um comprimento de 27.

Utilitários de erro

Lista de 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

Lista de 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 descrevendo o tipo de autenticação múltipla que está sendo usado por uma solicitação, retornando “IAMAutorização”, “Autorização do grupo de usuários”, “Autorização do Open ID Connect” ou “Autorização da API chave”.

Utilitários de comportamento do valor de retorno

Lista de utilitários de comportamento de valor de retorno​

util.escapeJavaScript(String)

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

Utilitários de autorização do resolvedor

Lista de 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.