[Spring MVC] 13. 스프링 MVC 구조 이해

해당 글은 김영한님의 스프링 MVC 1편 - 백엔드 웹 개발 핵심 기술 - 인프런 | 강의를 수강하고 정리한 게시글입니다.

스프링 MVC 구조 이해

[이전에 만든 MVC 프레임워크 구조]

 

[Spring MVC 프레임워크 구조]

 

직접 만든 프레임워크 스프링 MVC 비교

• FrontController -> DispatcherServlet
• handlerMappingMap -> HandlerMapping
• MyHandlerAdapter -> HandlerAdapter
• ModelView -> ModelAndView
• viewResolver(메서드) -> ViewResolver(인터페이스)
• MyView -> View

앞에서 설명했듯, 스프링 MVC도 프론트 컨트롤러 패턴으로 구성되어있다.
스프링 MVC의 프론트 컨트롤러가 바로 디스패처 서블릿(DispatcherServlet)이다.

 

참고 : DispatcherServlet도 부모 클래스에서 HttpServlet을 상속받아 사용하고 서블릿으로 동작한다. 스프링 부트는 DispacherServlet 을 서블릿으로 자동으로 등록하면서 모든 경로( urlPatterns=“/“ )에 대해서 매핑한다.

 

스프링 MVC 동작 순서

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

스프링 MVC의 큰 강점은 DispatcherServlet 코드의 변경 없이, 원하는 기능을 변경하거나 확장할 수 있다는 점이다. 지금까지 본 대부분을 확장 가능하도록 인터페이스로 제공한다.

 

[주요 인터페이스 목록]

• 핸들러 매핑 : org.springframework.web.servlet.HandlerMapping
• 핸들러 어댑터 : org.springframework.web.servlet.HandlerAdapter
• 뷰 리졸버 : org.springframework.web.servlet.ViewResolver
• 뷰 : org.springframework.web.servlet.View

이제 위의 주요 인터페이스들을 지금은 사용하지 않지만, 과거에 주로 사용했던 스프링이 제공하는 간단한 컨트롤러로 핸들러 매핑과 어댑터를 이해해보자.

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

[과거 버전 스프링 컨트롤러]
org.springframework.web.servlet.mvc.Controller

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

스프링이 이전에 제공하던 컨트롤러 인터페이스이다. (@Controller 어노테이션과 전혀 다름)

 

[OldController]

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

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

}

http://localhost:8080/springmvc/old-controller 에 접속해서 콘솔에 OldController.handlerRequest이 출력되면 성공이다.

• @Component : 이 컨트롤러는 /springmvc/old-controller 라는 이름의 스프링 빈으로 등록되었다.
• 빈의 이름으로 URL을 매핑할 것이다.

이 컨트롤러의 호출되려면 다음 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 핸들러매핑, 어댑터]
OldController를 실행하면서 사용된 객체는 다음과 같다.
HandlerMapping = BeanNameUrlHandlerMapping
HandlerAdapter = SimpleControllerHandlerAdapter

 

핸들러 매핑과, 어댑터 이해를 돕기 위해 Controller 인터페이스 아닌 다른 핸들러를 알아보자.

HttpRequestHandler 핸들러(컨트롤러)는 서블릿과 가장 유사한 형태의 핸들러이다.

 

[HttpRequestHandler]

public interface HttpRequestHandler {
       void handleRequest(HttpServletRequest request, HttpServletResponse response)
               throws ServletException, IOException;
}

이를 간단하게 구현해보자.

 

[MyHttpRequestHandler]

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

http://localhost:8080/springmvc/request-handler 에 접속해서 빈화면이 나오고 콘솔에MyHttpRequestHandler.handleRequest 가 출력되면 성공이다.

 

[동작 순서]
1. 핸들러 매핑으로 핸들러 조회

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

2. 핸들러 어댑터 조회

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

3. 핸들러 어댑터 실행

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

[정리 - MyHttpRequestHandler 핸들러매핑, 어댑터]
MyHttpRequestHandler 를 실행하면서 사용된 객체는 다음과 같다.
HandlerMapping = BeanNameUrlHandlerMapping
HandlerAdapter = HttpRequestHandlerAdapter

참고 : 가장 우선순위가 높은 핸들러 매핑과 핸들러 어댑터는 RequestMappingHandlerMapping , RequestMappingHandlerAdapter 이다. @RequestMapping 의 앞글자를 따서 만든 이름인데, 스프링에서 주로 사용하는 애노테이션 기반의 컨트롤러를 지원하는 매핑과 어댑터이다. (실무에서 99.9% 이 방식 사용)

뷰 리졸버

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

 

[OldController]

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

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

http://localhost:8080/springmvc/old-controller 접속해서 Whitelabel Error Page가 나오고, 콘솔에 OldController.handleRequest 이 출력될 것이다.

 

이전 OldController에서 View를 사용할 수 있도록 다음 코드를 추가했다.
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 설정 정보를 사용해서 등록한다.

뷰 리졸버 동작 방식

스프링 부트가 자동 등록하는 뷰 리졸버
(실제로는 더 많지만, 중요한 부분 위주로 설명하기 위해 일부 생략)

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

 

1. 핸들러 어댑터 호출
핸들러 어댑터를 통해 new-form 이라는 논리 뷰 이름을 획득한다.

 

2. ViewResolver 호출
new-form 이라는 뷰 이름으로 viewResolver를 순서대로 호출한다.
BeanNameViewResolver 는 new-form 이라는 이름의 스프링 빈으로 등록된 뷰를 찾아야 하는데 없다.
InternalResourceViewResolver 가 호출된다.

 

3. InternalResourceViewResolver
이 뷰 리졸버는 InternalResourceView 를 반환한다.

 

4. 뷰 - InternalResourceView
InternalResourceView 는 JSP처럼 포워드 forward() 를 호출해서 처리할 수 있는 경우에 사용한다.

 

5. view.render()
view.render() 가 호출되고 InternalResourceView는 forward() 를 사용해서 JSP를 실행한다.

 

참고 :
다른 뷰는 실제 뷰를 렌더링하지만, JSP의 경우 forward() 통해서 해당 JSP로 이동(실행)해야 렌더링이 된다. JSP를 제외한 나머지 뷰 템플릿들은 forward() 과정 없이 바로 렌더링 된다.

참고 :
Thymeleaf 뷰 템플릿을 사용하면 ThymeleafViewResolver 를 등록해야 한다. 최근에는 라이브러리만 추가하면 스프링 부트가 이런 작업도 모두 자동화해준다.

 

이제 스프링 MVC를 사용해서 이제까지 해왔던 작업을 리펙토링해보자.