Bahagian Belakang Tanpa Pelayan dengan AWS Lambda dan API Gateway · Pelajaran

Transformasi Permintaan/Respons

Sesuaikan muatan permintaan dan respons API Gateway menggunakan templat pemetaan (VTL) untuk disepadukan dengan pelbagai sistem bahagian belakang.

Pelajaran 2 daripada 411 langkah

Transformasi Permintaan/Respons ialah pelajaran Bahagian Belakang Tanpa Pelayan dengan AWS Lambda dan API Gateway percuma di CoddyKit. Ini ialah pelajaran 2 daripada 4. Anda boleh membaca keseluruhan pelajaran di bawah secara percuma — kemudian berlatih secara praktikal dalam pelayar menggunakan penyunting kod terbina dalam dan tutor kecerdasan buatan 24/7. Pelajaran ini merupakan sebahagian daripada laluan pembelajaran Bahagian Belakang Tanpa Pelayan dengan AWS Lambda dan API Gateway, dan kemajuan anda disegerakkan merentas web serta aplikasi CoddyKit. Kursus Bahagian Belakang Tanpa Pelayan dengan AWS Lambda dan API Gateway merangkumi sejumlah 4 pelajaran.

Merapatkan Jurang Data

Bayangkan klien API anda menggunakan satu bahasa data, tetapi perkhidmatan bahagian belakang anda memahami bahasa yang lain. Bagaimanakah anda memastikan kedua-duanya berkomunikasi dengan lancar?

Transformasi permintaan dan respons API Gateway bertindak sebagai penterjemah sejagat, dengan mengubah suai muatan untuk memastikan keserasian antara sistem yang berbeza.

Memperkenalkan Templat Pemetaan

Di teras transformasi ialah templat pemetaan. Templat ini ialah templat berasaskan teks yang ditulis menggunakan Velocity Template Language (VTL).

Anda mentakrifkan templat VTL yang memberitahu API Gateway dengan tepat cara menyusun semula atau mengubah suai data masuk (permintaan) atau data keluar (respons).

Transformasi Permintaan

Transformasi permintaan mengubah suai data yang dihantar oleh klien anda sebelum data tersebut sampai kepada perkhidmatan bahagian belakang anda (seperti fungsi Lambda).

Ini berguna untuk:

Memudahkan permintaan klien yang kompleks untuk bahagian belakang.
Menambahkan pengepala atau parameter tertentu.
Menukar format data (contohnya, XML kepada JSON, atau struktur JSON yang berbeza).

VTL untuk Pemetaan Permintaan

Berikut ialah contoh VTL ringkas untuk permintaan. Contoh ini mengambil id dan qty klien lalu memetakannya kepada productId dan quantity untuk bahagian belakang anda.

Pemboleh ubah $input memberi anda akses kepada badan dan parameter permintaan masuk.

#set($body = $input.json('$'))
{
  "productId": "$body.id",
  "quantity": $body.qty
}

Mengakses Konteks Permintaan

Selain badan, anda boleh mengakses butiran permintaan lain seperti parameter laluan, rentetan pertanyaan dan pengepala menggunakan pemboleh ubah $context.

Ini membolehkan anda memperkaya input bahagian belakang anda dengan maklumat kontekstual yang bernilai daripada panggilan API.

#set($body = $input.json('$'))
{
  "userId": "$context.authorizer.claims.sub",
  "resourcePath": "$context.resourcePath",
  "itemId": "$input.params('itemId')",
  "requestedQuantity": $body.qty
}

Transformasi Respons

Transformasi respons mengubah suai data yang dikembalikan oleh perkhidmatan bahagian belakang anda sebelum data tersebut dihantar kembali kepada klien.

Ini penting untuk:

Menyeragamkan respons API merentas bahagian belakang yang berbeza.
Menyembunyikan butiran dalaman yang sensitif daripada klien.
Menukar output bahagian belakang kepada format yang mudah digunakan oleh klien.

VTL untuk Pemetaan Respons

Sama seperti permintaan, anda menggunakan VTL untuk mengubah respons. Dalam contoh ini, medan result bahagian belakang dipetakan kepada medan data yang lebih umum untuk klien.

Pemboleh ubah $input dalam templat respons merujuk kepada output bahagian belakang.

#set($body = $input.json('$'))
{
  "status": "success",
  "data": $body.result
}

Pemetaan Respons Bersyarat

API Gateway membolehkan anda mentakrifkan templat respons yang berbeza berdasarkan kod status HTTP bahagian belakang. Ini bermakna anda boleh mempunyai satu templat khusus untuk kejayaan (contohnya, 200 OK) dan satu lagi untuk ralat (contohnya, 400 Bad Request).

Ini memberikan kawalan terperinci terhadap cara hasil yang berbeza dipersembahkan kepada klien.

