[Spring] 김영한 스프링 MVC_ 섹션6. 스프링 MVC - 구조이해

<출처 인프런>

 

섹션 6은 스프링 MVC 구조를 정확히 이해해 보기 위해 각각의 부분들이 어떻게 변화했는지 살펴봤다. 섹션 5는 직접 MVC 패턴을 만들었고, 섹션 6은 스프링이 어떻게 MVC를 제공하고 있는지 알아봤다. 그리고 제공되는 현재의 스프링 MVC가 어떤 과정을 거쳐서 오게 됐는 지도 배웠다.

 

☘️ 

잘못된 정보가 있을 수 있습니다 

---

 

✔️  과거 버전 스프링 컨트롤러

• 지금은 전혀 사용하지 않는, 과거에 사용했던 컨트롤러를 사용해보자.

 

►  OldController.class

 

@Component

: 스프링 빈으로 등록한다.

@Component("/springmvc/old-controller")
public class OldController implements Controller {

    @Override
    public ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse response) throws Exception {
        System.out.println("OldController.handleRequest");
        return new ModelAndView("new-form");
    }
}

@Component는 /springmvc/old-controller라는 이름의 스프링 빈을 등록한다. 이 코드에서 중요한 점은 애노테이션 Controller가 아닌 인터페이스 Controller라는 것이다. 인터페이스 Controller는 요청이 들어오면 handleRequest 메서드가 실행되고 사용자의 요청을 받아서, 어떤 화면을 보여줄지 ModelAndView 객체로 반환한다.

 

 

 

 

---

 

 

 

✔️  서블릿과 가장 유사한  형태의 핸들러

• HttpRequestHandler 핸들러(컨트롤러)에 대해서 알아보자.

 

►  MyHttpRequestHandler.class

@Component("/springmvc/request-handler")
public class MyHttpRequestHandler implements HttpRequestHandler {
    @Override
    public void handleRequest(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        System.out.println("MyHttpRequestHandler.handleRequest");
    }
}

MyHttpRequestHandler 클래스는 인터페이스인 HttpRequestHandler를 구현한다. OldController는 인터페이스 Controller를 구현하여 ModelAndView 타입을 반환했다면, HttpRequestHandler는 반환타입이 void로 직접 응답처리를 한다. 그러다 보니 OldController에서 뷰 리졸버를 사용했지만, HttpRequestHandler는 사용하지 않는다.

 

 

Q. 왜 HttpRequestHandler가 더 서블릿 스타일일까?

A. 일단 서블릿에 대해 다시 복습해 보면, 서블릿은 자바로 작성된 웹 서버 프로그램이다. 웹 브라우저에서 HTTP 요청을 보내면, 톰캣이 서블릿 객체를 실행해서 요청을 직접 받고, 응답을 직접 만들어 브라우저로 보냈다. 이게 아마 섹션 3 혹은 섹션 4에서 했던 부분일 것이다.  아래는 서블릿 코드이다.

@WebServlet("/hello")
public class HelloServlet extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest request, HttpServletResponse response) throws IOException {
        response.setContentType("text/plain");
        response.getWriter().write("Hello, Servlet!");
    }
}​

 

그렇다면 HttpRequestHandler를 살펴보자.

@Component("/springmvc/request-handler")
public class MyHttpRequestHandler implements HttpRequestHandler {
    @Override
    public void handleRequest(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        System.out.println("MyHttpRequestHandler.handleRequest");
    }
}

딱 봐도 HttpRequestHandler의 메서드인 handleRequest(HttpServletRequest, HttpServletResponse)는 서블릿에 있는 doGet 메서드와 매우 유사하다. doGet 메서드와 handleRequest 메서드 모두 요청과 응답을 직접 받고, 직접 만들어 반환한다. 즉, 서블릿 스타일이라는 것은 요청과 응답 객체를 직접 다루고 결과를 직접 작성한다는 의미라고 볼 수 있다.

 

 

 

 

---

 

 

 

✔️  V1_ SpringMVC 시작하기.

• @RequestMapping을 사용해 보자.

 

► SpringMemberFormControllerV1.class

 

@RequestMapping

: 들어온 요청을 특정 메서드와 매핑해 준다.

@Controller
public class SpringMemberFormControllerV1 {

