Фильтры запросов
Часть раздела Базы данных с MongoDB путешествия по Node.js на Coddy. Урок 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возвращает книги, выпущенные в 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');
});
Все уроки раздела Базы данных с MongoDB
Потренируйтесь самостоятельно: Песочница Express