티스토리 뷰

Spring/Spring MVC

[스프링 MVC 1편] 스프링 MVC - 구조 이해

최진영 2021. 4. 23. 10:25

스프링 MVC 전체 구조

 이전에 포스팅에서 Front Controller를 중심으로 Servlet Controller를 개편했었다. 그럼 이 개선한 MVC 프레임워크와 실제 Spring MVC는 얼마나 차이가 날까

개선한 MVC 프레임워크

Spring MVC

 

 네임만 조금 다를 뿐 거의 똑같은 구조를 가지고 있다. 즉, Spring MVC도 마찬가지로 Dispatcher Servlet을 Front로 두고 컨트롤러들을 어댑터를 통해 관리한다.

Servlet Container에서 HTTP 요청을 Servlet 제일 앞에 두고 중앙집중형으로 요청을 처리해주는 FrontController

 결국 Dispatcher Servlet이 우리가 개발한 FrontController의 역할과 동일한 역할을 하는 Controller인것이다.

 

 Dispatcher Servlet 또한 실제로 구현이 되어있는 모습을 보면 HttpServlet을 상속받고 있어 하나의 Servlet으로 동작하고 있음을 확인할 수 있다.

DispatcherServlet은 결국 HttpServlet을 상속받고 있다.

 

요청 흐름
  • 서블릿이 호출되면 HttpServlet을 상속받아 사용하기 때문에 service()가 호출된다.
  • DispatcherServlet이 상속받dms FrameworkServlet에 service()가 오버라이딩 되어있다.
HttpServlet의 service() 메소드가 구현되어있다.

  • 이를 시작으로 DispatcherServlet.doDispatch()가 호출된다.
doDispatch()
protected void doDispatch(HttpServletRequest request, HttpServletResponse response) throws Exception {
        HttpServletRequest processedRequest = request;
        HandlerExecutionChain mappedHandler = null;
        ModelAndView mv = null;
        // 1. 핸들러 조회
        mappedHandler = getHandler(processedRequest);
        if (mappedHandler == null) {
            noHandlerFound(processedRequest, response);
            return;
        }
        // 2. 핸들러 어댑터 조회 - 핸들러를 처리할 수 있는 어댑터
        HandlerAdapter ha = getHandlerAdapter(mappedHandler.getHandler());
        // 3. 핸들러 어댑터 실행 -> 4. 핸들러 어댑터를 통해 핸들러 실행 -> 5. ModelAndView 반환
        mv = ha.handle(processedRequest, response, mappedHandler.getHandler());
        processDispatchResult(processedRequest, response, mappedHandler, mv, dispatchException);
    }
    private void processDispatchResult(HttpServletRequest request,
                                       HttpServletResponse response,
                                       HandlerExecutionChain mappedHandler,
                                       ModelAndView mv,
                                       Exception exception) throws Exception {
        // 뷰 렌더링 호출
        render(mv, request, response);
    }
    protected void render(ModelAndView mv,
                          HttpServletRequest request,
                          HttpServletResponse response) throws Exception {
        View view;
        String viewName = mv.getViewName();
        // 6. 뷰 리졸버를 통해서 뷰 찾기, 7. View 반환
        view = resolveViewName(viewName, mv.getModelInternal(), locale, request);
        // 8. 뷰 렌더링
        view.render(mv.getModelInternal(), request, response);
    }

 지금까지 Front Controller를 구현하면서 했던 과정들을 Dispatcher Servlet이 실행한다.

  • 매핑된 값을 가지고 핸들러를 조회한다.
  • 조회된 핸들러를 처리할 어댑터를 조회한다.
  • 핸들러 어댑터를 통해 핸들러를 실행한다.
  • Model과 View를 핸들러에게 받는다.
  • 뷰 랜더링한다. (뷰 리졸버를 통해 실제 뷰 위치를 받는다)

 

핸들러 매핑과 핸들러 어댑터

 지금은 사용하지 않지만 이전에 사용했던 컨트롤러로 핸들러 패핑과 핸들러 어댑터를 확인해보고자 한다.

 지금 대부분의 사람들이 사용하는 @Controller와는 다르게 Controller 인터페이스가 따로 존재한다.(둘 다 전혀 다른 동작을 한다.)

