@RestController

학습 목표

⚠️ 지금까지의 한계

@Controller
public class BoardController {
    @GetMapping("/board/view")
    public String view(@RequestParam int num, Model model) {
        model.addAttribute("board", service.selectOne(num));
        return "board/view";    // → JSP 로 그림
    }
}

🛠️ @RestController 의 등장

한 글자 차이의 큰 변화 — 기존 @Controller

@Controller
public class BoardController {

    @GetMapping("/board/view")
    public String view(
        @RequestParam int num,
        Model model
    ) {
        Board b = service.selectOne(num);
        model.addAttribute("board", b);
        return "board/view";
        //     ↑ JSP ViewName
    }
}

// → 응답: HTML 페이지 ( /board/view?num=3 )

한 글자 차이의 큰 변화 — 새 @RestController

@RestController
public class BoardApiController {

    @GetMapping("/api/boards/{num}")
    public Board view(
        @PathVariable int num
    ) {
        return service.selectOne(num);
        //     ↑ 객체 그대로 반환
    }
}

// → 응답: JSON

👉 @Controller → @RestController, Model 매개변수와 ViewName 반환이 사라지고 도메인 객체를 그대로 반환.

JSON 응답의 모습

Jackson — JSON 자동 변환의 마법사

@ResponseBody — @RestController 의 진짜 정체

// @RestController 는 사실 다음 두 어노테이션의 합집합
@Controller
@ResponseBody
public class BoardApiController { ... }

// 위는 아래와 동일
@RestController
public class BoardApiController { ... }

👉 @ResponseBody = 「반환값을 ViewName 으로 해석하지 말고, 응답 바디에 직접 넣어라」.

@ResponseBody — 메서드 단위 혼용

// 메서드 단위로도 가능 — 일부만 REST 스타일
@Controller
public class MixedController {

    @GetMapping("/page")
    public String page() { return "page"; }   // JSP

    @GetMapping("/api/data")
    @ResponseBody
    public Data data() { return service.get(); }  // JSON
}

👉 한 컨트롤러 안에서도 메서드별로 화면용·API 용을 섞어 쓸 수 있습니다.

JSON 받기 — @RequestBody

@PostMapping("/api/boards")
public Board create(@RequestBody Board b) {
    //               ↑ JSON → 자바 객체 자동 변환
    return service.insert(b);
}

👉 @RequestBody 는 요청 바디의 JSON 을 자바 객체로 거꾸로 변환합니다. @ResponseBody 의 정확한 짝.

@RequestBody — 변환 흐름

@RequestBody 의 필수 조건

응답·요청 정리

👉 두 어노테이션이 짝. @RestController 안에서 매개변수에 @RequestBody 만 따로 붙이면 됨.

전체 컨트롤러 예시 — 조회

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

    @Autowired
    private BoardService service;

    @GetMapping
    public List<Board> list() {            // JSON 배열 응답
        return service.selectList();
    }

    @GetMapping("/{num}")
    public Board view(@PathVariable int num) {  // JSON 객체 응답
        return service.selectOne(num);
    }
}

👉 GET 두 개. 반환 타입이 곧 JSON 모양 (배열 ↔ 객체).

전체 컨트롤러 예시 — 등록·수정·삭제

    @PostMapping
    public Board create(@RequestBody Board b) {  // JSON 받음
        service.insert(b);
        return b;                                 // JSON 응답
    }

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

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

👉 변경 메서드 3종. @RequestBody 로 JSON 을 받아서 객체로 응답.

흐름도 — View 가 사라진다

브라우저로 테스트

1. Tomcat 시작
2. 크롬 주소창: http://localhost:8080/.../api/boards
3. 화면에 JSON 배열 그대로 출력

   
   [{"num":1,"title":"첫 글",...}, {"num":2,...}]
   

4. F12 → Network → 응답 헤더 확인:

   Content-Type: application/json;charset=UTF-8

POST 테스트는 어떻게?

@Controller 와 @RestController 공존

// 사람 보기 — JSP 화면
@Controller
@RequestMapping("/board")
public class BoardController {
    @GetMapping("/list")
    public String list(Model m) {
        m.addAttribute("boards", service.selectList());
        return "board/list";
    }
}

// 다른 시스템 / 모바일 앱이 사용 — JSON
@RestController
@RequestMapping("/api/boards")
public class BoardApiController {
    @GetMapping
    public List<Board> list() {
        return service.selectList();
    }
}

👉 같은 Service 를 두 컨트롤러가 호출. 데이터는 같고, 응답 형식만 다름.

Jackson 의 자동 변환 규칙

👉 옵션으로 형식 변경 가능. 본 과정은 기본값으로 충분.

주의 — Jackson 함정

public class Member {
    private String id;
    @JsonIgnore     // ⭐ 이 필드는 JSON 에 포함 안 함
    private String pwd;
    private String nick;
}

RESTful URL 디자인

👉 RESTful = 「리소스(boards)」 를 URL 로, 「동작」 을 HTTP 메서드로. 다음 차시에서 자세히.

실험 — 직접 JSON 응답 보기

1. 기존 BoardController 를 BoardApiController 로 복사
2. @Controller → @RestController 변경
3. @RequestMapping("/board") → @RequestMapping("/api/boards")
4. return ViewName → return 객체 (Model 사용 X)
5. 브라우저에서 새 URL 접속 — JSON 응답 확인
6. F12 Network 의 Response 탭에서 정확한 JSON 모양 확인

다음 차시 미리보기

🔄 Before / After

📊 한 그림 정리

이번 차시의 데이터 흐름

정리

다음: HTTP 메서드 어노테이션 — RESTful URL 디자인.