クエリフィルター
CoddyのNode.jsジャーニー「MongoDBによるデータベース」セクションの一部。レッスン 9/29。
クライアントは特定の本だけを求めることが多く、データベースに選ばせることができます。
findに渡すオブジェクトはフィルターです。フィルター内のすべてのフィールドが一致すると、ドキュメントが一致します。通常の値は等しいことを意味します。演算子は$で始まるキーで、代わりに比較を行います。$gteは以上、$lteは以下を意味します。同じフィールドに対する2つの演算子は1つのオブジェクトにまとめます。{ total: { $gte: 20, $lte: 50 } }は、合計が20から50までのものを残します。
// 20以上の支払い済み注文
await orders.find({ status: 'paid', total: { $gte: 20 } }).toArray();型も重要です。{ $gte: '20' }は文字列を比較し、MongoDBは文字列を数値フィールドと照合することはありません。req.query内の値はすべて文字列なので、フィルターに渡す前にNumber()を使って数値に変換してください。
チャレンジ
簡単このステップでは、Finding by ObjectIdのプロジェクトファイル（server.jsを含む）ではなく、このコース用に用意された書棚APIプロジェクトを開きます。以前の作業は、以前のレッスンにそのまま残っています。server.jsを編集する前に、提供されたファイルを読んでください。このコピーには、書籍の挿入処理とObjectIdによる検索ルートが含まれています。
クライアントが必要としているのは、一部の書籍だけです。たとえば、ある著者の本や、特定の年の本です。データベースに選ばせましょう。
server.jsで、GET /booksを変更します。クエリ文字列からフィルターオブジェクトを作成し、findに渡します。このルートは、これまでどおり書籍のJSON配列を返します。?author=Jane%20Austenは、authorがJane Austenと完全に一致する書籍だけを返します。（%20は、URLで空白を表す方法です。）?from=1960は、yearが1960以降の書籍を返します。?to=1980は、1980以前の書籍を返します。両方を指定すると、書籍は2つの年の間に含まれている必要があり、両端の年も含まれます。どちらか一方だけでも指定できます。- クエリの値は常に文字列として届きますが、保存されている年は数値です。フィルターに渡す前に
fromとtoを数値に変換してください。そうしないと、何も一致しません。 - クエリがない場合、ルートは以前と同じようにすべての書籍を返します。試してみましょう：
GET /books?from=1960&to=1980を送ると、Dune（1965）とKindred（1979）が返ります。GET /books?from=1970を送ると、Kindredだけが返ります。GET /books?to=1900を送ると、Emma（1815）だけが返ります。GET /books?author=Jane%20Austenを送ると、Emmaだけが返ります。GET /booksを送ると、3冊すべてが返ります。
自分で試してみよう
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');
});
MongoDBによるデータベースのすべてのレッスン
自分で練習してみよう: Expressプレイグラウンド