[Spring] @Controller, @RestController 차이점

 

 

 

Spring의 어노테이션 기반 MVC 프레임 워크는 RESTful 웹 서비스 생성 프로세스를 단순화합니다. 전통적인 Spring MVC 컨트롤러와 RESTful 웹 서비스 컨트롤러의 주요 차이점은 HTTP Response Body가 생성되는 방식입니다. 기존 MVC 컨트롤러는 View 기술에 의존하지만 RESTful 웹 서비스 컨트롤러는 단순히 객체를 반환하고 객체 데이터는 JSON / XML로 HTTP 응답에 직접 기록됩니다.

 

 

---

@Controller(Spring MVC Controller)

1. Controller - View

아래와 같은 과정을 통해 Spring MVC Container는 Client의 요청으로부터 View를 반환합니다.

 

Spring MVC 기존 워크 플로

• Client는 URI 형식으로 웹 서비스에 요청을 보냅니다.
• Mapping 되는 Handler와 그 Type을 찾는 DispatcherServlet이 요청을 인터셉트합니다.
• Controller가 요청을 처리한 후에 응답을 DispatcherServlet으로 반환하고, DispatcherServlet은 View를 사용자에게 반환합니다.

@Controller가 View를 반환하기 위해서는 ViewResolver가 사용되며, ViewResolver 설정에 맞게 View를 찾아 렌더링 합니다. 또는 application.properties 등을 통해 렌더링을 할 수도 있습니다.

spring.mvc.view.prefix=/WEB-INF/templates/
spring.mvc.view.suffix=.jsp

 

 

 

2. Controller - @ResponseBody

하지만 Spring MVC의 컨트롤러에서도 데이터를 반환해야 하는 경우도 있습니다. Spring MVC의 컨트롤러에서는 데이터를 반환하기 위해 메소드에서 @ResponseBody를 사용하면 Spring은 반환 값을 변환하여 Json 형태와 같은 데이터로 활용할 수 있습니다.

 

Spring 3.x MVC RESTful 웹 서비스 워크 플로우

• Client는 URI 형식으로 웹 서비스에 요청을 보냅니다.
• Mapping 되는 Handler와 그 Type을 찾는 DispatcherServlet이 요청을 인터셉트합니다.
• @ResponseBody를 사용하여 Client에게 데이터를 반환합니다.

 

 

3. 예제

Employee라는 다음 Java 클래스를 만듭니다. 이 클래스는 POJO입니다.

import javax.xml.bind.annotation.XmlRootElement;
 
@XmlRootElement(name = "Employee")
public class Employee {
 
    String name;
 
    String email;
 
    public String getName() {
   return name;
    }
 
    public void setName(String name) {
   this.name = name;
    }
 
    public String getEmail() {
   return email;
    }
 
    public void setEmail(String email) {
   this.email = email;
    }
 
    public Employee() {
    }
 
}

다음 @Controller 클래스를 만듭니다.

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.ResponseBody;
 
import com.example.spring.model.Employee;
 
@Controller
@RequestMapping("employees")
public class EmployeeController {
 
    Employee employee = new Employee();
    
    @RequestMapping("employee")
    public String employee() {
        return "employee/index";
    }
 
    @RequestMapping(value = "/{name}", method = RequestMethod.GET, produces = "application/json")
    public @ResponseBody Employee getEmployeeInJSON(@PathVariable String name) {
 
   employee.setName(name);
   employee.setEmail("employee1@genuitec.com");
 
   return employee;
 
    }
 
    @RequestMapping(value = "/{name}.xml", method = RequestMethod.GET, produces = "application/xml")
    public @ResponseBody Employee getEmployeeInXML(@PathVariable String name) {
 
   employee.setName(name);
   employee.setEmail("employee1@genuitec.com");
 
   return employee;
 
    }
 
}

employee 메서드는 요청이 들어오면 "employee/index" 라는 경로의 view 파일을 열겠다고 선언한 전통 @Controller방식입니다. 나머지 메서드는 @ResponseBody를 이용하여 작성된 예제입니다.

 

 

 

 

@RestController(Spring Restful Controller)

1. RestController

Spring 4.0은 @Controller 및 @ResponseBody를 추가하지 않아도 되는 컨트롤러의 특수 버전으로 @RestController를 도입했습니다. @RestController 어노테이션으로 컨트롤러 클래스에 어노테이션을 작성하면 더 이상 모든 요청 맵핑 메서드에 @ResponseBody를 추가할 필요가 없습니다. @ResponseBody를 기본적으로 활성화시켜주기 때문입니다.

 

Spring 4.x MVC RESTful 웹 서비스 워크 플로우

1. Client는 URI 형식으로 웹 서비스에 요청을 보냅니다.
2. Mapping 되는 Handler와 그 Type을 찾는 DispatcherServlet이 요청을 인터셉트합니다.
3. RestController는 해당 요청을 처리하고 데이터를 반환합니다.

 

 

2. 예제

예제에서 @RestController를 사용하려면 @Controller를 @RestController로 수정하고 각 메서드에서 @ResponseBody를 제거하기만 하면 됩니다. 결과 클래스는 다음과 같아야 합니다.

import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RestController;
 
import com.example.spring.model.Employee;
 
@RestController
@RequestMapping("employees")
public class EmployeeController {
 
    Employee employee = new Employee();
 
    @RequestMapping(value = "/{name}", method = RequestMethod.GET, produces = "application/json")
    public Employee getEmployeeInJSON(@PathVariable String name) {
 
   employee.setName(name);
   employee.setEmail("employee1@genuitec.com");
 
   return employee;
 
    }
 
    @RequestMapping(value = "/{name}.xml", method = RequestMethod.GET, produces = "application/xml")
    public Employee getEmployeeInXML(@PathVariable String name) {
 
   employee.setName(name);
   employee.setEmail("employee1@genuitec.com");
 
   return employee;
 
    }
 
}

더 이상 @ResponseBody를 요청 매핑 메서드에 추가할 필요가 없습니다. 변경 한 후 서버에서 애플리케이션을 다시 실행하면 이전과 동일한 출력이 생성됩니다.

 

위와 같이 @RestController를 사용하는 것은 매우 간단하며 Spring v4.0부터 MVC RESTful 웹 서비스를 만드는 데 선호되는 방법입니다.

 

 

 

출처는 여기를 클릭해 주세요.