Controller?

스프링 프레임워크는 MVC를 사용하고 있고 여기서 Cotroller는 화면(View)와 비즈니스 로직(Model)을 연결시키는 다리 역할을 한다.

쉽게 말해서 “/index 로 가줘~” 라고 요청하면 주소를 받아 어디로 갈지 분석하고 맞는 길로 연결시켜주는 역할이다.

스프링에서는 IoC에서 만들어 놓은 객체를 통해 제어하므로 @Controller 어노테이션으로 이 클래스가 컨트롤러인지 파악할 수 있다. → 이해가 안된다면? [정리] Spring 에서 확인하자.

servlet-context.xml 파일을 보면 컨트롤러 어노테이션과 어떻게 주고를 매핑해서 연결할 것이지에 대한 컨트롤러의 설정이 들어있어 설정한 값에 따라 컨트롤러가 페이지를 연결할 수 있다.

Controller의 종류

@Controller	해당 클래스가 Controller임을 나타내기 위한 어노테이션
@RequestMapping	요청에 대해 어떤 Controller, 어떤 메소드가 처리할지를 맵핑하기 위한 어노테이션
@RequestParam	Controller 메소드의 파라미터와 웹요청 파라미터와 맵핑하기 위한 어노테이션
@ModelAttribute	Controller 메소드의 파라미터나 리턴값을 Model 객체와 바인딩하기 위한 어노테이션
@SessionAttributes	Model 객체를 세션에 저장하고 사용하기 위한 어노테이션
@RequestPart	Multipart 요청의 경우, 웹요청 파라미터와 맵핑가능한 어노테이션(egov 3.0, Spring 3.1.x부터 추가)
@CommandMap	Controller메소드의 파라미터를 Map형태로 받을 때 웹요청 파라미터와 맵핑하기 위한 어노테이션(egov 3.0부터 추가)
@ControllerAdvice	Controller를 보조하는 어노테이션으로 Controller에서 쓰이는 공통기능들을 모듈화하여 전역으로 쓰기 위한 어노테이션(egov 3.0, Spring 3.2.X부터 추가)

Controller의 종류는 위와 같다. 그 중에 많이 사용하는 Cotroller에 대해 알아보자.

1) @Controller

이 어노테이션으로 인해 내부적으로 컨트롤러의 역할을 수행할 수 있다.

---

2) @RequestMapping()

사용자가 특정 uri로 요청을 보내면 Controller에서 어떠한 방식으로 처리할지 정의한다.

이때 들어온 요청을 특정 메소드와 매핑하기 위해 사용하는 것이@RequestMapping()이다.

• value: 요청받을 url를 설정한다.
• method: 어떤 요청으로 받을지 정의한다. (GET, POST, PUT …)

그러나 method는 항상 설정해주기에는 불편하므로 @GetMapping이나 @PostMapping을 사용한다.

@Controller
@RequestMapping("/board")
public class BoardController {
}

만약 위와 같이 @RequestMapping("/board")라고 했다면 uri에 http:/localhost:8080/board 로 오는 주소는 모두 BoardController가 받게 된다.

---

3) @GetMapping()

위에서 설명했듯이 @RequestMapping의 HTTP Method를 간단히 하기 위해 등장한 어노테이션이다. @GetMapping이나 @PostMapping을 사용하여 보다 간결하게 HTTP Method에 매핑할 수 있다.

URL에 변수를 포함시켜 요청하여 보안에 취약하다.

캐싱이 가능하다 ( 한 번 접근한 후에 똑같은 요청을 할 때 빠르게 접근하기 위해 레지스터에 데이터를 저장시키는 것을 캐싱이라 함)

뷰로 이동해라

데이터가 있으면 반환해라

클라이언트에서 서버로 리소스를 조회할 때 사용

---

4) @PostMapping()

HTTP Post Method.

URL의 변수에 변수르 노출하지 않고 요청하여 get방식보다 보안이 좋다.

전송하는데 길이제한이 없고 캐싱이 불가능하다.

서버에 리소스를 등록(저장)할 때 사용

---

4) @PathVariable

