[Spring Boot] Spring MVC 구조 / 핸들러 매핑과 핸들러 어댑터

📌 DispatcherServlet 서블릿 

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

참고 : 더 자세한 경로가 우선순위가 높다. 

 

요청 흐름

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

 

 

 

 

동작 순서

1. 핸들러 조회 : 핸들러 매핑을 통해 요청 URL에 매핑된 핸들러(컨트롤러)를 조회한다.

2. 핸들러 어댑터 조회 : 핸들러를 실행할 수 있는 핸들러 어댑터를 조회한다.

3. 핸들러 어댑터 실행 : 핸들러 어댑터를 실행한다.

4. 핸들러 실행 : 핸들러 어댑터가 실제 핸들러를 실행한다.

5. ModelAndView 반환 : 핸들러 어댑터는 핸들러가 반환하는 정보를 ModelAndView로 변환해서 반환한다. 

6. viewResolver 호출  : 뷰 리졸버를 찾고 실행한다.

7. View 반환 : 뷰 리졸버를 뷰의 논리 이름을 물리 이름으로 바꾸고, 랜더링 역할을 담당하는 뷰 객체를 반환한다.

8. 뷰 렌더링 : 뷰를 통해서 뷰를 렌더링 한다. 

 

 

인터페이스 살펴보기 

• 스프링 MVC의 큰 강점은 DispatcherServlet 코드의 변경 없이, 원하는 기능을 변경하거나 확장할 수 있다는 점이다.
• 주요 인터페이스 목록
  • 핸들러 매핑 : org.springframework.web.servlet.HandlerMapping
  • 핸들러 어댑터 : org.springframework.web.servlet.HandlerAdapter
  • 뷰 리졸버 : org.springframework.web.servlet.ViewResolver
  • 뷰 : org.springframework.web.servlet.View

 

 

---

 

 

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

 

Controller 인터페이스

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

public interface Controller {

     ModelAndView handlerRequest (HttpServletRequest request, HttpServletResponse response) throws Exception; 

}

 

 

 

간단하게 구현해보면 다음과 같다. 

 

• @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 

 

그렇다면 !!

저기서 HttpRequestHandler는 뭘까?

결론부터 말하면 HttpRequestHandler 는 Controller인터페이스가 아닌 다른 핸들러인데, 서블릿과 가장 유사한 형태의 핸들러 이다. 

 

public interface HttpRequestHandler {

     void handlerRequest (HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException; 

}

 

간단하게 구현해보자.

 

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

1. HandlerMapping 을 순서대로 실행해서 핸들러를 찾는다.

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

 

2. 핸들러 어댑터 조회

1. HandlerAdapter의 supports()를 순서대로 호출한다.

2. HttpRequestHandlerAdapter 가 Controller 인터페이스를 지원하므로 대상이된다. 

 

3. 핸들러 어댑터 실행

1. 디스패처 서블릿이 조회한 HttpRequestHandlerAdapter 를 실행하면서 핸들러 정보도 함께 넘겨준다.

2. HttpRequestHandlerAdapter 는 핸들러인 MyHttpRequestHandler를 내부에서 실행하고 그 결과를 반환한다. 

 

정리 MyHttpRequestHandler 핸들러 매핑, 어댑터

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

• HandlerMapping = BeanNameUrlHandlerMapping 
• HandlerAdapter = HttpRequestHandlerAdapter 

 

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