리팩토링하는 블로그

개발/Spring MVC

스프링 MVC - 구조 이해

Debin 2022. 1. 9.
반응형
본 게시글은 인프런 김영한 선생님 강의 스프링 MVC 1편을 완강하고 배운 것을 남기고자 적은 포스팅입니다.
(2022.08.07 수정) - 복습을 하면서, 기억할 부분 설명 추가.

 

아래 이미지는 스프링 MVC 구조다.

구조가 굉장히 유사한 것을 볼 수 있다. 직접 만든 MVC 프레임워크와 스프링 MVC를 비교해보겠다.

 

  • FrontController -> DispatcherServlet
  • handleMappingMap -> HandlerMapping
  • MyHandlerAdapter -> HandlerAdapter
  • ModelView -> ModelAndView
  • viewResolver -> ViewResolver
  • MyView -> View

DispatcherServlet 구조 살펴보기

스프링 MVC도 프론트 컨트롤러 패턴으로 구현되어 있다.

스프링 MVC의 프론트 컨트롤러가 바로 디스패쳐 서블릿이다. 이 디스패쳐 서블릿이 스프링 MVC의 핵심이다.

DispatcherServlet도 부모 클래스에서 HttpServlet을 상속 받아서 사용하고, 서블릿으로 동작한다.

스프링 부트는 DispatcherServlet을 서블릿으로 자동으로 등록하면서 모든 경로("/")에 대해서 매핑한다.

(참고: 더 자세한 경로가 우선순위가 높다. 그래서 기존에 등록한 서블릿도 함께 동작한다.)

 

요청 흐름은 아래와 같다.

 

  • 서블릿이 호출되면 HttpServlet이 제공하는 service()가 호출된다.
  • 스프링 MVC는 DispatcherServlet의 부모인 FrameworkServlet에서 Service()를 오버라이드 해두었다.
  • FrameworkServlet.service() 를 시작으로 여러 메서드가 호출되면서 DispatcherServlet.doDispatch() 가 호출된다.

DispatcherServlet의 메소드 doDispatch의 흐름은 아래와 같다.

 

  1. 핸들러 조회
  2. 핸들러 어댑터 조회 - 핸들러를 처리할 수 있는 어댑터
  3. 핸들러 어댑터 실행 
  4. 핸들러 어댑터 통해 핸들러 실행
  5. ModelAndView 반환
  6. 뷰 리졸버를 통해서 뷰 찾기
  7. View 반환
  8. 뷰 렌더링

스프링 MVC 동작 순서도 위와 같다. 좀 더 설명을 추가하겠다.

 

  1. 핸들러 조회: 핸들러 매핑을 통해 요청 URL에 매핑된 핸들러(컨트롤러)를 조회한다.
  2. 핸들러 어댑터 조회: 핸들러를 실행할 수 있는 핸들러 어댑터를 조회한다.
  3. 핸들러 어댑터 실행: 핸들러 어댑터를 실행한다.
  4. 핸들러 실행: 핸들러 어댑터가 실제 핸들러를 실행한다.
  5. ModelAndView 반환: 핸들러 어댑터는 핸들러가 반환하는 정보를 ModelAndView로 변환해서 반환한다.
  6. viewResolver 호출: 뷰 리졸버를 찾고 실행한다. JSP의 경우: InternalResourceViewResolver 가 자동 등록되고, 사용된다.
  7. View 반환: 뷰 리졸버는 뷰의 논리 이름을 물리 이름으로 바꾸고, 렌더링 역할을 담당하는 뷰 객체를 반환한다.
    JSP의 경우 InternalResourceView(JstlView) 를 반환하는데, 내부에 forward() 로직이 있다.
  8. 뷰 렌더링: 뷰를 통해서 뷰를 렌더링 한다.

주요 인터페이스로는 HandlerMapping, HandlerAdapter, ViewResolver, View가 있다.

Handelr Mapping, Handler Adapter (핸들러 매핑, 핸들러 어댑터)

핸들러 매핑과 핸들러 어댑터가 어떤 것들이 어떻게 사용되는지 알아보겠다.

