[Spring] @Controller vs @RestController

 

8년전 스프링을 처음 접한 이후 Nest.js를 실무에서 쓰며 스프링에 대한 흥미가 점점 다시 생겨났다.

요근래 이것저것 찾아보니 웬걸,,스프링도 아니고 스프링 부트를 대다수가 사용한다

 

스프링부트로 프로젝트를 만들어보고, 하나하나 다시 공부해보는데 분명히 내 기억엔 @Controller 애노테이션을 썼던거 같은데 어느순간 @RestController를 쓰고 있어 차이점이 궁금해졌다

 

 

가장 큰 차이점, 데이터를 어떻게 반환하느냐?

 

컨트롤러 동작 순서 이미지 출처: https://terasolunaorg.github.io/guideline/5.3.1.RELEASE/en/Overview/SpringMVCOverview.html

 

 

@Controller

- Spring mvc 컨트롤러는 주로 View 반환 위해 사용되었고, ViewResolver 통해 화면을 찾는다

-> 메뉴판을 보고 주방으로 안내

- 데이터를 반환해야하는 경우가 있는데 그땐 @ResponseBody를 사용하여 JSON 형태로 데이터 반환하였다

- @ResponseBody를 사용하지 않으면 해당되는 반환값의 HTML을 찾는다

 

@Controller + @ResponseBody 일때 동작 순서

- 컨트롤러를 통해 객체를 반환할 때에는 ResponseEntity로 감싸서 반환을 한다.

- 이때 View Resolver 대신 HttpMessageConverter가 동작한다 (6번동작)

 

@RestController

- @Controller와 다르게 데이터 반환을 @ResponseBody 선언 없이 가능하게 해준다

- JSON, XML 형태로 반환 가능하다

- HTTP Response Body에 데이터를 직접 기록한다

-> 주문한 음식을 그 자리에서 바로 준다

- @Controller + @ResponseBody 의 동작과 일치하게 작동한다

 

 

코드로 비교하기

 

1. @Controller 방식

@Controller
public class UserController {

    @GetMapping("/user/controller")
    @ResponseBody // 이게 없으면 ViewResolver가 "user"라는 뷰를 찾으려 함!
    public User getUser() {
        return new User("Gemini", 2026);
    }
}

 

2. @RestController 방식

@RestController // 클래스 전체에 @ResponseBody가 적용됨
public class UserRestController {

    @GetMapping("/user/rest-controller")
    public User getUser() {
        return new User("Gemini", 2026);
    }
}