Hoàn thành bài "Bài 2: Thiết lập dự án Node.js và Express" trước để mở khoá bài này.Đến bài trước

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.

sơ đồ kiến trúc phân lớp thể hiện Request chảy vào app.js, sau đó đến tầng Router, rồi đến tầng Controller, rồi đến tầng Data (placeholder)

Cấu trúc Dự án

Đây là cấu trúc thư mục mà chúng ta sẽ xây dựng:

text
project/
├── app.js
├── routes/
│ ├── users.js
│ └── products.js
└── controllers/
├── usersController.js
└── productsController.js

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:

javascript
// routes/users.js
const express = require('express');
const router = express.Router();
const usersController = require('../controllers/usersController');
router.get('/', usersController.getAllUsers);
router.get('/:id', usersController.getUserById);
router.post('/', usersController.createUser);
router.put('/:id', usersController.updateUser);
router.delete('/:id', usersController.deleteUser);
module.exports = router;

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:

javascript
// app.js
const express = require('express');
const app = express();
app.use(express.json());
const usersRouter = require('./routes/users');
const productsRouter = require('./routes/products');
app.use('/users', usersRouter);
app.use('/products', productsRouter);
app.listen(3000, () => console.log('Server running on port 3000'));

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.

javascript
// controllers/usersController.js
// Simulated in-memory data — you will replace this with a database call later
const users = [
{ id: 1, name: 'Alice', email: 'alice@example.com' },
{ id: 2, name: 'Bob', email: 'bob@example.com' },
];
exports.getAllUsers = (req, res) => {
res.json(users);
};
exports.getUserById = (req, res) => {
const user = users.find(u => u.id === parseInt(req.params.id));
if (!user) {
return res.status(404).json({ message: 'User not found' });
}
res.json(user);
};
exports.createUser = (req, res) => {
const { name, email } = req.body;
if (!name || !email) {
return res.status(400).json({ message: 'name and email are required' });
}
const newUser = { id: users.length + 1, name, email };
users.push(newUser);
res.status(201).json(newUser);
};
exports.updateUser = (req, res) => {
const user = users.find(u => u.id === parseInt(req.params.id));
if (!user) {
return res.status(404).json({ message: 'User not found' });
}
const { name, email } = req.body;
if (name) user.name = name;
if (email) user.email = email;
res.json(user);
};
exports.deleteUser = (req, res) => {
const index = users.findIndex(u => u.id === parseInt(req.params.id));
if (index === -1) {
return res.status(404).json({ message: 'User not found' });
}
users.splice(index, 1);
res.status(204).send();
};

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.

sơ đồ flowchart thể hiện một HTTP request đầu vào được Router khớp tới hàm Controller tương ứng, sau đó phân nhánh thành response thành công và response lỗi

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.

Luyện tập sau buổi học

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.

0/1
Đã trả lời · 0/1