Controller 인터페이스와 @Controller는 서로 전혀 다르다.

 이전 포스팅에서 수도없이 사용했던 Controller 버전들의 인터페이스와 동일한 구조를 가지고 있다. HttpServeltRequest와 HttpServletResponse를 매개변수로 가지며 ModelAndView 객체를 반환한다. 마치 Controller V2와 V3의 혼합이다.

 

 이를 상속받아서 구현해서 실행해보면 어떻게 될까?

package hello.servlet.web.springmvc.old;

import org.springframework.stereotype.Component;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.mvc.Controller;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

@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" 이름의 스프링 빈으로 등록한다.

 WEB-INF/views/new-form.jsp가 호출이 되었고 콘솔창에는 입력했던 print값이 출력되었다. 스프링 빈만 등록했는데 어떻게 해당 url로 호출이 되었을까?

 

 Dispatcher Servlet이 Front Controller로 되어있는 Spring MVC에서는 컨트롤러가 호출되기 전에 두가지 과정을 거쳤었다.

  • 핸들러 매핑 : 컨트롤러를 찾는다.
  • 핸들러 어댑터 찾기 : 컨트롤러를 실행할 수 있는 핸들러 어댑터를 찾는다.

 이전에는 직접 하나하나 핸들러를 생성할 때마다 핸들러 어댑터를 만들어줬어야 했지만 스프링은 이미 존재하는 대부분의 핸들러 어댑터를 구현해두었기 때문에 이를 꺼내서 잘 사용하기만 하면 된다.

 그럼 이제 두 가지에서 어떻게 스프링 빈 이름으로 핸들러가 찾아졌을까를 알아보도록 하자.

 스프링 부트는 한가지로 명명하지 않아도 알아서 본인이 정해진 순서에 따라서 Handler Mapping 값을 찾고, Handler Adapter를 찾는다. 다음과 같이 말이다.

 

HandlerMapping
0 = RequestMappingHandlerMapping : 어노테이션 기반의 컨트롤러인 @RequestMapping에서 찾는다
1 = BeanNameUrlHandlerMapping    : 스프링 빈 이름으로 찾는다
...
HandlerAdapter
0 = RequestMappingHandlerAdapter   : 어노테이션 기반의 컨트롤러인 @RequestMapping에서 찾는다
1 = HttpRequestHandlerAdapter      : HttpRequestHandler 처리
2 = SimpleControllerHandlerAdapter : Controller 인터페이스 처리
...

 즉, url 요청이 들어왔는데 HandlerMapping의 경우 @RequestMapping이 안달렸으니 넘어가고 스프링 빈 이름이 일치하여 OldController를 반환했으며 HandlerAdapter를 0순위부터 돌다보니 Controller 인터페이스 처리가 되어있어 instance of가 true가 되었기 때문에 해당 어댑터가 대상이 된다.

 결국 Dispatcher Servlet은 url 요청을 받아서 SimpleControllerHandlerAdapther를 가지고 OldController를 실행한 것이다.

 

 다른 Handler 또한 살펴보면 똑같은 동작구조를 가진다.

 이번엔 HttpRequestHandler 인터페이스이다. 보면 알겠지만 리턴값, 매개변수 모두 HttpServlet과 유사하다. 이를 구현해보면

package hello.servlet.web.springmvc.old;

import org.springframework.stereotype.Component;
import org.springframework.web.HttpRequestHandler;

import javax.servlet.ServletException;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;

@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");
    }

}

 위에서 HandlerMapping과 HandlerAdapter의 순서를 가져와서 설명해보면

 요청된 ulr을 사용할 수 있는 핸들러를 검색해본 결과 BeanNameUrlHandlerMapping에 의해 스프링 빈 이름으로 핸들러를 찾게되었고 HttpRequestHandler를 상속받았기 때문에 이 Handler를 사용할 수 있는 Adapter는 HttpRequestHandlerAdapter가 된다.

 결국 Dispatcher Servlet은 url 요청을 받아서 HttpRequestHandlerAdapter를 가지고 MyHttpRequestHandler를 실행한 것이다.

 

 앞으로는 @RequestMapping을 통해서 컨트롤러를 만들 것이다. 지금 스프링에서 가장 많이 사용하는 방식이며 실제로 RequestMappingHandlerMapping과 RequestMappingHandlerAdapter가 이를 지원하며 url 요청에서 매핑과 어댑터를 찾는데 우선순위가 가장 높다.

 

