Toidicode.com

Toidicode.com

BASIC TO ADVANCE

Bài 21: Phân trang, tìm kiếm và lọc trong Express

Ở bài trước API của MiniBlog đã có JWT, nhưng trang chủ và GET /api/v1/posts vẫn trả về mọi bài viết một lần. 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ề phân trang, tìm kiếm và lọc trong Express.

1. Phân trang với LIMIT và OFFSET.

LIMIT giới hạn số bản ghi trả về, OFFSET bỏ qua một số bản ghi đầu. Trang page, mỗi trang limit bài thì offset = (page - 1) * limit:

-- Trang 2, mỗi trang 10 bài: bỏ qua 10 bài đầu
SELECT id, title, slug FROM posts ORDER BY id DESC LIMIT 10 OFFSET 10;
-- Tổng số bài, số trang = CEIL(total / 10)
SELECT COUNT(*) AS total FROM posts;

Luôn kèm ORDER BY, không thì thứ tự không cố định, một bài có thể hiện ở hai trang. Để thử, các bạn thêm 23 bài mẫu (bài số chẵn thuộc tài khoản [email protected] của Bài 16):

docker exec -i miniblog-mysql mysql -u miniblog -psecret --default-character-set=utf8mb4 miniblog <<'SQL'
INSERT INTO posts (title, slug, content, author_id, published_at)
WITH RECURSIVE seq (n) AS (SELECT 3 UNION ALL SELECT n + 1 FROM seq WHERE n < 25)
SELECT CONCAT('Bài viết mẫu số ', n), CONCAT('bai-viet-mau-so-', n),
    CONCAT('Nội dung mẫu số ', n, ' để thử phân trang và tìm kiếm.'),
    IF(n % 2 = 0, (SELECT id FROM users WHERE email = '[email protected]'), NULL), NOW()
FROM seq;
SQL

Thử xong cả bài, chạy npm run db:seed để về lại 2 bài ban đầu.

2. Đọc tham số từ query string.

Trang, từ khoá và bộ lọc nằm trên URL, VD: /?q=express&page=2. Giá trị trong req.query (Bài 5) là chuỗi hoặc mảng, người dùng gõ gì cũng được, nên phải kiểm tra trước khi dùng:

- lib/pagination.js

// Đọc số nguyên dương từ query string, không hợp lệ thì trả về fallback
function toPositiveInt(value, fallback) {
    const number = Number(value);
    return Number.isSafeInteger(number) && number > 0 ? number : fallback;
}

// Đọc page, limit, từ khoá q và tác giả author từ req.query.
// Có maxPerPage thì client chọn được limit (tối đa maxPerPage), không thì luôn là perPage.
export function parseListQuery(query, { perPage = 10, maxPerPage = null } = {}) {
    const page = toPositiveInt(query.page, 1);
    const limit = maxPerPage ? Math.min(toPositiveInt(query.limit, perPage), maxPerPage) : perPage;
    const search = typeof query.q === 'string' ? query.q.trim().slice(0, 100) : '';
    const authorId = toPositiveInt(query.author, null);
    return { filters: { search, authorId }, page, limit, offset: (page - 1) * limit };
}

// Thông tin phân trang gửi kèm danh sách
export function paginationMeta({ page, limit }, total) {
    return { page, perPage: limit, total, totalPages: Math.ceil(total / limit) };
}

Trong đó:

  • toPositiveInt() chỉ nhận số nguyên dương: page=abc hay page=2&page=3 đều thành trang 1.
  • maxPerPage chặn limit=1000000, không cho đọc cả bảng. Trang web không truyền nên luôn là 10.

3. Tìm kiếm với LIKE và lọc theo tác giả.

- models/post.js (findAll() được thay bằng đoạn này)

// Escape %, _ và \ trong từ khoá để LIKE coi chúng là ký tự thường
function escapeLike(text) {
    return text.replace(/[\\%_]/g, '\\$&');
}

