Inserindo documentos

Parte da seção Bancos de dados com MongoDB do Journey de Node.js da Coddy. Lição 2 de 18.

Um cliente envia um livro novo no corpo de uma requisição POST, e o servidor precisa armazená-lo e informar o que armazenou.

Todo documento tem um campo _id, sua chave exclusiva na coleção. Quando o objeto que você insere não tem um, insertOne cria um e também o grava nesse mesmo objeto. A chamada retorna apenas acknowledged e insertedId, nunca o documento em si.

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); // o mesmo id

Então, depois da inserção, o objeto que você passou é o documento armazenado, incluindo _id: é isso que um cliente quer receber de volta.

Desafio

Fácil

POST /books armazena o corpo JSON como um novo livro.
Ele responde com 201 e o livro armazenado, incluindo seu _id.

Envie POST /books com { "title": "Beloved", "author": "Toni Morrison", "year": 1987, "isbn": "9781400033416", "genre": "literary" }. Em seguida, envie GET /books e confira a aba Data.

Experimente você mesmo

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());

// Todo erro retorna { 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');
});