查询筛选条件

本课属于 Coddy Node.js 学习旅程的“使用 MongoDB 的数据库”单元。第 9 课，共 29 课。

客户端通常只需要一些书，数据库可以负责筛选。

你传给 find 的对象是一个筛选器：筛选器中的每个字段都匹配时，文档才会匹配。普通值表示相等。运算符是以 $ 开头、用于比较的键：$gte 表示大于或等于，$lte 表示小于或等于。同一字段上的两个运算符共用一个对象：{ total: { $gte: 20, $lte: 50 } } 会保留总额在 20 到 50 之间的记录。

// 金额不低于 20 的已付款订单
await orders.find({ status: 'paid', total: { $gte: 20 } }).toArray();

数据类型也很重要：{ $gte: '20' } 比较的是字符串，而 MongoDB 永远不会将字符串与数字字段匹配。req.query 中的所有内容都是字符串，因此要先用 Number() 将数字字符串转换为数字，再将它们放入筛选器。

挑战

简单

这一步会打开课程中准备好的书架 API 项目，而不是你在按 ObjectId 查找中编写的项目文件（包括 server.js）。之前的工作仍在单独的课中。编辑 server.js 前，先阅读提供的文件。这份副本包含插入书籍和按 ObjectId 查找的路由。

客户端只想要部分书籍：某位作者的书，或某些年份出版的书。让数据库来筛选。

在 server.js 中修改 GET /books。根据查询字符串构建筛选对象，并将它传给 find。该路由仍会以 JSON 数组的形式返回书籍。
?author=Jane%20Austen 只会返回 author 恰好是 Jane Austen 的书籍。（%20 是 URL 中表示空格的写法。）
?from=1960 会返回 year 为 1960 或更晚的书籍。?to=1980 会返回 1980 年或更早的书籍。两者都指定时，书籍必须处于这两个年份之间，且包括这两个年份。也可以只指定其中一个。
查询值始终以字符串的形式传入，但存储的年份是数字。将 from 和 to 转换为数字后再放入筛选对象，否则不会匹配到任何结果。
没有查询参数时，路由会像之前一样返回所有书籍。试试看：发送 GET /books?from=1960&to=1980：你会得到 Dune (1965) 和 Kindred (1979)。发送 GET /books?from=1970：你只会得到 Kindred。发送 GET /books?to=1900：你只会得到 Emma (1815)。发送 GET /books?author=Jane%20Austen：你只会得到 Emma。发送 GET /books：你会得到全部三本书。

亲手试试

import express from 'express';
import { MongoClient, ObjectId } from 'mongodb';

const client = new MongoClient('mongodb://localhost:27017');
const db = client.db('shelf');
const books = db.collection('books');

await books.insertMany([
    { title: 'Dune', author: 'Frank Herbert', year: 1965, isbn: '9780441013593', genre: 'scifi' },
    { title: 'Kindred', author: 'Octavia E. Butler', year: 1979, isbn: '9780807083697', genre: 'scifi' },
    { title: 'Emma', author: 'Jane Austen', year: 1815, isbn: '9780141439587', genre: 'classic' },
]);

const app = express();
app.use(express.json());

// 所有错误都返回 { error: message }。
function sendError(res, status, message) {
    res.status(status).json({ error: message });
}

app.get('/', (req, res) => {
    res.send('Bookshelf API');
});

app.get('/books', async (req, res) => {
    const list = await books.find().toArray();
    res.json(list);
});

app.post('/books', async (req, res) => {
    const book = req.body;
    await books.insertOne(book);
    res.status(201).json(book);
});

app.get('/books/:id', async (req, res) => {
    if (!ObjectId.isValid(req.params.id)) {
        return sendError(res, 400, 'Not a valid id');
    }
    const book = await books.findOne({ _id: new ObjectId(req.params.id) });
    if (!book) {
        return sendError(res, 404, 'No such book');
    }
    res.json(book);
});

app.listen(3000, () => {
    console.log('Bookshelf is running on port 3000');
});

自己练习： Express 在线编辑器

查询筛选条件

使用 MongoDB 的数据库中的所有课