#if($input.path('$.statusCode') == 200)
{
  "message": "Operation successful."
}
#else
{
  "error": "$input.path('$.errorMessage')"
}
#end

Amalan Terbaik VTL

Apabila menulis templat VTL:

Pastikan ringkas: Elakkan logik yang kompleks; serahkan kepada bahagian belakang anda jika perlu.
Uji dengan teliti: Gunakan ciri pemanggilan ujian API Gateway.
Gunakan $util.urlEncode: Pengekodkan nilai apabila meletakkannya ke dalam URL atau rentetan pertanyaan.
Kendalikan nilai null: Gunakan $!variable untuk mengeluarkan rentetan kosong jika pemboleh ubah bernilai null.

Semakan Pantas

Anda telah mempelajari cara transformasi API Gateway membentuk semula data. Manakah antara berikut merupakan manfaat utama menggunakan transformasi permintaan/respons?

Jawab dalam pelajaran interaktif

Imbas Kembali: Menguasai Transformasi

Anda telah mempelajari bahawa transformasi API Gateway yang dikuasakan oleh templat pemetaan VTL amat penting untuk membina API yang fleksibel dan teguh.

Dengan membentuk permintaan masuk dan respons keluar, anda dapat memastikan komunikasi yang lancar antara klien dan perkhidmatan bahagian belakang yang pelbagai, di samping meningkatkan kebolehselenggaraan dan mengurangkan kerumitan.

Percuma untuk bermula

Pelajari Bahagian Belakang Tanpa Pelayan dengan AWS Lambda dan API Gateway dengan tutor kecerdasan buatan — percuma

Tulis dan jalankan kod sebenar dalam pelayar anda, dapatkan bantuan segera daripada tutor kecerdasan buatan yang tersedia 24/7, dan sambung semula dari tempat anda berhenti di web atau dalam aplikasi.

Kursus: 12
Pelajaran: 48

Mula belajar secara percuma Lihat kursus penuh

Soalan Lazim

Adakah pelajaran “Transformasi Permintaan/Respons” percuma?

Ya — teks penuh “Transformasi Permintaan/Respons” boleh dibaca secara percuma di web ini. Untuk berlatih secara interaktif menggunakan penyunting kod terbina dalam dan tutor kecerdasan buatan 24/7, serta membuka kunci baki kursus Bahagian Belakang Tanpa Pelayan dengan AWS Lambda dan API Gateway, tingkat taraf kepada CoddyKit PRO. Kursus Bahagian Belakang Tanpa Pelayan dengan AWS Lambda dan API Gateway merangkumi sejumlah 4 pelajaran.

Apakah yang akan saya pelajari dalam “Transformasi Permintaan/Respons”?

Sesuaikan muatan permintaan dan respons API Gateway menggunakan templat pemetaan (VTL) untuk disepadukan dengan pelbagai sistem bahagian belakang. Anda berlatih Bahagian Belakang Tanpa Pelayan dengan AWS Lambda dan API Gateway menggunakan kod praktikal yang dijalankan terus dalam pelayar, manakala tutor kecerdasan buatan 24/7 menjawab soalan anda semasa anda mengikuti pelajaran.

Adakah saya memerlukan pengalaman untuk memulakan Bahagian Belakang Tanpa Pelayan dengan AWS Lambda dan API Gateway?

Tiada pengalaman terdahulu diperlukan. Pembelajaran Bahagian Belakang Tanpa Pelayan dengan AWS Lambda dan API Gateway di CoddyKit disusun untuk pelajar daripada peringkat pemula hingga lanjutan, jadi anda boleh bermula di sini atau dari awal dan belajar mengikut kadar anda sendiri. Ini ialah pelajaran 2 daripada 4.

Berapa lamakah pelajaran “Transformasi Permintaan/Respons” diambil?

Kebanyakan pelajaran CoddyKit mengambil masa kira-kira 5–10 minit. Setiap pelajaran ringkas dan interaktif, jadi anda boleh membuat kemajuan secara berterusan dan menyambung tepat dari tempat anda berhenti di web atau aplikasi.

Bolehkah saya menulis dan menjalankan kod dalam pelajaran Bahagian Belakang Tanpa Pelayan dengan AWS Lambda dan API Gateway ini?

Ya. Setiap pelajaran Bahagian Belakang Tanpa Pelayan dengan AWS Lambda dan API Gateway menyertakan penyunting kod terbina dalam, jadi anda boleh menulis dan menjalankan kod sebenar terus dalam pelayar serta menerima maklum balas kecerdasan buatan serta-merta — tanpa memerlukan persediaan setempat.

Semua pelajaran dalam kursus ini

Pencachean dan Pendikitan
Transformasi Permintaan/Respons
Nama Domain Tersuai dan Pengoptimuman Pinggir
API WebSocket untuk Komunikasi Masa Nyata

← Kembali ke Bahagian Belakang Tanpa Pelayan dengan AWS Lambda dan API Gateway