ObjectId ile Bulma

Coddy'nin Node.js Journey'sinin MongoDB ile Veritabanları bölümünün bir parçası. Ders 7 / 29.

Bir kitabı yanıtlamak için sunucu onu _id değerine göre arar, ancak id URL'ye metin olarak gelir.

MongoDB'nin oluşturduğu bir _id, 24 onaltılık karakterle yazılan 12 baytlık bir değer olan ObjectId'dir: 0'dan 9'a kadar rakamlar ve a'dan f'ye kadar harfler. JSON bunu bir dize olarak gösterir, ancak veritabanında dize değildir; bu nedenle düz metin içeren bir filtre hiçbir şeyle eşleşmez. Önce metni bir ObjectId'ye dönüştür. ObjectId.isValid, bir metnin ObjectId olup olamayacağını belirtir; çünkü new ObjectId bunun dışındaki her değer için hata verir.

import { ObjectId } from 'mongodb';

const text = '66f1c2a9e4b0a1b2c3d4e5f6';
await orders.findOne({ _id: new ObjectId(text) }); // sipariş veya null
await orders.findOne({ _id: text });               // null: text bir ObjectId değil
ObjectId.isValid('42');                            // false

findOne, eşleşen ilk belgeyi, eşleşme yoksa null değerini döndürür.

Görev

Kolay

Bu adım, Inserting Documents içindeki proje dosyaların ( server.js dâhil) yerine, kurs için hazırlanmış kitaplık API projesini açar. Önceki çalışmaların kendi dersinde kalır. server.js dosyasını düzenlemeden önce sağlanan dosyaları oku. Bu kopya, kitaplık listeleme ve ekleme rotalarını içerir.

Bir istemci, _id değeriyle seçilen tek bir kitap istiyor.

server.js içinde bir GET /books/:id rotası ekle.
URL'deki id metindir. Bazı metinler hiçbir zaman 24 rakam ve a ile f arasındaki harflerden oluşan bir ObjectId olamaz. Bu metin için, örneğin { "error": "Not a valid id" } yanıtını döndürmek üzere sendError kullanarak 400 durum kodu ve bir hata yanıtı gönder. ObjectId oluşturmadan önce bunu kontrol et; çünkü hatalı metinden ObjectId oluşturmak hata verir.
Aksi durumda, kitabı _id değerine göre bul. Bulduğunda, 200 durum koduyla kitabı yanıt olarak gönder: { "_id": "6720a1f4c2b9e81d3a5f0c11", "title": "Dune", "author": "Frank Herbert", "year": 1965, "isbn": "9780441013593", "genre": "scifi" }.
Bu _id değerine sahip kitap yoksa, örneğin { "error": "No such book" } yanıtını döndürerek 404 durum kodu ve bir hata yanıtı gönder. Şöyle dene: GET /books isteğini gönder ve Dune'un _id değerini kopyala: "_id": ifadesinden sonraki 24 karakteri. Her çalıştırma kitaplara yeni id'ler verir; bu nedenle her çalıştırmadan sonra id'yi yeniden kopyala. GET /books/ isteğini, kopyaladığın id'nin ardından gönder: 200 yanıtı ve Dune'u alırsın. GET /books/42 isteğini gönder: 400 yanıtı alırsın. GET /books/000000000000000000000000 isteğini gönder: bu, hiçbir kitabın sahip olmadığı geçerli bir id olduğundan 404 yanıtı alırsın.

Kendin dene

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

// Her hata { error: message } biçiminde yanıt verir.
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');
});

Kendini test et

Bu ders kısa bir quiz içerir. Soruları yanıtlamak ve ilerlemeni kaydetmek için derse başla.

Kendi başına pratik yap: Express playground

ObjectId ile Bulma

MongoDB ile Veritabanları bölümündeki tüm dersler