
Pada minggu pertama projek ASP.NET Core dimulakan, sebuah controller biasanya nampak sangat bersih. Satu action hanya ada dua puluh baris: terima model daripada permintaan HTTP, simpan rekod ke pangkalan data, kemudian pulangkan Ok() atau CreatedAtAction().
Enam bulan kemudian, keadaan berubah tanpa disedari. Action Checkout yang sama kini menyemak stok, mengira diskaun ahli, menambah cukai SST, menulis log audit, menghantar e-mel resit, dan memanggil API gerbang pembayaran luar. Di bahagian atas fail pula sudah berderet enam atau tujuh dependency dalam constructor—daripada AppDbContext, IEmailService, IConfiguration, sehinggalah HttpClientFactory. Setiap kali ada perubahan kecil pada peraturan diskaun, pembangun terpaksa menyentuh fail yang sama dan risau kalau-kalau tersalah usik bahagian pembayaran.
Apabila controller sudah menjadi tempat semua keputusan berkumpul, kos menyelenggara dan menguji kod mula naik mendadak.
Asingkan sempadan kerja mengikut lapisan
Sebelum terus memotong kod ke sana sini, fahami dahulu apa yang sebenarnya patut kekal di dalam controller. Tugas utama controller dalam ASP.NET Core ialah mengurus protokol HTTP: menerima input yang sudah diikat (model binding), mengesahkan format asas, menyemak kebenaran pengguna, memanggil lapisan aplikasi, dan memulangkan kod status HTTP yang tepat seperti 200, 400, 404, atau 409.
Peraturan perniagaan pula patut hidup di tempat yang tidak tahu apa-apa tentang HttpContext atau IActionResult. Sebagai contoh, lihat perbezaan antara pengiraan harga yang bercampur terus dalam action berbanding memindahkannya ke kelas pengiraan yang khusus:
// Sebelum: semuanya bercampur dalam controller
[HttpPost("calculate")]
public async Task<IActionResult> Calculate(CheckoutRequest req)
{
var customer = await _db.Customers.FindAsync(req.CustomerId);
if (customer is null) return NotFound();
decimal discount = customer.IsVip ? req.Subtotal * 0.15m : 0m;
if (req.PromoCode == "RAYA2026" && req.Subtotal >= 150m)
discount += 20m;
var total = Math.Max(0, req.Subtotal - discount) * 1.08m;
return Ok(new { Total = total });
}
Jika peraturan diskaun dan cukai ini dipindahkan ke kelas atau service ringkas yang hanya menerima nilai dan memulangkan keputusan, anda boleh menulis ujian unit dengan xUnit dalam beberapa saat tanpa perlu menghidupkan WebApplicationFactory atau menyambung ke pangkalan data ujian. Controller pula kembali kepada peranan asalnya: mengambil data yang diperlukan, menyerahkan pengiraan kepada service, dan memulangkan respons HTTP.
Jangan pecahkan kod secara berlebihan
Ramai pembangun yang baru tersedar controller mereka terlalu gemuk terus melompat ke ekstrem yang satu lagi: satu action dipecah menjadi sepuluh fail baharu lengkap dengan interface, repository generik, dan lapisan mapper untuk operasi CRUD yang ringkas. Akhirnya kod tetap susah dibaca, cuma kali ini pembangun terpaksa melompat antara lapan tab berbeza untuk memahami satu aliran mudah.
Pendekatan yang lebih praktikal ialah melakukan refactor secara beransur pada bahagian yang paling kerap berubah atau paling menyakitkan untuk diuji. Mulakan dengan mengekstrak satu bahagian logik—contohnya pengiraan harga atau pengesahan kupon—tulis beberapa ujian untuk kes tepi seperti nilai negatif atau kupon tamat tempoh, kemudian panggil fungsi itu dari controller. Perubahan kecil yang mudah disemak dalam satu pull request jauh lebih selamat berbanding rombakan besar-besaran yang menghentikan ciri baharu selama seminggu.
Jaga sempadan operasi luaran
Satu lagi masalah tersembunyi dalam controller yang padat ialah pengendalian kesan sampingan luaran. Bayangkan pesanan pelanggan sudah berjaya disimpan melalui await _db.SaveChangesAsync(), tetapi dua baris selepas itu panggilan ke pelayan SMTP untuk menghantar e-mel resit mengalami timeout.
Jika semuanya berada dalam satu method segerak (synchronous) tanpa sempadan ralat yang jelas, pengguna mungkin nampak halaman ralat 500 Internal Server Error walaupun duit sudah ditolak dan rekod sudah masuk dalam pangkalan data. Akibatnya, pengguna menekan butang bayar sekali lagi dan berlakulah tempahan berganda.
Apabila aliran diasingkan, lebih mudah untuk membezakan mana operasi yang wajib berjaya sebelum respons dihantar (seperti menyimpan transaksi) dan mana yang boleh ditangguhkan atau diulang cuba di latar belakang menggunakan queue atau background worker. Dokumentasi rasmi ASP.NET Core MVC memberi asas yang baik tentang struktur controller, namun disiplin menentukan sempadan transaksi tetap bergantung pada aliran sebenar sistem anda.