ObjectIdによる検索

CoddyのNode.jsジャーニー「MongoDBによるデータベース」セクションの一部。レッスン 3/18。

1冊の本を返すには、サーバーは_idで検索しますが、IDはURL内でテキストとして届きます。

MongoDBが作成する_idはObjectIdです。これは24個の16進数文字で表される12バイトの値です。JSONでは文字列として表示されますが、データベース内では文字列ではないため、プレーンテキストを使ったフィルターでは何も一致しません。まずテキストをObjectIdに変換します。ObjectId.isValidは、テキストをObjectIdにできるかどうかを判定します。そうでない値を渡すとnew ObjectIdが例外をスローするためです。

import { ObjectId } from 'mongodb';

const text = '66f1c2a9e4b0a1b2c3d4e5f6';
await orders.findOne({ _id: new ObjectId(text) }); // 注文、または null
await orders.findOne({ _id: text });               // null: text は ObjectId ではない
ObjectId.isValid('42');                            // false

findOneは最初に一致したドキュメントを返し、一致するものがない場合はnullを返します。

チャレンジ

簡単

GET /books/:id は、その _id を持つ本を返します。
ObjectId として無効な ID の場合は 400 を返します。
有効な ID に対応する本がない場合は 404 を返します。

GET /books から _id をコピーして、GET /books/<id> を送信します。次に GET /books/42 を送信します。

自分で試してみよう

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