Utilitas bawaan - AWS AppSync

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Utilitas bawaan

utilVariabel berisi metode utilitas umum untuk membantu Anda bekerja dengan data. Kecuali ditentukan lain, semua utilitas menggunakan set karakter UTF -8.

Pengkodean utilitas

util.urlEncode(String)

Mengembalikan string masukan sebagai string application/x-www-form-urlencoded dikodekan.

util.urlDecode(String)

Mendekode string yang application/x-www-form-urlencoded dikodekan kembali ke bentuk yang tidak dikodekan.

util.base64Encode(string) : string

Mengkodekan input ke dalam string yang dikodekan base64.

util.base64Decode(string) : string

Mendekode data dari string yang dikodekan base64.

Utilitas pembuatan ID

util.autoId()

Mengembalikan 128-bit yang dihasilkan secara acak. UUID

util.autoUlid()

Mengembalikan 128-bit yang dihasilkan secara acak ULID (Universalally Unique Lexicographically Sortable Identifier).

util.autoKsuid()

Mengembalikan 128-bit yang dihasilkan secara acak KSUID (K-Sortable Unique Identifier) base62 yang dikodekan sebagai String dengan panjang 27.

Kesalahan utils

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

Melempar kesalahan khusus. Ini dapat digunakan dalam template pemetaan permintaan atau respons jika template mendeteksi kesalahan dengan permintaan atau dengan hasil pemanggilan. Selain itu, errorType bidang, data bidang, dan errorInfo bidang dapat ditentukan. dataNilai akan ditambahkan ke error blok yang sesuai di errors dalam respons GraphQL.

catatan

dataakan disaring berdasarkan set pemilihan kueri. errorInfoNilai akan ditambahkan ke error blok yang sesuai di errors dalam respons GraphQL.

errorInfotidak akan disaring berdasarkan set pemilihan kueri.

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

Menambahkan kesalahan kustom. Ini dapat digunakan dalam template pemetaan permintaan atau respons jika template mendeteksi kesalahan dengan permintaan atau dengan hasil pemanggilan. Selain itu, errorType bidang, data bidang, dan errorInfo bidang dapat ditentukan. Tidak sepertiutil.error(String, String?, Object?, Object?), evaluasi template tidak akan terganggu, sehingga data dapat dikembalikan ke penelepon. dataNilai akan ditambahkan ke error blok yang sesuai di errors dalam respons GraphQL.

catatan

dataakan disaring berdasarkan set pemilihan kueri. errorInfoNilai akan ditambahkan ke error blok yang sesuai di errors dalam respons GraphQL.

errorInfotidak akan disaring berdasarkan set pemilihan kueri.

Utils pencocokan jenis dan pola

util.matches(String, String) : Boolean

Mengembalikan nilai true jika pola yang ditentukan dalam argumen pertama cocok dengan data yang disediakan dalam argumen kedua. Pola harus berupa ekspresi reguler sepertiutil.matches("a*b", "aaaaab"). Fungsionalitas ini didasarkan pada Pola, yang dapat Anda referensikan untuk dokumentasi lebih lanjut.

util.authType()

Mengembalikan String yang menjelaskan jenis multi-auth yang digunakan oleh permintaan, mengembalikan “Otorisasi”, “IAMOtorisasi Kumpulan Pengguna”, “Otorisasi Open ID Connect”, atau "Otorisasi Kunci”. API

Kembalikan utilitas perilaku nilai

util.escapeJavaScript(String)

Mengembalikan string masukan sebagai string JavaScript lolos.

Utils otorisasi penyelesai

util.unauthorized()

Melempar Unauthorized untuk bidang yang sedang diselesaikan. Gunakan ini dalam templat pemetaan permintaan atau respons untuk menentukan apakah akan mengizinkan pemanggil menyelesaikan bidang.