최근 HTTP API는 리소스 경로에 식별자를 넣는 스타일을 선호한다. 쿼리 파라미터로 식별자를 넣는 방법도 있지만 경로 변수를 사용하는 것이 매핑되는 부분을 편리하게 조회할 수 있다.

@GetMapping("/detail/{id}")
    public String detail(@PathVariable("id") Long id) {
      return "board/boardDetail";
		}

위와 같이 PathVariable을 사용했을 때 localhost:8080/detail/108 로 입력하면 id가 id(파라미터)로 매칭되어 편하게 사용할 수 있다.

다중 사용도 가능하다.

---

5) @ReponseBody()

뷰페이지로 이동하지 않고 값만 보내는 어노테이션이다.

@GetMapping("/ajax1")
    public @ResponseBody String ajax(){
        return "ajax1반환값";
}

---

5) @RestController()

@RestCotnroller는 @Cotroller에 @ResponseBody가 결합된 어노테이션이다.

즉, @ResponseBody 어노테이션을 따로 붙이지 않아도 문자열과 JSON 등을 전송할 수 있다.

뷰페이지로 이동하는 역할을 하는 @Controller와 달리 @RestController는 뷰페이지로 이동하지 않고 데이터(값)만 리턴한다.

@RestController("/ajax1")
    public String ajax(){
        return "ajax1반환값";
}

---

6) @RequestParam

@RequestParam 어노테이션은 사용자가 요청시 전달하는 값을 Handler(Controller)의 매개변수로 1:1 매핑할 때 사용되는 어노테이션이다.

@Controller
public class TestController {
    @GetMapping("/")
    public String getTestPage(@RequestParam("name") String name) {
        System.out.println("이름 : " + name);
        return "test";
    }
}

예를 들어 사용자가 /?name=test 로 요청한다면 위 핸들러의 매개변수인 name에 “test”가 매핑된다.

---

6) @ModelAttribute

사용자에게 요청 파라미터를 받아서 필요한 객체를 만들고 그 객체에 값을 넣어주어야 하는데 이 과정을 @ModelAttribute 어노테이션을 통해 자동화할 수 있다.

1. 요청 파라미터를 바인딩할 dto 객체를 만든다.
2. dto에 @Getter , @Setter , @ToString , @EqualsAndHashCode , @RequiredArgsConstructor를 자동으로 적용해준다. (값을 세팅하기 위한 setter가 필요함)
3. 컨트롤러에서 public String board1(@ModelAttribute BoardDto boardDto){return “”;}을 통해 BoardDto객체가 생성되고 자동으로 요청 파라미터값이 들어간다.
   1. BoardDto객체가 생성된다.
   2. 요청 파라미터의 이름으로 BoardDto객체의 프로퍼티를 찾는다.
   3. 해당 프로퍼티의 setter를 호출하여 파라미터의 값을 입력한다.
   4. 예를 들어, 파라미터의 이름이 boardTitle이면 setBoardTitle() 메소드를 찾아 호출하여 값을 입력한다.
   • 프로퍼티란? 객체에 getBoardTitle(), setBoardTitle() 메소드가 있으면, 해당 객체는 boardTitle이라는 프로퍼티를 가지고 있다. boardTitle 프로퍼티의 값을 변경하려면 setBoardTitle()이 호출되고, 조회하려면 getBoardTitle()이 호출된다.
     

@RequestParam과 @ModelAttribute의 차이는 1:1 매핑이냐 객체 매핑이냐이다.

@ModelAtrribute를 생략할 수도 있지만 @RequestParam도 생략할 수 있어 혼란이 발생할 수 있다. 스프링에서는 이러한 혼란을 방지하기 위해 다음과 같은 규칙을 제공한다.

• String, int, Integer와 같은 단순 타입의 경우 : @RequestParam
• argument resolver로 지정해둔 타입 외의 나머지 : @ModelAttribute

---

Spring MVC Model을 이해하기 위해서 Controller가 하는 역할을 정확히 이해할 필요가 있다.

📚 Reference

MangKyu, https://mangkyu.tistory.com/49
It is True, https://ittrue.tistory.com/244