View a markdown version of this page

Built-in utilitas - AWS AppSync GraphQL
Utilitas pengkodeanUtilitas pembuatan IDUtilitas kesalahanUtilitas pencocokan jenis dan polaUtilitas perilaku nilai kembalikanUtilitas otorisasi resolver

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

Built-in utilitas

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

Utilitas pengkodean

util.urlEncode(String)

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

util.urlDecode(String)

Mendekode string yang application/x-www-form-urlencoded dikodekan kembali ke bentuknya 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 UUID 128-bit yang dihasilkan secara acak.

util.autoUlid()

Mengembalikan ULID 128-bit yang dihasilkan secara acak (Universally Unique Lexicographical Sortable Identifier).

util.autoKsuid()

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

Utilitas kesalahan

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 difilter berdasarkan kumpulan pemilihan kueri. errorInfoNilai akan ditambahkan ke error blok yang sesuai di errors dalam respons GraphQL.

errorInfotidak akan difilter berdasarkan kumpulan pemilihan kueri.

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

Menambahkan 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. 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 difilter berdasarkan kumpulan pemilihan kueri. errorInfoNilai akan ditambahkan ke error blok yang sesuai di errors dalam respons GraphQL.

errorInfotidak akan difilter berdasarkan kumpulan pemilihan kueri.

Utilitas pencocokan jenis dan pola

util.matches(String, String) : Boolean

Mengembalikan 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 didasarkan pada P ola, yang dapat Anda rujuk untuk dokumentasi lebih lanjut.

util.authType()

Mengembalikan String yang menjelaskan jenis multi-auth yang digunakan oleh permintaan, mengembalikan “Otorisasi IAM”, “Otorisasi Kumpulan Pengguna”, “Otorisasi Koneksi ID Terbuka”, atau “Otorisasi Kunci API”.

Utilitas perilaku nilai kembalikan

util.escapeJavaScript(String)

Mengembalikan string input sebagai string yang JavaScript lolos.

Utilitas otorisasi resolver

util.unauthorized()

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