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: '[email protected]' },
    { id: 2, name: 'Bob', email: '[email protected]' },
];
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) => {
    if (!req.body || typeof req.body !== 'object') {
        return res.status(400).json({ message: 'Name and email are required.' });
    }

    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 경로 데모: 아래 구현은 기존 필드에 병합하며 완전 교체는 구현하지 않음
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": "[email protected]"})`);
    console.log(`- PUT /api/users/1 (Body: {"name": "Updated", "email": "[email protected]"})`);
    console.log(`- PATCH /api/users/2 (Body: {"email": "[email protected]"})`);
    console.log(`- DELETE /api/users/1`);
});

const express = require('express');
const app = express();
app.use(express.json());

let users = [
  { id: 1, name: 'Alice', email: '[email protected]' },
  { id: 2, name: 'Bob', email: '[email protected]' },
];
let nextUserId = 3;

app.param('id', (req, res, next, rawId) => {
  const id = Number(rawId);
  // 양의 안전한 정수이며, 원래 문자열도 같은 십진 표현이어야 합니다.
  if (!Number.isSafeInteger(id) || id < 1 || String(id) !== rawId) {
    return res.status(400).json({ message: 'Invalid user ID' });
  }
  req.userId = id;
  next();
});

app.get('/api/users', (req, res) => res.json(users));

app.get('/api/users/:id', (req, res) => {
  const user = users.find(user => user.id === req.userId);
  if (!user) {
    return res.status(404).json({ message: 'User not found' });
  }
  return res.json(user);
});

app.post('/api/users', (req, res) => {
  const body = req.body;
  if (body === null || typeof body !== 'object' || Array.isArray(body)
      || typeof body.name !== 'string' || typeof body.email !== 'string') {
    return res.status(400).json({ message: 'Name and email must be strings' });
  }
  if (Object.keys(body).some(key => !['name', 'email'].includes(key))) {
    return res.status(400).json({ message: 'Only name and email are allowed' });
  }
  const name = body.name.trim();
  const email = body.email.trim();
  if (!name || !email) {
    return res.status(400).json({ message: 'Name and email are required' });
  }

  // 모든 입력 검사를 통과한 뒤에만 데이터와 다음 ID를 바꿉니다.
  const user = { id: nextUserId, name, email };
  users.push(user);
  nextUserId += 1;
  return res.status(201).json(user);
});

// PUT은 두 필드를 모두, PATCH는 제공한 필드를 각각 검사합니다.
function readUserFields(body, partial = false) {
  if (body === null || typeof body !== 'object' || Array.isArray(body)) {
    return null;
  }
  const keys = Object.keys(body);
  if (keys.length === 0 || keys.some(key => !['name', 'email'].includes(key))) {
    return null;
  }
  if (!partial && keys.length !== 2) {
    return null;
  }
  const fields = {};
  for (const key of keys) {
    if (typeof body[key] !== 'string' || !body[key].trim()) {
      return null;
    }
    fields[key] = body[key].trim();
  }
  return fields;
}

app.put('/api/users/:id', (req, res) => {
  const fields = readUserFields(req.body);
  if (!fields) {
    return res.status(400).json({ message: 'PUT requires name and email only' });
  }
  const index = users.findIndex(user => user.id === req.userId);
  if (index === -1) {
    return res.status(404).json({ message: 'User not found' });
  }
  // 이전 객체에 병합하지 않고, 서버 ID와 전체 표현으로 교체합니다.
  const user = { id: req.userId, name: fields.name, email: fields.email };
  users[index] = user;
  return res.json(user);
});

app.patch('/api/users/:id', (req, res) => {
  const fields = readUserFields(req.body, true);
  if (!fields) {
    return res.status(400).json({ message: 'PATCH requires valid name or email only' });
  }
  const index = users.findIndex(user => user.id === req.userId);
  if (index === -1) {
    return res.status(404).json({ message: 'User not found' });
  }
  // 모든 제공 필드가 유효할 때만 한 번 병합해, 실패한 부분 갱신을 막습니다.
  const user = { ...users[index], ...fields };
  users[index] = user;
  return res.json(user);
});

app.delete('/api/users/:id', (req, res) => {
  const index = users.findIndex(user => user.id === req.userId);
  if (index === -1) {
    return res.status(404).json({ message: 'User not found' });
  }
  users.splice(index, 1);
  return res.status(204).end();
});

app.use((error, req, res, next) => {
  if (error.type === 'entity.parse.failed') {
    return res.status(400).json({ message: 'Invalid JSON' });
  }
  next(error);
});

app.listen(3000, () => {
  console.log('검증 보완 예제: http://localhost:3000/api/users');
});