Giới thiệu
Khi API của bạn phát triển vượt quá vài endpoint, việc nhồi nhét tất cả vào một file duy nhất sẽ nhanh chóng trở nên khó quản lý. Express cung cấp cho bạn một công cụ có sẵn tên là Router để tách các route thành các module riêng theo resource. Kết hợp với một tầng controllers, bạn sẽ có một cấu trúc mở rộng gọn gàng — thành viên mới có thể tìm thấy thứ họ cần, và việc thêm resource mới không động chạm đến code hiện có.
Bài học này sẽ đi qua một cấu trúc dự án cụ thể: routes định nghĩa các URL pattern và HTTP verb, controllers chứa logic handler thực sự, và app.js sẽ kết nối chúng lại với nhau. Sự tách biệt đó là thói quen quan trọng nhất cần xây dựng ngay từ đầu.
Cấu trúc Dự án
Đây là cấu trúc thư mục mà chúng ta sẽ xây dựng:
Mẫu này rất đơn giản: một file route cho mỗi resource, một file controller cho mỗi resource. Routes giữ mỏng — chúng chỉ khai báo hàm controller nào xử lý từng endpoint. Controllers giữ tập trung — chúng chỉ chứa logic request/response cho resource của mình.
Express Router
Express Router tạo ra một mini-application xử lý các route độc lập, sau đó bạn mount nó trên một path trong app.js.
Bắt đầu với file route của users:
Chú ý rằng các route sử dụng đường dẫn tương đối như / và /:id, không phải /users hay /users/:id. Tiền tố sẽ được thêm vào khi bạn mount router trong app.js, nhờ vậy bạn không phải lặp lại.
Mount router trong app.js:
Một request GET tới /users/42 giờ sẽ khớp với router.get('/:id', ...) với req.params.id bằng '42'. Gọn gàng và dễ dự đoán.
Controllers
Controller là các module thuần export các hàm có tên. Mỗi hàm là một request handler tiêu chuẩn của Express — nó nhận req và res (và tùy chọn next) và chịu trách nhiệm gửi response.
Có vài điểm đáng lưu ý ở đây. Controller xác thực input và trả về sớm với mã trạng thái phù hợp khi có lỗi — điều này giúp luồng chính dễ đọc hơn. Kiểm tra 404 được viết rõ ràng: đừng giả định bản ghi tồn tại. Và 204 No Content kèm không có body là response quy chuẩn cho một thao tác xóa thành công.
Những lỗi thường gặp
Quên parse JSON request body là lỗi phổ biến nhất với người mới. Nếu thiếu app.use(express.json()) trong app.js, req.body sẽ là undefined và createUser hoặc updateUser sẽ âm thầm nhận về giá trị rỗng.
Một cạm bẫy khác là so sánh trực tiếp req.params.id (kiểu string) với một id kiểu số bằng phép so sánh nghiêm ngặt. Phép kiểm tra users.find(u => u.id === req.params.id) sẽ luôn thất bại vì '42' !== 42. Hãy dùng parseInt hoặc Number() để chuyển đổi trước.
Cuối cùng, không return sau khi gửi response sẽ dẫn đến lỗi 'Cannot set headers after they are sent'. Luôn dùng return res.status(404).json(...) — return ngăn Express tiếp tục chạy dòng tiếp theo và cố gắng gửi một response thứ hai.
Tóm tắt
Express Router cho phép bạn nhóm các route liên quan thành các module riêng và mount chúng tại một tiền tố trong app.js. Controllers giữ logic xử lý tách khỏi file route, giúp mỗi tầng dễ đọc, dễ test và dễ mở rộng hơn. Mô hình là: file route khai báo URL và HTTP verb, hàm controller xử lý logic và gửi response. Hãy giữ nguyên tắc một file cho mỗi resource và cấu trúc này sẽ vững vàng khi dự án phát triển.
Bài kiểm tra cuối bài
Ôn lại kiến thức, thử sức và nhận góp ý cho bài làm.