ObjectId로 찾기

Coddy Node.js 여정의 MongoDB 데이터베이스 섹션에 포함된 레슨. 29개 중 7번째.

책 하나에 답하려면 서버가 _id로 책을 조회하지만, URL에 담긴 ID는 텍스트로 전달됩니다.

MongoDB가 만드는 _id는 ObjectId입니다. 12바이트 값으로, 24개의 16진수 문자, 즉 숫자 0부터 9와 문자 a부터 f로 표기합니다. 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을 반환합니다.

챌린지

쉬움

이 단계에서는 문서 삽입에서 작업한 프로젝트 파일(server.js 포함)이 아니라, 과정에 미리 준비된 책장 API 프로젝트를 엽니다. 이전 작업은 해당 강의에 그대로 남아 있습니다. server.js를 수정하기 전에 제공된 파일을 읽어 보세요. 이 사본에는 책 목록 및 삽입 경로가 들어 있습니다.

클라이언트가 _id로 지정한 책 한 권을 요청합니다.

server.js에 GET /books/:id 경로를 추가하세요.
URL의 id는 텍스트입니다. 어떤 텍스트는 절대 ObjectId가 될 수 없으며, ObjectId는 숫자와 a부터 f까지의 문자로 이루어진 24자입니다. 해당 텍스트에 대해서는 sendError를 사용해 상태 코드 400과 오류를 응답하세요. 예: { "error": "Not a valid id" }. 잘못된 텍스트로 ObjectId를 만들면 오류가 발생하므로, ObjectId를 만들기 전에 이를 확인하세요.
그렇지 않으면 _id로 책을 조회하세요. 책을 찾으면 상태 코드 200과 책을 응답하세요: { "_id": "6720a1f4c2b9e81d3a5f0c11", "title": "Dune", "author": "Frank Herbert", "year": 1965, "isbn": "9780441013593", "genre": "scifi" }.
해당 _id를 가진 책이 없으면 상태 코드 404와 오류를 응답하세요. 예: { "error": "No such book" }. 직접 해 보세요: GET /books를 보내고 Dune의 _id를 복사하세요. "_id": 뒤에 오는 24자입니다. 실행할 때마다 책에 새로운 id가 할당되므로, 실행할 때마다 다시 복사하세요. 복사한 id를 뒤에 붙여 GET /books/를 보내면 200과 Dune이 반환됩니다. GET /books/42를 보내면 400이 반환됩니다. GET /books/000000000000000000000000를 보내면 유효한 id이지만 해당 id를 가진 책이 없으므로 404가 반환됩니다.

직접 해보기

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

실력 점검

이 레슨에는 짧은 퀴즈가 포함되어 있습니다. 레슨을 시작해 문제를 풀고 진행 상황을 기록하세요.

직접 연습해 보세요: Express 플레이그라운드

ObjectId로 찾기

MongoDB 데이터베이스의 모든 레슨