Вставка документов
Часть раздела Базы данных с MongoDB путешествия по Node.js на Coddy. Урок 5 из 29.
Клиент отправляет новую книгу в теле POST-запроса, а сервер должен сохранить её и сообщить, что именно он сохранил.
У каждого документа есть поле _id — его уникальный ключ в коллекции. Если у объекта, который вы вставляете, такого поля нет, insertOne создаёт его и записывает в тот же объект. Вызов возвращает только acknowledged и insertedId, но не сам документ. insertedId — это ObjectId, тип идентификатора, который создаёт MongoDB. Поиск по ObjectId поможет разобраться.
const movie = { title: 'Alien', year: 1979 };
const result = await movies.insertOne(movie);
console.log(result); // { acknowledged: true, insertedId: new ObjectId('66f1...') }
console.log(movie._id); // тот же idЗначит, после вставки переданный вами объект и есть сохранённый документ, включая _id: именно его клиент хочет получить в ответ.
В начальном коде с помощью insertMany добавляются три книги; этот метод принимает массив документов. insertOne принимает один документ. Оба метода выполняют асинхронную запись.
Задание
ЛегкоТеперь клиенты могут добавлять книги. Сохраните книгу, которую отправляет клиент, и отправьте её обратно с новым идентификатором.
- В
server.js, нижеGET /books, добавьте маршрутPOST /books. - Он сохраняет тело JSON как новый документ в коллекции
books. - Он отвечает со статусом 201 и книгой в том виде, в котором она была сохранена, включая созданный MongoDB идентификатор
_id. Для тела запроса в разделе «Попробуйте» ответ будет таким:Ваш{ "title": "Beloved", "author": "Toni Morrison", "year": 1987, "isbn": "9781400033416", "genre": "literary", "_id": "6720a1f4c2b9e81d3a5f0c14" }_idбудет другим. Порядок полей не имеет значения. Попробуйте: отправьтеPOST /booksс таким телом:{ "title": "Beloved", "author": "Toni Morrison", "year": 1987, "isbn": "9781400033416", "genre": "literary" }. Вы получите ответ со статусом 201 и книгу с идентификатором_id. ОтправьтеGET /books: вы получите четыре книги, последней будет Beloved. На вкладке «Данные» показаны четыре документа вbooks. Нажмите «Запустить» ещё раз, и Beloved исчезнет. При каждом нажатии «Запустить» начинается работа с пустой базой данных, и стартовый код снова сохраняет те же три книги.
Попробуйте сами
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.listen(3000, () => {
console.log('Bookshelf is running on port 3000');
});
Все уроки раздела Базы данных с MongoDB
Потренируйтесь самостоятельно: Песочница Express