Routing dengan ServeMux

ServeMux dulu hanya bisa mencocokkan awalan path. Go 1.22 mengubahnya jadi router yang mengerti "GET /produk/{id}", dengan aturan prioritas yang jelas dan tanpa dependensi.

Bentuk pola

mux := http.NewServeMux()

mux.HandleFunc("GET /produk", h.Daftar)
mux.HandleFunc("POST /produk", h.Buat)
mux.HandleFunc("GET /produk/{id}", h.Ambil)
mux.HandleFunc("PUT /produk/{id}", h.Ubah)
mux.HandleFunc("DELETE /produk/{id}", h.Hapus)

mux.HandleFunc("GET /produk/{id}/ulasan/{ulasanID}", h.Ulasan)
mux.HandleFunc("GET /berkas/{path...}", h.Berkas)   // menangkap sisa jalur
mux.HandleFunc("/", h.TidakDitemukan)                // penangkap semua

func (h *Handler) Ambil(w http.ResponseWriter, r *http.Request) {
	id, err := strconv.ParseInt(r.PathValue("id"), 10, 64)
	if err != nil {
		http.Error(w, "id tidak valid", http.StatusBadRequest)
		return
	}
	...
}

Aturan prioritas

Berbeda dari kebanyakan router, urutan pendaftaran tidak berpengaruh. Yang menang adalah pola yang lebih spesifik:

Garis miring di akhir menentukan segalanya

mux.HandleFunc("GET /admin", h.Admin)    // HANYA /admin
mux.HandleFunc("GET /admin/", h.Admin)   // /admin/ dan SELURUH isinya

Pola {$} ada khusus untuk kasus terakhir: "cocokkan akhir jalur, jangan subtree". Tanpa itu, pola / akan menangkap semua permintaan yang tidak cocok pola lain — yang biasanya memang yang kamu mau untuk halaman 404.

Menyusun rute untuk aplikasi nyata

func (h *Handler) Rute() http.Handler {
	mux := http.NewServeMux()

	// Publik
	mux.HandleFunc("GET /sehat", h.Sehat)
	mux.HandleFunc("GET /produk", h.DaftarProduk)
	mux.HandleFunc("GET /produk/{id}", h.AmbilProduk)

	// Butuh autentikasi — subrouter dengan middleware sendiri
	priv := http.NewServeMux()
	priv.HandleFunc("POST /produk", h.BuatProduk)
	priv.HandleFunc("PUT /produk/{id}", h.UbahProduk)
	priv.HandleFunc("GET /saya/pesanan", h.PesananSaya)
	mux.Handle("/api/", http.StripPrefix("/api",
		h.WajibLogin(priv)))

	// Berkas statis dari binari
	mux.Handle("GET /statis/", http.StripPrefix("/statis",
		http.FileServer(http.FS(statisFS))))

	// Middleware global, urutan dari luar ke dalam
	return Pulihkan(Log(h.log, BatasWaktu(10*time.Second, mux)))
}

Batas ServeMux, dan kapan itu penting

Untuk aplikasi dengan puluhan rute dan beberapa kelompok middleware, chi (Fase 7) memberi sintaks grup yang jauh lebih ringkas — dengan tipe yang sama persis, sehingga handler-mu tidak berubah sebaris pun. Untuk aplikasi kecil sampai menengah, ServeMux benar-benar cukup.