ドキュメントを挿入する
CoddyのNode.jsジャーニー「MongoDBによるデータベース」セクションの一部。レッスン 5/29。
クライアントはPOST本文で新しい本を送り、サーバーはそれを保存して、何を保存したかを返す必要があります。
すべてのドキュメントには_idフィールドがあり、これはコレクション内で一意のキーです。挿入するオブジェクトに_idがない場合、insertOneはそれを作成し、同じオブジェクトにも書き込みます。この呼び出しが返すのはacknowledgedとinsertedIdだけで、ドキュメントは返しません。insertedIdはObjectIdで、MongoDBが生成する種類のIDです。ObjectIdによる検索でその仕組みを確認できます。
const movie = { title: 'Alien', year: 1979 };
const result = await movies.insertOne(movie);
console.log(result); // { acknowledged: true, insertedId: new ObjectId('66f1...') }
console.log(movie._id); // 同じ idつまり、挿入後は、渡したオブジェクトが_idを含めて保存されたドキュメントになります。クライアントが受け取りたいのはこれです。
スターターコードではinsertManyを使って3冊の本を初期登録します。これはドキュメントの配列を受け取ります。insertOneは1つのドキュメントを受け取ります。どちらも非同期の書き込みです。
チャレンジ
簡単クライアントが書籍を追加できるようになりました。クライアントが送信した書籍を保存し、新しい ID を付けて返します。
server.jsで、GET /booksの下にPOST /booksルートを追加します。- JSON ボディを
booksコレクションの新しいドキュメントとして保存します。 - ステータス 201 と、保存された状態の書籍を返します。これには MongoDB が作成した
_idも含まれます。「試してみる」でのボディに対するレスポンスは次のとおりです。あなたの{ "title": "Beloved", "author": "Toni Morrison", "year": 1987, "isbn": "9781400033416", "genre": "literary", "_id": "6720a1f4c2b9e81d3a5f0c14" }_idは異なります。フィールドの順序は問いません。「試してみる」：このボディでPOST /booksを送信します：{ "title": "Beloved", "author": "Toni Morrison", "year": 1987, "isbn": "9781400033416", "genre": "literary" }。ステータス 201 と、_idを持つ書籍が返されます。GET /booksを送信すると、4 冊の書籍が返され、最後に Beloved が表示されます。「データ」タブには、books内の4件のドキュメントが表示されます。もう一度「実行」を押すと、Beloved はなくなります。「実行」のたびにデータベースは空の状態から始まり、スターターが同じ3冊の書籍を再び保存します。
自分で試してみよう
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.listen(3000, () => {
console.log('Bookshelf is running on port 3000');
});
MongoDBによるデータベースのすべてのレッスン
自分で練習してみよう: Expressプレイグラウンド