🎯 Express를 사용한 CRUD API를 구현하고, HTTP 상태 코드 개념을 이해합니다.

📙 Today I Learned

Express API 구현

개별 삭제 요청 ( DELETE )

// 개별 삭제 요청 (DELETE)
app.delete('/books/:id', (req, res) => {
  let { id } = req.params;
  id = parseInt(id);
  const book = db.get(id);

  if (!book) {
    res.json({
      message: `요청하신 ${id}번은 없는 책입니다.`,
    });
  } else {
    db.delete(id);
    res.json({
      message: `${book.title} 책이 삭제되었습니다.`,
    });
  }
});

• 책이 존재하지 않으면 "요청하신 id번 책을 찾을 수 없습니다." 메시지를 반환합니다.

• 책이 존재하면 db.delete(id)로 데이터를 삭제하고 "${book.title} 책이 삭제되었습니다." 메세지를 반환합니다.

전체 삭제 요청 ( DELETE )

// 전체 삭제 요청 (DELETE)
app.delete('/books', (req, res) => {
  let msg = '';
  if (db.size >= 1) {
    db.clear();
    msg = '모든 책이 삭제되었습니다.';
  } else {
    msg = '삭제할 책이 없습니다.';
  }

  res.json({
    message: msg,
  });
});

• 데이터가 있는 경우, db.clear()로 데이터를 모두 삭제하고, "모든 책이 삭제되었습니다" 메세지를 반환합니다.

• 데이터가 없는 경우, "삭제할 책이 없습니다." 메세지를 반환합니다.

개별 수정 요청 ( PUT )

// 개별 수정 (PUT)
app.put('/books/:id', (req, res) => {
  let { id } = req.params;
  id = parseInt(id);

  const book = db.get(id);
  if (!book) {
    res.json({
      message: `요청하신 ${id}번은 없는 책입니다.`,
    });
  } else {
    let existingTitle = book.title;
    let newTitle = req.body.title;
    bexistingTitle = newTitle;
    db.set(id, book);
    res.json({
      message: `${existingTitle} 책의 이름이 ${newTitle} (으)로 변경되었습니다.`,
    });
  }
});

• 본래 제목을 existingTitle 변수에 저장하고, 새로운 제목을 newTitle에 저장하여 값을 덮어씌웁니다.

• db.set(id)를 통해 데이터를 변경해주고, "existingTitle 책의 이름이 newTitle (으)로 변경되었습니다." 메세지를 반환합니다.

---

리팩토링 (Refactoring)

코드의 기능은 유지하면서 내부 구조를 개선하는 과정입니다.

🤔 왜 필요한 걸까?

• 코드 가독성 향상
• 성능 최적화
• 안정성 향상

리팩토링 시기

• 기능을 추가하기 전 (ex. API URL 설계 수정)

• 동일한 에러가 반복적으로 발생할 때

• ⚠️ 배포, 운영 직전에는 금지

---

HTTP 상태 코드 (HTTP response status code)

클라이언트와 서버 간의 요청 결과를 나타냅니다.

✅ 성공 응답 2xx

200 ok

요청이 성공적으로 처리되었음을 나타냅니다. (GET, PUT, DELETE 성공 시 주로 사용)

201 Created

새로운 리소스가 성공적으로 생성되었음을 나타냅니다. (POST 요청 성공 시 사용)

204 No Content

요청이 성공했지만 반환할 내용이 없음을 나타냅니다. (DELETE 요청 후 결과가 필요 없을 때)

❌ 클라이언트 에러 응답 4xx

400 Bad Request

클라이언트의 요청이 잘못됨을 나타냅니다. (ex. 필수 필드 누락)

403 Forbidden

서버가 요청을 이해했지만, 권한이 없어 거부됨을 나타냅니다. (ex. 관리자 페이지 접근 제한)

404 Not Found

: 서버가 요청한 페이지를 찾을 수 없음을 나타냅니다. (잘못된 URL 요청)

❌ 서버 에러 응답 5xx

500 Internal Server Error

서버에서 예기치 않은 오류 발생한 것을 나타냅니다.

503 Service Unavailable

서버가 과부하 상태이거나 유지보수 중으로 요청을 처리할 수 없음을 나타냅니다.

---

✏️ 한 줄 회고

HTTP 상태 코드로 클라이언트와 서버 요청 결과를 한 눈에 이해할 수 있는 요소로서 역할이 중요하다는 것을 깨달았습니다.