Проекция, сортировка и лимит

Часть раздела Базы данных с MongoDB путешествия по Node.js на Coddy. Урок 13 из 29.

Для списка «самых новых книг» нужны некоторые поля из нескольких книг, упорядоченные определённым образом.

Проекция выбирает поля, которые возвращает запрос: 1 оставляет поле, а _id включается, если задать ему значение 0. Для курсора sort({ field: -1 }) задаёт сортировку от большего к меньшему (значение 1 — от меньшего к большему), а limit(n) оставляет первые n результатов.

// 5 самых высоких результатов, только name и score
await players
    .find({}, { projection: { name: 1, score: 1, _id: 0 } })
    .sort({ score: -1 })
    .limit(5)
    .toArray();

База данных выполняет сортировку до ограничения количества результатов, независимо от порядка вызова этих двух методов. Если отсортировать массив в JavaScript после limit, будут отсортированы не те пять результатов.

Задание

Легко

На этом шаге открывается подготовленный для курса проект API книжной полки, а не файлы вашего проекта из урока Фильтры запросов (включая server.js). Ваша предыдущая работа остаётся в своём уроке. Прежде чем редактировать server.js, прочитайте предоставленные файлы. В этой копии содержатся маршруты книжной полки и фильтр диапазона годов.

Главная страница показывает самые новые книги, указывая только их название и год.

В server.js добавьте маршрут GET /books/newest. Разместите его выше GET /books/:id. Express проверяет маршруты по порядку, и /books/:id также соответствует /books/newest. В этом случае newest будет воспринято как идентификатор, и сервер ответит кодом 400.
Маршрут возвращает книги, отсортированные по year — сначала самые новые.
Параметр ?n= указывает, сколько книг нужно вернуть. Если n не задан, верните 3.
Каждая книга содержит только title и year, без _id и любых других полей. Пусть запрос выберет поля, отсортирует книги и сократит список. Для книг из стартового набора данных запрос GET /books/newest?n=2 возвращает:
```
[ { "title": "Kindred", "year": 1979 }, { "title": "Dune", "year": 1965 } ]
```
Попробуйте: отправьте запрос GET /books/newest. В ответ вы получите Kindred (1979), Dune (1965) и Emma (1815) именно в таком порядке; у каждой книги будут только название и год. Отправьте запрос GET /books/newest?n=1: вы получите [ { "title": "Kindred", "year": 1979 } ]. Если вы получили код 400, значит запрос обработал маршрут GET /books/:id, поэтому переместите свой маршрут выше него.

Попробуйте сами

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 filter = {};
    if (req.query.author) {
        filter.author = req.query.author;
    }
    if (req.query.from || req.query.to) {
        filter.year = {};
        if (req.query.from) {
            filter.year.$gte = Number(req.query.from);
        }
        if (req.query.to) {
            filter.year.$lte = Number(req.query.to);
        }
    }
    const list = await books.find(filter).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');
});