クエリフィルター

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

クライアントが必要とするのは一部の書籍だけであることがよくあります。その選別はデータベースに任せられます。

find に渡すオブジェクトはフィルターです。フィルター内のすべてのフィールドが一致すると、ドキュメントが一致します。通常の値は等しいことを意味します。演算子とは、$ で始まり、代わりに比較を行うキーです。$gte は以上、$lte は以下を意味します。

// 20以上の支払い済み注文
await orders.find({ status: 'paid', total: { $gte: 20 } }).toArray();

型も重要です。{ $gte: '20' } は文字列を比較するため、MongoDBが文字列と数値フィールドを照合することはありません。req.query 内の値はすべて文字列なので、フィルターに渡す前に Number() を使って数値に変換してください。

チャレンジ

簡単

GET /booksはクエリで絞り込みます。

?author=を指定すると、その著者の本だけが表示されます。
?from=と?to=を指定すると、両端を含むその年に出版された本が表示されます。どちらか一方だけでも指定できます。
クエリを指定しない場合は、すべての本が表示されます。

GET /books?from=1960&to=1980を送り、次にGET /books?from=1970を送ります。

自分で試してみよう

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

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.get('/books/:id', async (req, res) => {
    if (!ObjectId.isValid(req.params.id)) {
        return sendError(res, 400, 'Not a valid id');
    }
    const book = await books.findOne({ _id: new ObjectId(req.params.id) });
    if (!book) {
        return sendError(res, 404, 'No such book');
    }
    res.json(book);
});

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