تحديث المستندات

جزء من قسم قواعد البيانات باستخدام MongoDB في رحلة Node.js على Coddy. الدرس 6 من 18.

يجب أن يؤدي تصحيح سنة الكتاب إلى تغيير هذا الحقل وحده وترك الحقول الأخرى كما هي.

تغيّر updateOne(filter, update) المستند الأول الذي يطابقه عامل التصفية. يتكوّن التحديث من عوامل: يكتب $set الحقول التي تحددها ويُبقي كل الحقول الأخرى. يُرفض الكائن العادي الذي لا يتضمن أي عامل بالرسالة "Update document requires atomic operators".

const result = await players.updateOne(
    { name: 'Ada' },
    { $set: { score: 120, level: 4 } }
);
result.matchedCount;  // 1 إذا وُجد لاعب مطابق، و0 إذا لم يوجد أي لاعب مطابق
result.modifiedCount; // 0 عندما تكون القيم متطابقة بالفعل

ميّز بين المستند المفقود والمستند الذي لم يتغير باستخدام matchedCount، وليس modifiedCount. لا يُرجع التحديث المستند، لذا اقرأه مجددًا باستخدام findOne.

التحدي

سهل

يغيّر PATCH /books/:id الحقول الموجودة في المتن فقط، ويستجيب بالكتاب المحدّث مع 200.
يستجيب بمعرّف 404 إذا كان غير معروف. وتستجيب parseId في الشيفرة الابتدائية بالفعل بالرمز 400 إذا كان المعرّف غير صالح.

أرسل PATCH /books/<id> مع { "year": 1966 } وراقب الكتاب في علامة التبويب «البيانات».

جرّب بنفسك

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

// تُرجع :id بوصفه ObjectId، أو null بعد إرسال الاستجابة 400 إذا كان المعرّف غير صالح.
function parseId(req, res) {
    if (ObjectId.isValid(req.params.id)) {
        return new ObjectId(req.params.id);
    }
    sendError(res, 400, 'Not a valid id');
    return null;
}

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/newest', async (req, res) => {
    const n = Number(req.query.n) || 3;
    const list = await books
        .find({}, { projection: { title: 1, year: 1, _id: 0 } })
        .sort({ year: -1 })
        .limit(n)
        .toArray();
    res.json(list);
});

app.get('/books/:id', async (req, res) => {
    const id = parseId(req, res);
    if (!id) return;
    const book = await books.findOne({ _id: id });
    if (!book) {
        return sendError(res, 404, 'No such book');
    }
    res.json(book);
});

// أضف PATCH /books/:id هنا.

app.listen(3000, () => {
    console.log('Bookshelf is running on port 3000');
});