    @RequestMapping("/springmvc/v1/members/new-form")
    public ModelAndView process() {
        return new ModelAndView("new-form");
    }
}

@Controller 내부에 @Component 애노테이션이 있어서 컴포넌트 스캔의 대상이 된다. @RequestMapping은 해당 URL이 들어오면 메서드가 호출된다. 어떻게 그런 건지 간단하게 살펴보자. @RequestMapping 내부에는 RequestMappingHandlerMapping가 있다. RequestMappingHandlerMapping가 요청 URL이 어떤 핸들러(컨트롤러 메서드)와 연결해야 하는지 찾는다. 그리고 내부에 있는 핸들러 어댑터인 RequestMappingHandlerAdapter로 찾은 핸들러를 실제로 호출하는 역할을 한다.

 

 

 

---

 

 

 

✔️  V2_ 컨트롤러 통합하기.

• 메서드 단위로 적용된 @RequestMapping을 클래스 단위에 넣어 컨트롤러를 통합해 보자.

 

► SpringMemberControllerV2.class

@Controller
@RequestMapping("/springmvc/v2/members")
public class SpringMemberControllerV2 {

    private MemberRepository memberRepository = MemberRepository.getInstance();

    @RequestMapping("/new-form")
    public ModelAndView newForm() {
        return new ModelAndView("new-form");
    }


    @RequestMapping("/save")
    public ModelAndView save(HttpServletRequest request, HttpServletResponse response) {
        String username = request.getParameter("username");
        int age = Integer.parseInt(request.getParameter("age"));

        Member member = new Member(username, age);
        memberRepository.save(member);

        ModelAndView mv = new ModelAndView("save-result");
        mv.addObject("member", member);
        return mv;
    }
    ...
  }

V1에서는 Form, Save, Members를 모두 나눠 클래스를 작성했다. 그런데 V2에서는 클래스 단위에 공통된 경로를  @RequestMapping으로 작성했다. 그러면 메서드에 붙는 @RequestMapping에 작성할 경로는 간단해진다.

 

 

 

---

 

 

 

✔️  V3_ 실용적인 방식.

• 실무에서 주로 사용하는 방식을 알아보자.

 

► SpringMemberControllerV3.class

@Controller
@RequestMapping("/springmvc/v3/members")
public class SpringMemberControllerV3 {

    private MemberRepository memberRepository = MemberRepository.getInstance();
    ...

    @RequestMapping(value = "/save")
    @PostMapping
    public String save(
            @RequestParam("username") String username,
            @RequestParam("age") int age,
            Model model) {

        Member member = new Member(username, age);
        memberRepository.save(member);

        model.addAttribute("member", member);
        return "save-result";
    }
    ...
 }

변한 부분을 먼저 찾아보자. 첫 번째, @PostMapping이 붙었다. 두 번째 @RequestParam이 생겼다. 세 번째 model.addAttribute가 생겼다. 네 번째 return이 String 타입으로 간단해졌다. 

@RequestMapping을 사용했을 때는 GET, POST 방식을 구분하지 않고 받아왔다. 하지만 이런 방식은 의도를 명확하게 구분하기 어렵다. 예로 GET 방식은 데이터 조회하는데 주로 사용한다. POST 방식은 데이터 생성 혹은 변경에 사용한다. PUT/PATCH는 데이터 생성에 사용한다. 이런 식으로 역할에 맞게 메서드를 구분하여 처리해야 코드가 명확해져서 버그나 실수를 줄일 수 있다. 그래서 Spring MVC에서는 간단하게 @GetMapping, @PostMapping 등 애노테이션을 사용할 수 있게 만들었다.

SpringMVC에서 요청 파라미터를 @RequestParam으로 받는다. 그동안 String username = request.getParameter("uesrname"); 으로 적었는데, 그럴 것 없이 @RequestParam 애노테이션을 이용하여 간단하게 받아온다.

가져온 요청 파라미터를 save 시킨 후 id와 함께 반환된 정보를 addAttribute로 model에 잠시 넣어둔다.

각 메서드의 반환타입을 보면, String으로 바뀌어있다. 그렇다면 ModelAndView 객체를 생성할 것 없이 문자열인 경로를 반환하기만 하면 결과가 사용자에게 전달될 것이다.