內建公用程

此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 產生公用程式

ID 生成實用程序列表

util.autoId()

返回一個 128 位隨機生成UUID的。

util.autoUlid()

返回隨機生成的 128 位ULID（通用唯一的字典排序標識符）。

util.autoKsuid()

返回一個 128 位隨機生成的KSUID（K-可排序的唯一標識符）base62 編碼為長度為 27 的字符串。

錯誤實用程序

錯誤實用程序列表

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

擲回自訂錯誤。如果範本偵測到要求或呼叫結果的錯誤，您可以將此用於要求或回應映射範本。此外errorType，還可以指定data欄位、errorInfo欄位和欄位。data 值將新增到 GraphQL 回應中，error 內對應的 errors 區塊。

注意

data將根據查詢選集進行篩選。errorInfo 值將新增到 GraphQL 回應中，error 內對應的 errors 區塊。

errorInfo將不會根據查詢選集進行篩選。

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

附加自訂錯誤。如果範本偵測到要求或呼叫結果的錯誤，您可以將此用於要求或回應映射範本。此外errorType，還可以指定data欄位、errorInfo欄位和欄位。與 util.error(String, String?, Object?, Object?) 不同的是，範本評估不會受中斷，因此可以將資料傳回給發起人。data 值將新增到 GraphQL 回應中，error 內對應的 errors 區塊。

注意

data將根據查詢選集進行篩選。errorInfo 值將新增到 GraphQL 回應中，error 內對應的 errors 區塊。

errorInfo將不會根據查詢選集進行篩選。

類型和模式匹配實用程序

類型和模式匹配實用程序列表

util.matches(String, String) : Boolean

如果第一個引數中指定的模式與第二個引數中提供的資料相符，則傳回真。模式必須為規則表達式，例如 util.matches("a*b", "aaaaab")。此功能是根據模式，您可以參考以取得更詳細的文件。

util.authType()

返回一個字符串描述正在使用的請求，返回任一「授權」，「用戶池IAM授權」，「開放 ID Connect 授權」，或「API密鑰授權」的多身份驗證類型。

返回值行為實用程序

返回值行為實用程序列表

util.escapeJavaScript(String)

返回輸入字符串作為 JavaScript 轉義字符串。

解析器授權實用程序

解析器授權實用程序列表

util.unauthorized()

擲回欲解析之欄位的 Unauthorized。在請求或響應映射模板中使用此選項，以確定是否允許調用者解析字段。