Insertion de documents

Fait partie de la section Bases de données avec MongoDB du Journey Node.js de Coddy. Leçon 2 sur 18.

Un client envoie un nouveau livre dans le corps d’une requête POST, et le serveur doit le stocker et indiquer ce qu’il a stocké.

Chaque document possède un champ _id, sa clé unique dans la collection. Lorsque l’objet que vous insérez n’en a pas, insertOne en crée un et l’ajoute également à cet objet. L’appel ne renvoie que acknowledged et insertedId, jamais le document lui-même.

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); // le même id

Ainsi, après l’insertion, l’objet que vous avez transmis est le document stocké, _id compris : c’est ce que le client veut récupérer.

Défi

Facile

POST /books enregistre le corps JSON comme nouveau livre.
Il répond avec le statut 201 et le livre enregistré, avec son _id.

Envoyez POST /books avec { "title": "Beloved", "author": "Toni Morrison", "year": 1987, "isbn": "9781400033416", "genre": "literary" }. Envoyez ensuite GET /books et consultez l’onglet Data.

Essayez vous-même

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

// Chaque erreur renvoie { 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');
});