먼저 간단한 컨트롤러로 핸들러 매핑과 어댑터를 이해해보자.

//과거 버전 스프링 컨트롤러. 과거에는 이런 딱딱한 형식의 컨트롤러를 스프링이 제공함

public interface Controller {
    ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse response) throws Exception;
}

이제 위 인터페이스의 구현 클래스를 작성해보자.

@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 null;
   }
}

이 컨트롤러는 /springmvc/old-controller라는 이름의 스프링 빈으로 등록되었다.

빈의 이름으로 URL을 매핑한다. 이 컨트롤러는 어떻게 호출되는가?

이제 스프링 MVC 구조를 다시 살펴보자.

이 컨트롤러가 호출되려면 위 스프링 MVC 구조에서는 핸들러 매핑과 핸들러 어댑터 2가지가 필요하다.

 

  • HandlerMapping 핸들러 매핑
    • 핸들러 매핑에서 이 컨트롤러를 찾을 수 있어야 한다.
    • 예를 들어 스프링 빈의 이름으로 핸들러를 찾을 수 있는 핸들러 매핑이 필요하다.
  • HandlerAdapter 핸들러 어댑터
    • 핸들러 매핑을 통해서 찾은 핸들러를 실행할 수 있는 핸들러 어댑터가 필요하다.
    • Controller 인터페이스를 실행할 수 있는 핸들러 어댑터를 찾고 실행해야 한다.

스프링이 핸들러 매핑과, 핸들러 어댑터를 대부분 구현해서 개발자가 직접 만들 일은 거의 없다.

 

이제 스프링 부트가 자동 등록하는 주요한 핸들러 매핑과 핸들러 어댑터를 소개하겠다.

HandlerMapping
0 = RequestMappingHandlerMapping : 애노테이션 기반의 컨트롤러인 @RequestMapping에서 사용
1 = BeanNameUrlHandlerMapping : 스프링 빈의 이름으로 핸들러를 찾는다.

HandlerAdapter
0 = RequestMappingHandlerAdapter : 애노테이션 기반의 컨트롤러인 @RequestMapping에서 사용
1 = HttpRequestHandlerAdapter : HttpRequestHandler 처리
2 = SimpleControllerHandlerAdapter : Controller 인터페이스(애노테이션X, 과거에 사용)처리

숫자는 우선순위다. 높은 우선순위가 없으면 다음 순서로 넘어간다.

 

1. 핸들러 매핑으로 핸들러 조회

  1. HandlerMapping을 순서대로 실행해서, 핸들러를 찾는다.
  2. . 이 경우 빈 이름으로 핸들러를 찾아야 하기 때문에 이름 그대로 빈 이름으로 핸들러를 찾아주는 BeanNameUrlHandlerMapping 가 실행에 성공하고 핸들러인 OldController 를 반환한다.

2. 핸들러 어댑터 조회

  1. HandlerAdapter 의 supports() 를 순서대로 호출한다.
  2. SimpleControllerHandlerAdapter가 Controller 인터페이스를 지원하므로 대상이 된다.

3.핸들러 어댑터 실행

  1. 디스패처 서블릿이 조회한 SimpleControllerHandlerAdapter 를 실행하면서 핸들러 정보도 함께 넘겨준다.
  2. SimpleControllerHandlerAdapter 는 핸들러인 OldController 를 내부에서 실행하고, 그 결과를 반환한다.

 

OldController 를 실행하면서 사용된 객체는 다음과 같다.

HandlerMapping = BeanNameUrlHandlerMapping

HandlerAdapter = SimpleControllerHandlerAdapter

 

이 방식 외에도 Controller 인터페이스가 아닌 다른 핸들러가 있다.

HttpRequestHandler 핸들러는 서블릿과 가장 유사한 형태의 핸들러이다. 이 핸들러도 인터페이스 기반이다.

핸들러 조회, 어댑터 조회, 어댑터 실행은 위 Controller 인터페이스 방식과 동일하다.

 

가장 우선순위가 높은 핸들러 매핑과 핸들러 어댑터는

RequestMappingHandlerMapping , RequestMappingHandlerAdapter 이다.

