HTTP 메서드 어노테이션

학습 목표

⚠️ 옛 스타일 URL 의 문제

GET  /board/list            ← 목록
GET  /board/view?num=3      ← 상세
GET  /board/writeForm       ← 작성 폼
POST /board/write           ← 작성 처리
GET  /board/editForm?num=3  ← 수정 폼
POST /board/update          ← 수정 처리
POST /board/delete?num=3    ← 삭제 처리

🛠️ RESTful 의 발상

4 가지 핵심 HTTP 메서드

👉 본 과정은 4 개로 충분. PATCH 는 후속 과정.

같은 URL, 다른 메서드

@RestController
@RequestMapping("/api/boards")
public class BoardApiController {

    @GetMapping("/{num}")            // GET /api/boards/3
    public Board view(@PathVariable int num) {
        return service.selectOne(num);
    }

    @PutMapping("/{num}")            // PUT /api/boards/3
    public Board update(@PathVariable int num,
                         @RequestBody Board b) {
        b.setNum(num);
        return service.update(b);
    }

    @DeleteMapping("/{num}")         // DELETE /api/boards/3
    public void delete(@PathVariable int num) {
        service.delete(num);
    }
}

👉 같은 URL /api/boards/3 에서 메서드만 다르면 다른 처리.

각 메서드의 약속 — 멱등성

👉 멱등 (idempotent) = 같은 요청을 여러 번 보내도 결과가 같음.
PUT 으로 같은 데이터를 100 번 전송 = 한 번 전송과 결과 같음.
POST 는 100 번 전송 = 글이 100 개 생성.

왜 멱등성이 중요한가

RESTful URL 설계 규칙

① 명사를 사용 (동사 X)

✗ POST /api/createBoard
✓ POST /api/boards

✗ GET  /api/getBoard?id=3
✓ GET  /api/boards/3

② 복수형 사용

✗ /api/board/3
✓ /api/boards/3      ← 「게시판들 중 3 번」

③ 계층 구조 표현

GET  /api/boards/3/replies        ← 3 번 글의 댓글들
POST /api/boards/3/replies         ← 3 번 글에 댓글 추가
DELETE /api/boards/3/replies/7     ← 3 번 글의 7 번 댓글 삭제

실제 예시 — 게시판 + 댓글 API

POST vs PUT — 헷갈리기 쉬움

응답 상태 코드 — 메서드별 표준

👉 본 과정에서는 기본 200 으로 충분. 상세한 응답 상태 코드 디자인은 후속 과정.

본 과정의 변환 — v6 → v8

실험 — Postman 으로 PUT/DELETE 보내기

1. Postman 설치 (또는 VS Code REST Client 확장)
2. PUT 요청 작성:

   
   URL: http://localhost:8080/.../api/boards/3
   Method: PUT
   Headers: Content-Type: application/json
   Body: {"title": "수정된 제목", "content": "수정된 내용"}
   

3. 「Send」 클릭 → 수정 결과 확인
4. DELETE 요청도 같은 방식으로 테스트

👉 브라우저 주소창은 GET 만 가능. PUT/DELETE 는 Postman 또는 fetch.

F12 fetch 로 직접 호출

// PUT — F12 Console 에서 실행
await fetch('/api/boards/3', {
    method: 'PUT',
    headers: {'Content-Type': 'application/json'},
    body: JSON.stringify({title: '새 제목', content: '새 내용'})
}).then(r => r.json());

// DELETE — F12 Console
await fetch('/api/boards/3', {
    method: 'DELETE'
});

👉 Postman 없어도 F12 콘솔에서 즉시 테스트 가능.

주의 — HTML form 의 한계

<form method="put"> ... </form>   ← 무시되고 GET 으로 처리됨

실수하기 쉬운 함정

다음 차시 — v8 변환

🔄 Before / After

📊 한 그림 정리

이번 차시의 데이터 흐름

정리

다음: ★ v8 REST 컨트롤러로 변환 — v6 게시판을 통째로 REST 로.