// Ghép điều kiện WHERE từ bộ lọc, giá trị luôn đi qua dấu ?
function buildWhere({ search, authorId }) {
    const conditions = [];
    const values = [];
    if (search) {
        const pattern = `%${escapeLike(search)}%`;
        conditions.push('(title LIKE ? OR content LIKE ?)');
        values.push(pattern, pattern);
    }
    if (authorId) {
        conditions.push('author_id = ?');
        values.push(authorId);
    }
    return { where: conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '', values };
}

// Một trang bài viết khớp bộ lọc, kèm tổng số bài khớp
export async function paginate(filters, { limit, offset }) {
    const { where, values } = buildWhere(filters);
    // LIMIT/OFFSET dạng chuỗi để page cực lớn (offset vượt 2^53) không làm MySQL báo lỗi
    const [rows] = await pool.execute(
        `SELECT id, title, slug FROM posts ${where} ORDER BY id DESC LIMIT ? OFFSET ?`,
        [...values, String(limit), String(offset)],
    );
    const [[{ total }]] = await pool.execute(`SELECT COUNT(*) AS total FROM posts ${where}`, values);
    return { rows, total };
}

WHERE chỉ ghép từ các đoạn SQL cố định, giá trị người dùng nhập luôn đi qua dấu ? (Bài 12) nên không bị SQL injection.

LIKE còn có hai ký tự đại diện: % (chuỗi bất kỳ) và _ (một ký tự bất kỳ). Không escape thì tìm _ khớp mọi bài, tìm 100% khớp cả "1000 bài". escapeLike() thêm \ (ký tự escape mặc định của LIKE) trước chúng và trước chính \.

Collation mặc định của MySQL 8.4 là utf8mb4_0900_ai_ci (không phân biệt dấu, hoa thường), nên tìm tinh nang vẫn ra bài có chữ "tính năng".

4. FULLTEXT và tiếng Việt.

Mẫu LIKE bắt đầu bằng % không dùng được index, MySQL phải duyệt cả bảng. Dữ liệu lớn thì dùng FULLTEXT index: tách nội dung thành từ, tìm bằng MATCH ... AGAINST. Index phải thêm bằng migration (Bài 14):

-- Chỉ để tham khảo: database/migrations/003-add-posts-fulltext.sql
ALTER TABLE posts ADD FULLTEXT INDEX posts_fulltext (title, content);

-- Điều kiện thay cho LIKE, từ khoá vẫn truyền qua dấu ?
SELECT COUNT(*) FROM posts WHERE MATCH(title, content) AGAINST ('express' IN BOOLEAN MODE);
-- 2
SELECT COUNT(*) FROM posts WHERE MATCH(title, content) AGAINST ('số' IN BOOLEAN MODE);
-- 0

23 bài mẫu có chữ "số" mà kết quả là 0: InnoDB bỏ qua từ ngắn hơn innodb_ft_min_token_size (mặc định 3 ký tự), tiếng Việt lại nhiều từ 1–2 ký tự như "số", "về", "mã". Khắc phục bằng cách hạ biến này rồi tạo lại index, hoặc dùng parser ngram (xem thêm tại đây). Vì vậy MiniBlog không thêm migration này mà giữ LIKE.

5. Meta phân trang cho trang web và API.

- services/post-service.js (đoạn thay đổi)

import { paginationMeta } from '../lib/pagination.js';

// Một trang bài viết theo bộ lọc, kèm meta phân trang
export async function listPosts({ filters, page, limit, offset }) {
    const { rows, total } = await Post.paginate(filters, { limit, offset });
    return { posts: rows, meta: paginationMeta({ page, limit }, total) };
}

API đặt meta cạnh data như đã hẹn ở Bài 19, client chọn được limit tối đa 50:

- controllers/api/post-controller.js (đoạn thay đổi)

import { parseListQuery } from '../../lib/pagination.js';

// GET /api/v1/posts?q=...&author=...&page=...&limit=...
export async function index(req, res) {
    const query = parseListQuery(req.query, { perPage: 10, maxPerPage: 50 });
    const { posts, meta } = await postService.listPosts(query);
    res.json({ data: posts, meta });
}

