Ở bài trước chúng ta đã khai báo các route của MiniBlog ngay trong app.js. Với vài route thì không sao, nhưng khi có thêm trang đăng nhập, bình luận, API... file này sẽ dài ra rất nhanh. Tiếp tục với series, bài này mình sẽ giới thiệu với mọi người về router và tổ chức route trong Express.
1. Router là gì?
Router là một nhóm route (và middleware) độc lập, có thể gắn vào ứng dụng ở một đường dẫn bất kỳ. Tài liệu của Express gọi nó là một "mini-app": router khai báo route giống hệt app, nhưng không tự chạy server được mà phải gắn vào một ứng dụng.
Để tạo router, các bạn sử dụng express.Router() với cú pháp như sau:
const router = express.Router(options);
Trong đó: options là object cấu hình, có thể bỏ trống. Các option gồm caseSensitive (phân biệt hoa thường), strict (phân biệt dấu / ở cuối) và mergeParams (mình sẽ nói ở phần 2), cả ba mặc định là false.
Sau khi tạo, các bạn dùng router.get(), router.post(), router.route()... y như với app ở bài trước.
2. Mount router với prefix.
Router chỉ hoạt động khi được gắn (mount) vào ứng dụng bằng app.use():
app.use(prefix, router);
Trong đó:
prefixlà đường dẫn gốc của router, mọi route trong router sẽ nằm dưới đường dẫn này. Nếu bỏ trống thì mặc định là/.routerlà router vừa tạo.
VD: Mình tạo router cho bài viết và mount ở /posts.
- router.js
import express from 'express';
const app = express();
const postsRouter = express.Router();
postsRouter.get('/', (req, res) => {
res.send('Danh sách bài viết');
});
postsRouter.get('/:slug', (req, res) => {
res.send(`Bài viết: ${req.params.slug}`);
});
app.use('/posts', postsRouter);
app.listen(3000);
// GET /posts => Danh sách bài viết
// GET /posts/hello-express => Bài viết: hello-express
// GET /hello-express => 404
Như bài trước, các bạn tạo file ví dụ trong thư mục miniblog, tắt npm run dev rồi chạy node router.js. Trong router, mình chỉ viết / và /:slug, phần /posts do app.use() thêm vào. Nhờ vậy muốn đổi prefix (VD: thành /bai-viet) thì chỉ cần sửa một chỗ.
Lấy tham số của prefix với mergeParams.
Prefix cũng có thể chứa tham số, VD: router bình luận mount ở /posts/:slug/comments. Nhưng mặc định router không nhìn thấy tham số nằm trong prefix, các bạn phải bật option mergeParams:
- merge.js
import express from 'express';
const app = express();
const commentsRouter = express.Router({ mergeParams: true });
commentsRouter.get('/', (req, res) => {
res.json(req.params);
});
app.use('/posts/:slug/comments', commentsRouter);
app.listen(3000);
// GET /posts/hello-express/comments => {"slug":"hello-express"}
Nếu bỏ { mergeParams: true } thì cùng request đó sẽ trả về {}.
3. Router-level middleware.
Ngoài route, router còn có router.use() để gắn middleware: một hàm chạy trước các route, nhận thêm tham số thứ ba là next. Gọi next() thì request đi tiếp tới route phía sau. Middleware gắn vào router gọi là router-level middleware, nó chỉ chạy cho các request đi vào router đó.
Ở bài này các bạn chỉ cần hiểu như vậy, Bài 6 sẽ nói chi tiết về middleware.
VD: Mình muốn ghi log mọi request vào khu vực quản trị /admin, còn trang chủ thì không.
- middleware.js
import express from 'express';
const app = express();
const adminRouter = express.Router();
// Chạy cho mọi request đi vào adminRouter
adminRouter.use((req, res, next) => {
console.log(`[admin] ${req.method} ${req.url}`);
next();
});
adminRouter.get('/', (req, res) => {
res.send('Trang quản trị');
});
adminRouter.get('/posts', (req, res) => {
res.send('Quản lý bài viết');
});
app.get('/', (req, res) => {
res.send('Trang chủ');
});
app.use('/admin', adminRouter);
app.listen(3000);
Chạy node middleware.js rồi lần lượt gọi /, /admin và /admin/posts, terminal đang chạy server in ra:
[admin] GET /
[admin] GET /posts
Request tới trang chủ không đi qua adminRouter nên không có log. Các bạn để ý req.url bên trong router là /posts chứ không phải /admin/posts: Express đã bỏ phần prefix đi, nên router không cần biết mình được mount ở đâu.
Chú ý: Nếu middleware không gọi next() và cũng không trả response, request sẽ bị treo cho đến khi client hết thời gian chờ.
Sau này chúng ta sẽ dùng cách này để chặn người chưa đăng nhập ở cả một nhóm route (Bài 16) thay vì kiểm tra trong từng route.
Chạy thử xong các bạn xoá các file ví dụ (router.js, merge.js, middleware.js), chúng không thuộc project MiniBlog.
4. Tách route ra file theo tính năng.
Giờ chúng ta áp dụng vào MiniBlog: mỗi tính năng một file trong thư mục routes, mỗi file export một router. Các tính năng sau như đăng nhập hay API sẽ có file riêng tương tự.
import express from 'express';
const router = express.Router();
// Trang chủ
router.get('/', (req, res) => {
res.send('Chào mừng đến với MiniBlog!');
});
export default router;
import express from 'express';
import posts from '../data/posts.js';
const router = express.Router();
// GET /posts: danh sách bài viết
router.get('/', (req, res) => {
res.json(posts);
});
// GET /posts/:slug: chi tiết bài viết
router.get('/:slug', (req, res) => {
const post = posts.find((item) => item.slug === req.params.slug);
if (!post) {
return res.status(404).send('Không tìm thấy bài viết');
}
res.json(post);
});
export default router;
Đường dẫn import dữ liệu giờ là ../data/posts.js vì file nằm trong routes. File app.js chỉ còn nhiệm vụ mount các router:
- app.js
import express from 'express';
import pagesRouter from './routes/pages.js';
import postsRouter from './routes/posts.js';
const app = express();
app.use('/', pagesRouter);
app.use('/posts', postsRouter);
export default app;
Cấu trúc project lúc này (server.js và data/posts.js giữ nguyên):
miniblog/
├── data/
│ └── posts.js
├── routes/
│ ├── pages.js
│ └── posts.js
├── app.js
├── server.js
└── ...
Chạy npm run dev và kiểm tra, kết quả giống hệt bài trước vì chúng ta chỉ sắp xếp lại code:
curl http://localhost:3000/
# Chào mừng đến với MiniBlog!
curl http://localhost:3000/posts/route-trong-express-5
# {"id":2,"title":"Route trong Express 5","slug":"route-trong-express-5","content":"Route trong Express..."}
curl -i http://localhost:3000/posts/khong-ton-tai
# HTTP/1.1 404 Not Found
# ...
# Không tìm thấy bài viết
Code đầy đủ của MiniBlog sau bài này nằm ở tag bai-04 trên GitHub; các thay đổi của riêng bài này: so sánh bai-03...bai-04.
5. Lời kết.
Như vậy là chúng ta đã tìm hiểu xong router và tổ chức route trong Express: tạo router bằng express.Router(), mount với prefix, mergeParams, router-level middleware và tách route ra file theo tính năng. Bài sau mình sẽ giới thiệu với mọi người về request và response trong Express, để lấy dữ liệu từ request và trả về đúng kiểu response.
Đăng ký nhận tin.
Chúng tôi chỉ gửi tối đa 2 lần trên 1 tháng. Tuyên bố không spam mail!





0 Comments