RESTful API 설계와 구현

const express = require('express');
const app = express();
const port = process.env.PORT || 3000;

// JSON 요청 본문을 파싱하기 위한 미들웨어
app.use(express.json());

// 임시 데이터 (데이터베이스 대신 메모리에서 관리)
let users = [
    { id: 1, name: 'Alice', email: 'alice@example.com' },
    { id: 2, name: 'Bob', email: 'bob@example.com' },
];
let nextUserId = 3; // 다음 사용자 ID를 위한 변수

// --- RESTful API 라우트 정의 ---

// 1. 모든 사용자 조회 (GET /api/users)
app.get('/api/users', (req, res) => {
    res.json(users); // users 배열을 JSON 형태로 응답
});

// 2. 특정 사용자 조회 (GET /api/users/:id)
// ':id'는 URL 파라미터로, req.params.id로 접근 가능
app.get('/api/users/:id', (req, res) => {
    const id = parseInt(req.params.id); // URL 파라미터는 문자열이므로 숫자로 변환
    const user = users.find(u => u.id === id); // id에 해당하는 사용자 찾기

    if (user) {
        res.json(user); // 사용자 정보 응답
    } else {
        res.status(404).json({ message: 'User not found' }); // 404 Not Found 응답
    }
});

// 3. 새 사용자 생성 (POST /api/users)
app.post('/api/users', (req, res) => {
    const newUser = {
        id: nextUserId++, // ID 자동 증가
        name: req.body.name,
        email: req.body.email
    };

    // 필수 필드 검증 (간단하게)
    if (!newUser.name || !newUser.email) {
        return res.status(400).json({ message: 'Name and email are required.' });
    }

    users.push(newUser); // users 배열에 새 사용자 추가
    res.status(201).json(newUser); // 201 Created 상태 코드와 함께 새로 생성된 사용자 정보 응답
});

// 4. 특정 사용자 정보 전체 갱신 (PUT /api/users/:id)
app.put('/api/users/:id', (req, res) => {
    const id = parseInt(req.params.id);
    const updatedUser = req.body;
    let userFound = false;

    users = users.map(user => {
        if (user.id === id) {
            userFound = true;
            // id는 변경하지 않고, 요청 바디의 내용으로 사용자 정보 전체를 갱신
            return { ...user, ...updatedUser, id: id };
        }
        return user;
    });

    if (userFound) {
        const user = users.find(u => u.id === id);
        res.json(user); // 갱신된 사용자 정보 응답
    } else {
        res.status(404).json({ message: 'User not found' });
    }
});

// 5. 특정 사용자 정보 부분 갱신 (PATCH /api/users/:id)
app.patch('/api/users/:id', (req, res) => {
    const id = parseInt(req.params.id);
    const updates = req.body; // 업데이트할 필드만 포함
    let userFound = false;

    users = users.map(user => {
        if (user.id === id) {
            userFound = true;
            // 기존 사용자 정보에 업데이트할 필드만 덮어씌움
            return { ...user, ...updates, id: id };
        }
        return user;
    });

    if (userFound) {
        const user = users.find(u => u.id === id);
        res.json(user);
    } else {
        res.status(404).json({ message: 'User not found' });
    }
});

// 6. 특정 사용자 삭제 (DELETE /api/users/:id)
app.delete('/api/users/:id', (req, res) => {
    const id = parseInt(req.params.id);
    const initialLength = users.length;
    users = users.filter(u => u.id !== id); // id에 해당하지 않는 사용자만 남김

    if (users.length < initialLength) {
        res.status(204).send(); // 204 No Content (삭제 성공 시, 응답 본문 없음)
    } else {
        res.status(404).json({ message: 'User not found' });
    }
});

// 서버 시작
app.listen(port, () => {
    console.log(`RESTful API 서버가 http://localhost:${port} 에서 실행 중입니다.`);
    console.log(`테스트 엔드포인트:`);
    console.log(`- GET /api/users`);
    console.log(`- GET /api/users/1`);
    console.log(`- POST /api/users (Body: {"name": "New", "email": "new@example.com"})`);
    console.log(`- PUT /api/users/1 (Body: {"name": "Updated", "email": "updated@example.com"})`);
    console.log(`- PATCH /api/users/2 (Body: {"email": "patched@example.com"})`);
    console.log(`- DELETE /api/users/1`);
});