@RequestMapping 의 앞글자를 따서 만든 이름인데,

이것이 바로 지금 스프링에서 주로 사용하는 애노테이션 기반의 컨트롤러를 지원하는 매핑과 어댑터이다.

실무에서는 99.9% 이 방식의 컨트롤러를 사용한다고 한다.

View Resolver (뷰 리졸버)

이번에는 뷰 리졸버에 대해서 자세히 알아보자.

OldController가 View를 조회할 수 있게 변경해보자.

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

실행해보면 컨트롤러를 정상 호출되지만, Whitelabel Error Page 오류가 발생한다.

그래서 다음 코드를 application.properties에 다음 코드를 추가하자.

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

뷰 리졸버 - InternalResourceViewResolver

스프링 부트는 InternalResourceViewResolver 라는 뷰 리졸버를 자동으로 등록하는데,

이때 application.properties 에 등록한 spring.mvc.view.prefix , spring.mvc.view.suffix 설정 정보를 사용해서 등록한다.

 

이제 뷰 리졸버 동작 방식에 대해 알아보자. 다시 확인하지만 스프링 mvc 구조는 아래와 같다.

스프링 부트가 자동 등록하는 중요한 뷰 리졸버 몇 가지만 알아보자.

1 = BeanNameViewResolver : 빈 이름으로 뷰를 찾아서 반환한다. (예: 엑셀 파일 생성 기능에 사용)
2 = InternalResourceViewResolver : JSP를 처리할 수 있는 뷰를 반환한다.

 

  1. 핸들러 어댑터 호출 - 핸들러 어댑터를 통해 new-form 이라는 논리 뷰 이름을 얻는다.
  2. ViewResolver 호출
    1. new-form 이라는 뷰 이름으로 viewResolver를 순서대로 호출한다.
    2. BeanNameViewResolver는 new-form이라는 이름의 스프링 빈으로 등록된 뷰를 찾아야 하는데 없다.
    3. InternalResourceViewResolver가 호출된다.
  3. InternalResourceViewResolver - 이 뷰 리졸버는 InternalResourceView 를 반환한다.
  4. . 뷰 InternalResourceView - InternalResourceView 는 JSP처럼 포워드 forward() 를 호출해서 처리할 수 있는 경우에 사용한다.
  5. view.render() - view.render() 가 호출되고 InternalResourceView 는 forward() 를 사용해서 JSP를 실행한다.

참고로 다른 뷰는 실제 뷰를 렌더링하지만, JSP의 경우는 forward()를 통해서 해당 JSP로 이당(실행)해야 렌더링이 된다.

JSP를 제외한 나머지 뷰 템플릿들은 forward() 과정 없이 바로 렌더링 된다.

@RequestMapping

  • RequestMappingHandlerMapping
  • RequestMappingHandlerAdapter

앞서 보았듯이 가장 우선순위가 높은 핸들러 매핑과 핸들러 어댑터는

RequestMappingHandlerMapping , RequestMappingHandlerAdapter 이다.

@RequestMapping 의 앞글자를 따서 만든 이름인데,

이것이 바로 지금 스프링에서 주로 사용하는 애노테이션 기반의 컨트롤러를 지원하는 핸들러 매핑과 어댑터이다.

실무에서는 99.9% 이 방식의 컨트롤러를 사용한다고 한다.

 

이후 강의에서는 실습을 진행했는데 몇 가지 기억해야 하는 부분만 남기고 마치겠다.

 

  • Model 파라미터 - save() , members() 를 보면 Model을 파라미터로 받는 것을 확인할 수 있다.
    스프링 MVC도 이런 편의 기능을 제공한다.
  • ViewName 직접 반환 - 뷰의 논리 이름을 반환할 수 있다.
  • @RequestParam - 사용 스프링은 HTTP 요청 파라미터를 @RequestParam 으로 받을 수 있다. @RequestParam("username") 은 request.getParameter("username") 와 거의 같은 코드라 생각하면 된다.
    물론 GET 쿼리 파라미터, POST Form 방식을 모두 지원한다.

이상으로 포스팅을 마치겠습니다. 감사합니다.

반응형

댓글

티스토리툴바