뷰 리졸버

 이전 포스팅에서 View의 공통된 이름을 한번에 View Resolver를 통해서 처리해주었다. 옛날에는 어떻게 처리를 했을까?

package hello.servlet.web.springmvc.old;

import org.springframework.stereotype.Component;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.mvc.Controller;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

@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("/WEB-INF/views/new-form.jsp");
    }
}

 ModelAndView는 이전에 구현하였던 ModelView와 동일한 클래스로 Model과 View를 받아서 넘겨주는 역할을 한다. 근데 사실 앞전에서는 이런 긴 물리 경로를 다 입력하지 않고 논리 네임으로 편하게 사용했었다.

 스프링 부트에서는 InternalResourceViewResolver라는 뷰 리졸버를 자동으로 등록하는데 이때 prefix와 suffix 옵션을 application.properties에서 설정할 수 있다.

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

 그럼 이제 논리 네임을 리턴해도 정상적으로 페이지가 로딩된다.

return new ModelAndView("new-form");

 

 앞선 핸들러 매핑과 어댑터와 같이 뷰 리졸버도 스프링에서 등록해둔 뷰 리졸버들을 탐색해서 우선순위에 따라 먼저 탐색된 뷰 리졸버를 사용한다. 대략적인 순서는 다음과 같다.

1 = BeanNameViewResolver         : 빈 이름으로 뷰를 찾아서 반환한다.
2 = InternalResourceViewResolver : JSP를 처리할 수 있는 뷰를 반환한다.

 실제로는 이렇게 동작한다.

  1. new-form이라는 논리 네임의 뷰를 반환 받는다.
  2. 뷰 리졸버를 호출하여 순서대로 등록된 뷰인지 찾는다.
  3. BeanNameViewResolver는 스프링 빈으로 등록된 뷰가 없기 때문에 다음인 InternalResourceViewResolver가 호출된다.
  4. InternalResourceViewResolver는 forward()를 이용해서 JSP를 실행한다.

 

스프링 MVC - 시작하기

 스프링에서의 컨트롤러는 강력한 어노테이션 기반으로 동작해서 유연하고, 실용적이다. 대표적으로 @RequestMapping이 존재한다.

 이 @RequestMapping에서 중요하게 다루어야할 부분은 다음 둘이다.

  • RequestMappingHandlerMapping
  • RequestMappingHandlerAdapter

 핸들러 매핑과 어댑터의 가장 최 우선순위가 결국 @RequestMapping인 것으로 실무에서는 대부분이 이 컨트롤러를 사용한다.

 

SpringMemberFormControllerV1
package hello.servlet.web.springmvc.v1;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.servlet.ModelAndView;

@Controller
public class SpringMemberFormControllerV1 {

    @RequestMapping("/springmvc/v1/members/new-form")
    public ModelAndView process() {
        return new ModelAndView("new-form");
    }
}
  • @Controller: 내부에 @Component 어노테이션이 있어 스프링 빈으로 자동 등록한다. 스프링 MVC에서 어노테이션 기반 컨트롤러로 인식한다.
  • @RequestMapping : 요청 url 정보를 매핑한다. url 정보가 들어올 때 매핑에서 가장 우선순위가 높다.

 

 앞전에 이야기한 대로 RequestMappingHanlderMaping은 가장 우선 순위로 매핑 정보를 찾으며 @RequestMapping혹은 @Controller가 클래스 레벨에 붙어있는 경우에 매핑 정보로 인식한다.

 따라서 아래 코드도 동일하게 동작한다.

@Component
@RequestMapping
public class SpringMemberFormControllerV1 {

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

 스프링빈으로 등록되어있으며 RequestMapping이 걸려있으므로 해당 클래스를 매핑한다. @Component없이도 되긴하지만 스프링 빈을 직접 등록해주어야 한다.

 

package hello.servlet.web.springmvc.v1;

import hello.servlet.domain.member.Member;
import hello.servlet.domain.member.MemberRepsoitory;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.servlet.ModelAndView;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.util.Map;

@Controller
public class SpringMemberSaveControllerV1 {

    private MemberRepsoitory memberRepsoitory = MemberRepsoitory.getInstance();

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

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

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

 model과 view를 전달할 때는 뷰 네임을 가지고 객체를 생성하고 addObject()를 통해 model 데이터를 주입한다.

 

스프링 MVC - 컨트롤러 통합