Trang chủ có thêm link trang trước/sau:

- controllers/page-controller.js (hàm about giữ nguyên)

import * as postService from '../services/post-service.js';
import { parseListQuery } from '../lib/pagination.js';

// URL tới trang khác, giữ nguyên từ khoá và bộ lọc
function pageUrl({ search, authorId }, page) {
    const params = new URLSearchParams();
    if (search) params.set('q', search);
    if (authorId) params.set('author', authorId);
    params.set('page', page);
    return `/?${params}`;
}

// Trang chủ: 10 bài mỗi trang, VD: /?q=express&page=2
export async function home(req, res) {
    const query = parseListQuery(req.query);
    const { posts, meta } = await postService.listPosts(query);
    res.render('index', {
        title: 'Bài viết mới',
        posts,
        meta,
        search: query.filters.search,
        prevUrl: meta.page > 1 ? pageUrl(query.filters, meta.page - 1) : null,
        nextUrl: meta.page < meta.totalPages ? pageUrl(query.filters, meta.page + 1) : null,
    });
}

View có thêm form tìm kiếm, câu báo không tìm thấy và thanh phân trang:

- views/index.ejs (đoạn thay đổi)

<form method="get" action="/">
    <input type="search" name="q" value="<%= search %>" placeholder="Tìm bài viết...">
    <button type="submit">Tìm</button>
</form>
<% if (posts.length === 0) { %>
<p><%= search ? 'Không tìm thấy bài viết nào.' : 'Chưa có bài viết nào.' %></p>
<% } else { %>
<%# ... vòng lặp posts.forEach như cũ ... %>
<% } %>
<% if (meta.totalPages > 1) { %>
<nav class="pagination">
    <% if (prevUrl) { %><a href="<%= prevUrl %>">&laquo; Trang trước</a><% } %>
    <span>Trang <%= meta.page %>/<%= meta.totalPages %></span>
    <% if (nextUrl) { %><a href="<%= nextUrl %>">Trang sau &raquo;</a><% } %>
</nav>
<% } %>

Form GET để từ khoá nằm trên URL và không cần CSRF token; <%= %> escape từ khoá khi in lại vào ô input. Cuối public/css/style.css mình thêm .pagination { display: flex; gap: 12px; }.

Chạy npm run dev rồi thử:

curl -s 'http://localhost:3000/api/v1/posts?author=1&page=2&limit=2'
# {"data":[{"id":20,"title":"Bài viết mẫu số 20","slug":"bai-viet-mau-so-20"},{"id":18,"title":"Bài viết mẫu số 18","slug":"bai-viet-mau-so-18"}],"meta":{"page":2,"perPage":2,"total":11,"totalPages":6}}
curl -s 'http://localhost:3000/api/v1/posts?q=_'
# {"data":[],"meta":{"page":1,"perPage":10,"total":0,"totalPages":0}}

Lệnh đầu lấy trang 2 trong 11 bài của user 1, lệnh sau ra 0 bài nhờ escape. Trên trình duyệt, /?q=bài viết&page=2 hiện "Trang 2/3", link trước/sau giữ q.

Code đầy đủ của MiniBlog sau bài này nằm ở tag bai-21 trên GitHub; các thay đổi của riêng bài này: so sánh bai-20...bai-21.

6. Lời kết.

Như vậy là chúng ta đã làm xong phân trang, tìm kiếm và lọc trong Express: LIMIT/OFFSET, đọc tham số query, tìm bằng LIKE có escape, FULLTEXT với tiếng Việt và meta phân trang. Bài sau mình sẽ giới thiệu với mọi người về gửi mail trong Express để báo cho tác giả khi bài viết có bình luận mới.

Đă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!

Vũ Thanh Tài

About author
The best way to learn is to share
Xem tất cả bài đăng

0 Comments

Bài viết chưa có ai bình luận, hãy là người đầu tiên đi bạn!

Bình luận

Captcha