Swift Academy · Pelajaran

Perutean dan Penanganan Permintaan

Definisikan rute dan tangani permintaan HTTP.

Pelajaran 1 dari 413 langkah

Perutean dan Penanganan Permintaan adalah pelajaran Swift Academy gratis di CoddyKit. Ini adalah pelajaran 1 dari 4. Kamu bisa membaca pelajaran lengkapnya di bawah secara gratis — lalu praktikkan langsung di browser dengan editor kode bawaan dan tutor AI 24/7. Ini adalah bagian dari jalur belajar Swift Academy, dan progresmu tersinkronisasi di web dan aplikasi CoddyKit. Kursus Swift Academy mencakup 4 pelajaran total.

Apa Itu Vapor?

Vapor adalah kerangka kerja web Swift sisi server yang populer dan dibangun di atas SwiftNIO. Kerangka ini memungkinkan Anda menulis backend HTTP—API dan situs web—sepenuhnya dalam Swift, dengan berbagi bahasa dan bahkan model dengan app iOS Anda.

import Vapor

let app = try await Application.make(.detect())

Aplikasi dan Rute

Objek Application adalah inti server Vapor. Anda mendaftarkan rute di dalamnya: pemetaan dari metode dan jalur HTTP ke fungsi penangan yang mengembalikan respons.

app.get("hello") { req in
    "Hello, world!"
}

Pembantu Metode HTTP

Vapor menyediakan satu pembantu untuk setiap verba HTTP: app.get, app.post, app.put, app.patch, dan app.delete. Masing-masing menerima komponen jalur dan penangan.

app.post("users") { req in
    "Created a user"
}
app.delete("users") { req in
    "Deleted a user"
}

Segmen Jalur

Teruskan beberapa segmen string untuk membangun jalur bertingkat. Pemanggilan di bawah merespons GET /api/v1/status.

app.get("api", "v1", "status") { req in
    "OK"
}

Parameter Rute

Gunakan segmen yang diawali titik dua untuk menangkap nilai dinamis. Baca nilai tersebut dari permintaan dengan req.parameters.get(_:). Pada contoh di bawah, permintaan ke /users/42 menangkap 42.

app.get("users", ":id") { req -> String in
    let id = req.parameters.get("id") ?? "unknown"
    return "User id is " + id
}

Parameter Bertipe

Anda dapat mengonversi parameter ke tipe konkret dengan meneruskan tipe tersebut ke get. Jika konversi gagal, Vapor otomatis mengembalikan 404 sehingga penangan tetap bersih.

app.get("posts", ":id") { req -> String in
    let id = try req.parameters.require("id", as: Int.self)
    return "Post number " + String(id)
}

Parameter Kueri

Baca item kueri URL melalui req.query. Untuk /search?term=swift, Anda dapat mendekode term secara langsung. Nilai opsional yang tidak ada cukup dikembalikan sebagai nil.

app.get("search") { req -> String in
    let term = try req.query.get(String.self, at: "term")
    return "Searching for " + term
}

Kelompok Rute

Kelompokkan rute yang berkaitan di bawah awalan bersama dengan app.grouped(...). Cara ini menghindari pengulangan komponen jalur dan menjaga endpoint terkait tetap bersama.

let users = app.grouped("users")
users.get { req in "List users" }      // GET /users
users.post { req in "Create user" }    // POST /users

Mengembalikan Berbagai Tipe Respons

Penangan dapat mengembalikan String, HTTPStatus, tipe Content kustom, atau Response yang dibangun sepenuhnya. Vapor mengetahui cara mengodekan masing-masing tipe menjadi balasan HTTP.

app.delete("cache") { req -> HTTPStatus in
    // clear something
    return .noContent // 204
}

Melempar Kesalahan dengan Abort

Lempar Abort(_:) untuk menghentikan permintaan lebih awal dengan status HTTP tertentu dan alasan opsional. Vapor mengubahnya menjadi respons kesalahan JSON yang rapi.

app.get("secret") { req -> String in
    guard req.headers.first(name: "X-Key") == "open" else {
        throw Abort(.forbidden, reason: "Missing key")
    }
    return "Welcome"
}

Penangan Asinkron

Vapor 4+ sepenuhnya mendukung async/await. Tandai fungsi penangan sebagai asinkron dan gunakan try await di dalamnya untuk pekerjaan basis data atau jaringan.

app.get("ping") { req async throws -> String in
    try await Task.sleep(for: .milliseconds(10))
    return "pong"
}

Uji Cepat: Perutean

Pastikan pengetahuan perutean Anda.

Jawab di pelajaran interaktif

Ringkasan: Perutean dan Penanganan Permintaan

Sekarang Anda dapat menghubungkan server Vapor:

Daftarkan rute dengan app.get/post/put/patch/delete dan segmen jalur.
Tangkap nilai dinamis dengan :param dan baca melalui req.parameters (dengan tipe menggunakan require(_:as:)).
Baca item kueri dari req.query, lalu kelompokkan rute dengan grouped.
Kembalikan string, status, atau konten; lempar Abort untuk kesalahan; gunakan penangan asinkron.

Gratis untuk memulai

Belajar Swift dengan tutor AI — gratis

Tulis dan jalankan kode asli di browser kamu, dapatkan bantuan instan dari tutor AI 24/7, dan lanjutkan di mana kamu tinggalkan di web atau aplikasi.

Kursus: 122
Pelajaran: 409

Mulai belajar gratis Lihat kursus lengkapnya

Pertanyaan yang Sering Diajukan

Apakah pelajaran “Perutean dan Penanganan Permintaan” gratis?

Ya — teks lengkap “Perutean dan Penanganan Permintaan” gratis dibaca di sini di web. Untuk praktiknya secara interaktif (editor kode bawaan dan tutor AI 24/7) dan buka sisa kursus Swift Academy, upgrade ke CoddyKit PRO. Kursus Swift Academy mencakup 4 pelajaran total.

Apa yang akan aku pelajari di “Perutean dan Penanganan Permintaan”?

Definisikan rute dan tangani permintaan HTTP. Kamu berlatih Swift Academy dengan kode praktik yang langsung kamu jalankan di browser, dan tutor AI 24/7 menjawab pertanyaanmu saat kamu mengerjakan pelajaran ini.

Apakah aku perlu pengalaman untuk memulai Swift Academy?

Tidak diperlukan pengalaman sebelumnya. Swift Academy di CoddyKit dirancang untuk pemula hingga pelajar tingkat lanjut, jadi kamu bisa memulai di sini atau dari awal dan belajar sesuai kecepatan kamu sendiri. Ini adalah pelajaran 1 dari 4.

Berapa lama pelajaran “Perutean dan Penanganan Permintaan” memakan waktu?

Sebagian besar pelajaran CoddyKit memakan waktu sekitar 5–10 menit. Setiap pelajaran ringkas dan interaktif, jadi kamu membuat kemajuan stabil dan melanjutkan dari tempat kamu tinggalkan di web dan aplikasi.

Bisakah aku menulis dan menjalankan kode dalam pelajaran Swift Academy ini?

Ya. Setiap pelajaran Swift Academy menyertakan editor kode bawaan, jadi kamu menulis dan menjalankan kode nyata langsung di browser dan mendapatkan umpan balik AI instan — tidak diperlukan penyiapan lokal.

Semua pelajaran dalam kursus ini

← Kembali ke Swift Academy