Поиск по ObjectId

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

Чтобы найти одну книгу, сервер ищет её по _id, но идентификатор поступает из URL в виде текста.

Создаваемый MongoDB _id — это ObjectId: значение длиной 12 байт, записываемое в виде 24 шестнадцатеричных символов: цифр от 0 до 9 и букв от a до f. В JSON он отображается как строка, но в базе данных это не строка, поэтому фильтр с обычным текстом ничего не находит. Сначала преобразуй текст в ObjectId. ObjectId.isValid сообщает, может ли текст быть ObjectId, потому что new ObjectId выдаёт ошибку для любого другого значения.

import { ObjectId } from 'mongodb';

const text = '66f1c2a9e4b0a1b2c3d4e5f6';
await orders.findOne({ _id: new ObjectId(text) }); // заказ или null
await orders.findOne({ _id: text });               // null: text не является ObjectId
ObjectId.isValid('42');                            // false

findOne возвращает первый подходящий документ или null, если подходящего документа нет.

Задание

Легко

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

Клиенту нужна одна книга, выбранная по её _id.

В server.js добавь маршрут GET /books/:id.
Идентификатор в URL — это текст. Некоторые строки не могут быть ObjectId: он состоит из 24 символов — цифр и букв от a до f. Для такого текста ответь со статусом 400 и сообщением об ошибке, используя sendError, например { "error": "Not a valid id" }. Выполни эту проверку до создания ObjectId, потому что попытка создать его из некорректного текста приведёт к ошибке.
В противном случае найди книгу по её _id. Если книга найдена, ответь со статусом 200 и верни книгу: { "_id": "6720a1f4c2b9e81d3a5f0c11", "title": "Dune", "author": "Frank Herbert", "year": 1965, "isbn": "9780441013593", "genre": "scifi" }.
Если книги с таким _id нет, ответь со статусом 404 и сообщением об ошибке, например { "error": "No such book" }. Проверь: отправь GET /books и скопируй _id книги Dune: 24 символа после "_id":. При каждом нажатии «Запустить» книги получают новые идентификаторы, поэтому копируй его заново после каждого запуска. Отправь GET /books/, добавив скопированный идентификатор: ты получишь ответ 200 и книгу Dune. Отправь GET /books/42: ты получишь ответ 400. Отправь GET /books/000000000000000000000000: это допустимый идентификатор, которого нет ни у одной книги, поэтому ты получишь ответ 404.

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

import express from 'express';
import { MongoClient } 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.listen(3000, () => {
    console.log('Bookshelf is running on port 3000');
});