本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
内置实用程序
util 变量包含帮助您处理数据的常规实用程序方法。除非另有说明，否则所有实用程序都使用 UTF -8 字符集。
编码实用程序
-
util.urlEncode(String) -
将输入字符串作为
application/x-www-form-urlencoded编码字符串返回。 -
util.urlDecode(String) -
将
application/x-www-form-urlencoded编码的字符串解码回未编码的形式。 util.base64Encode(string) : string-
将输入编码为 base64 编码字符串。
util.base64Decode(string) : string-
对 base64 编码字符串中的数据进行解码。
ID 生成实用程序
-
util.autoId() -
返回随机生成的 128 位。UUID
util.autoUlid()-
返回随机生成的 128 位ULID（按字典顺序排序的通用唯一标识符）。
util.autoKsuid()-
返回一个随机生成的 128 位KSUID（K-Sortable 唯一标识符）base62，编码为长度为 27 的字符串。
错误实用程序
-
util.error(String, String?, Object?, Object?) -
引发自定义错误。如果模板检测到请求或调用结果的错误，可用于请求或响应映射模板中。此外，还可以指定
errorType、data和errorInfo字段。将在 GraphQL 响应中data内部对应的error块中添加errors值。注意
data将根据查询选择集进行筛选。将在 GraphQL 响应中errorInfo内部对应的error块中添加errors值。errorInfo不会根据查询选择集进行筛选。 -
util.appendError(String, String?, Object?, Object?) -
追加自定义错误。如果模板检测到请求或调用结果的错误，可用于请求或响应映射模板中。此外，还可以指定
errorType、data和errorInfo字段。与util.error(String, String?, Object?, Object?)不同，不会中断模板评估，因此，可以向调用方返回数据。将在 GraphQL 响应中data内部对应的error块中添加errors值。注意
data将根据查询选择集进行筛选。将在 GraphQL 响应中errorInfo内部对应的error块中添加errors值。errorInfo不会根据查询选择集进行筛选。
类型和模式匹配实用程序
util.matches(String, String) : Boolean-
如果在第一个参数中指定的模式与第二个参数中提供的数据匹配，则返回 true。模式必须为正则表达式，例如
util.matches("a*b", "aaaaab")。此功能以模式为基础，您可参考其他文档，进一步了解此内容。 -
util.authType() -
返回一个描述请求使用的多重身份验证类型的字符串，返回 “授权”、“用户池IAM授权”、“Open ID Connect 授权” 或 “API密钥授权”。
返回值行为实用程序
-
util.escapeJavaScript(String) -
以转义字符串的形式返回输入 JavaScript 字符串。
解析器授权实用程序
-
util.unauthorized() -
针对被解析的字段引发
Unauthorized。可以在请求或响应映射模板中使用该实用程序，以确定是否允许调用方解析该字段。