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 de outra forma, todos os utilitários usam o conjunto UTF de caracteres -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 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
-
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
eerrorInfo
. O valordata
será adicionado ao blocoerror
correspondente emerrors
na resposta do GraphQL.nota
data
será filtrado com base no conjunto de seleção da consulta. O valorerrorInfo
será adicionado ao blocoerror
correspondente emerrors
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
eerrorInfo
. Diferente deutil.error(String, String?, Object?, Object?)
, a avaliação do modelo não será interrompida para que os dados possam ser retornados ao chamador. O valordata
será adicionado ao blocoerror
correspondente emerrors
na resposta do GraphQL.nota
data
será filtrado com base no conjunto de seleção da consulta. O valorerrorInfo
será adicionado ao blocoerror
correspondente emerrors
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 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
-
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.