 지금까지는 컨트롤러 하나를 만들때 매번 컨트롤러 클래스르 생성했다. 근데 @RequestMapping은 메소드 단위로 넣은 것으로 보아 컨트롤러 클래스 하나에 여러개의 컨트롤러 메소드를 추가할 수 있음을 알 수 있다.

package hello.servlet.web.springmvc.v2;

import hello.servlet.domain.member.Member;
import hello.servlet.domain.member.MemberRepsoitory;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.servlet.ModelAndView;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.util.List;

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

    private MemberRepsoitory memberRepsoitory = MemberRepsoitory.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);
        memberRepsoitory.save(member);

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

    @RequestMapping
    public ModelAndView members() {
        List<Member> members = memberRepsoitory.findAll();
        ModelAndView mv = new ModelAndView("members");
        mv.getModel().put("members", members);

        return mv;
    }
}

 클래스 단위로 되어있던 컨트롤러들을 한 클래스 내부로 통합했다.

 @RequestMapping은 클래스 내에서 중복된 부분이 있다면 위와 같이 클래스 레벨에 먼저 매핑정보를 입력하면 클래스 레벨 매핑 + 메소드 레벨 매핑의 요청값이 매핑된다.

 

스프링 MVC - 실용적인 방식

 위에서는 ModelAndView 객체를 계속 반환을 했었다. 근데 이전 포스팅에서 V4를 만들면서 사용자가 편하게 객체를 반환하지 않고 사용한 것을 기억할 수 있다. 그리고 HttpServletRequest와 HttpServletResponse에 대한 종속성 제거했었다. paramMap과 model을 넘겨서 말이다.

 스프링 MVC에서도 이와같은 편의성을 제공한다.

package hello.servlet.web.springmvc.v3;

import hello.servlet.domain.member.Member;
import hello.servlet.domain.member.MemberRepsoitory;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.servlet.ModelAndView;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.util.List;

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

    private MemberRepsoitory memberRepsoitory = MemberRepsoitory.getInstance();

//    @RequestMapping(value = "/new-form", method = RequestMethod.GET)
    @GetMapping("/new-form")
    public String newForm() {
        return "new-form";
    }

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

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

        model.addAttribute("member", member);

        return "save-result";
    }

//    @RequestMapping(method = RequestMethod.GET)
    @GetMapping
    public String members(Model model) {
        List<Member> members = memberRepsoitory.findAll();

        model.addAttribute("members", members);

        return "members";
    }
}
  • Model 파라메터 : HttpServlet을 사용하지 않고 Model 파라메터만 넘겨서 addAttribuet를 통해 model에 데이터를 담을 수 있다.
  • ViewName : 뷰 논리 네임을 반환해도 알아서 물리 경로를 지정해준다.
  • @RequestParam : 이전에는 Get, Post 방식으로 파라메터를 받아왔지만 @RequestParam으로 편하게 받아올 수 있다. request.getParameter()와 동일한 기능을한다.

 

@RequestMapping, @GetMapping, @PostMapping

 http 요청은 여러가지 메소드로 들어온다. Get, Post, Delete ....

 많은 메소드들이 있지만 @RequestMapping만을 사용하면 모든 메소드들을 허용하여 받는것이기 때문에 메소드에 제한을 걸 수 없다. 따라서 다음과 같은 방법으로 옵션을 걸 수 있다.

@RequestMapping(value = "/new-form", method = ReqeustMethod.GET)

 이걸 더 축약한 것이 @GetMapping이다. 그냥 완전 똑같고 @GetMapping을 살펴보면


 위에 써놓은 구문을 그대로 붙여놓은 어노테이션이다.

 

* 김영한님의 스프링 MVC 1편 - 백엔드 웹 개발 핵심 기술을 듣고 기록한 학습 자료입니다.

저작자표시

'Spring > Spring MVC' 카테고리의 다른 글

[스프링 MVC 1편] 스프링 MVC - 기본 기능  (0) 2021.04.26
[스프링 MVC 1편] MVC 프레임워크 만들기  (0) 2021.04.21
[스프링 MVC 1편] 서플릿, JSP, MVC 패턴  (0) 2021.04.19
[스프링 MVC 1편] 서블릿  (0) 2021.04.12
[스프링 MVC 1편] 웹 애플리케이션의 이해  (1) 2021.04.07
댓글
최근에 올라온 글
Total
Today
Yesterday