Pengenalan kepada Ring dan Asas HTTP

Selamat datang ke pembangunan web dengan Clojure! Dalam pelajaran ini, kita akan mendalami asas cara aplikasi web berfungsi dan memperkenalkan Ring, antara muka standard Clojure untuk membina aplikasi web.

Memahami asas ini penting untuk mencipta perkhidmatan web yang berkuasa!

Internet bergantung pada protokol yang dipanggil HTTP (Protokol Pemindahan Hiperteks). Protokol ini ialah bahasa yang digunakan oleh pelayar web dan pelayan untuk berkomunikasi antara satu sama lain.

Anggaplah ia sebagai satu perbualan: pelayar anda menghantar permintaan, kemudian pelayan menghantar respons kembali.

Permintaan HTTP ialah permintaan yang dihantar oleh pelayar anda kepada pelayan. Biasanya, permintaan ini merangkumi:

• Kaedah: Tindakan yang ingin anda lakukan (contohnya, GET, POST).
• URI: Sumber khusus yang anda minta (contohnya, /users/123).
• Pengepala: Maklumat tambahan tentang permintaan (contohnya, jenis pelayar dan format yang diterima).
• Badan: Data yang dihantar kepada pelayan (contohnya, penghantaran borang dan data JSON).

Dua kaedah HTTP yang sangat lazim ialah:

• GET: Digunakan untuk mendapatkan data daripada pelayan, seperti meminta halaman web atau imej. Permintaan GET biasanya tidak mempunyai badan.
• POST: Digunakan untuk menghantar data kepada pelayan bagi mencipta atau mengemas kini sumber, seperti menghantar borang log masuk atau memuat naik fail. Permintaan POST biasanya mempunyai badan.

Selepas menerima permintaan, pelayan memprosesnya lalu menghantar respons HTTP kembali. Respons ini mengandungi:

• Kod Status: Nombor yang menunjukkan hasil operasi (contohnya, 200 untuk berjaya dan 404 untuk tidak ditemui).
• Pengepala: Metadata tentang respons (contohnya, jenis kandungan dan arahan cache).
• Badan: Kandungan sebenar yang dihantar kembali (contohnya, HTML, JSON atau imej).

Kod status memberitahu pelayar tentang hasil permintaan. Antara kod yang lazim ialah:

• 200 OK: Permintaan berjaya!
• 404 Not Found: Sumber yang diminta tidak wujud.
• 500 Internal Server Error: Berlaku masalah pada pihak pelayan.
• 302 Found: Sumber itu buat sementara waktu berada di lokasi lain (pelencongan).

Membina aplikasi web dalam Clojure biasanya bermula dengan Ring. Ring bukan rangka kerja web, sebaliknya satu spesifikasi yang ringkas.

Ring mentakrifkan antara muka minimum untuk pengendali HTTP, sekali gus memudahkan anda menukar pelayan web dan membina aplikasi modular.

Ring mengambil permintaan HTTP yang masuk lalu menterjemahkannya kepada peta Clojure standard. peta permintaan ini mengandungi semua butiran:

{:request-method :get
 :uri "/users/1"
 :headers {"host" "localhost:3000"}
 :body ...
 ; and many more keys
}

Aplikasi web anda kemudiannya berfungsi dengan peta ini.

Begitu juga, apabila aplikasi anda ingin menghantar respons, aplikasi itu mengembalikan peta respons yang ditukar semula oleh Ring kepada respons HTTP. Peta respons biasa kelihatan seperti ini:

{:status 200
 :headers {"Content-Type" "text/plain"}
 :body "Hello, World!"
}

Ketiga-tiga kunci ini merupakan yang paling penting.

Pengendali Ring ialah fungsi Clojure yang mengambil peta permintaan sebagai argumen dan mengembalikan peta respons.

Cuba jalankan contoh ini untuk melihat cara pengendali memproses permintaan olok-olok dan menghasilkan respons:

Syabas! Anda telah mempelajari blok binaan asas pembangunan web dalam Clojure:

• HTTP: Protokol komunikasi untuk web (permintaan & respons).
• Permintaan HTTP: Kaedah, URI, Pengepala, Badan.
• Respons HTTP: Status, Pengepala, Badan.
• Ring: Spesifikasi Clojure yang ringkas dan berkuasa untuk pengendali web.
• Pengendali Ring: Fungsi yang mengubah peta permintaan menjadi peta respons.

Seterusnya, kita akan meneroka cara mengendalikan routes yang berbeza dengan Compojure!