다양한 방식의 HandlerMapping, HandlerAdapter, ViewResolver

핸들러 매핑, 핸들러 어댑터는 어떤 것들이 사용되는지 알아보겠습니다.

이 전에 만들었던 ControllerV5에서는 Map, List 컬렉션을 사용해서 직접 핸들러와 어댑터를 만들었었습니다.

그럼 이번에는 Spring MVC에서 어떤 핸들러 매핑 , 핸들러 어댑터를 사용하는지 알아보겠습니다.

HandlerMapping & HandlerAdapter

Controller Interface 

: 과거 버전의 스프링 컨트롤러 인터페이스 

public interface Controller {

    ModelAndView handlerRequest(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");
    }
}

 @Component("/springmvc/old-controller")

> 이 컨트롤러를 "/springmvc/old-controller"라는 이름의 스프링 빈으로 등록.

 

이 컨트롤러는

http://localhost:8080/springmvc/old-controller

를 통해 실행할 수 있습니다.

 

이 컨트롤러는 어떤 방식으로 호출되는 것일까요?

컨트롤러가 호출되려면 다음 2가지가 필요합니다.

 

1. 핸들러 매핑

> 핸들러 매핑을 통해 이 컨트롤러를 찾을 수 있어야 합니다.

> "스프링 빈의 이름"으로 핸들러를 찾을 수 있는 핸들러 매핑이 필요합니다.

 

2. 핸들러-어댑터

> 핸들러 매핑을 통해 찾은 컨트롤러를 실행할 수 있는 어댑터가 필요합니다.

> "Controller" 인터페이스를 실행할 수 있는 핸들러 어댑터를 찾고 실행해야 합니다.

 

스프링은 이미 필요한 핸들러 매핑, 어댑터를 대부분 구현해두었기 떄문에 개발자가 일일이 핸들러 매핑과 어댑터를 만들 일은 없습니다.

 

스프링 부트가 자동 등록하는 핸들러 매핑과 어댑터를 몇가지만 살펴보겠습니다.

 

1. HandlerMapping

1 : RequestMappingHandlerMapping  / 어노테이션 기반의 컨트롤러인 @RequestMapping에서 사용합니다.

2 : BeanNameUrlHandlerMapping / 스프링 빈의 이름으로 핸들러를 찾습니다.

 

2. HandlerAdapter

1 : RequestMappingHandlerAdapter / 어노테이션 기반의 컨트롤러인 @RequestMapping에서 사용 

2 : HttpRequestHandlerAdapter / HttpRequestHandler 처리

3 : SimpleControllerHandlerAdapter / Controller 인터페이스 처리

 

❗️ 순서대로 찾고 만약 없으면 다음순서로 넘어가는 방식

 

OldController의 경우에는 

HandlerMapping : BeanNameUrlHandlerMapping

HandlerAdapter : SimpleControllerHandlerAdapter  

을 사용합니다.

 

1. BeanNameUrlHandlerMapping 실행 -> OldController 리턴 

2. SimpleControllerHandlerAdapter를 통해 OldController를 내부에서 실행 

HttpRequestHandler

이번에는 Controller 인터페이스가 아닌 다른 핸들러를 알아보겠습니다.

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

1. HandlerMapping

마찬가지로 @Component에 빈 이름을 등록했기 때문에 BeanNameUrlHandlerMapping 실행하고 핸들러인 MyHttpRequestHandler 리턴

 

2. HandlerAdapter

HttpRequestHandler를 상속받았기 때문에 HttpRequestHandlerAdapter가 실행이 됩니다.

 

3. 어댑터 실행

HttpRequestHandlerAdapter를 실행하면서 핸들러 정보도 함께 넘겨주어 HttpRequestHandlerAdapter는 핸들러인 MyHttpRequestHandler를 내부에서 실행하고 그 결과를 리턴합니다.

 

MyHttpRequestController의 경우에는

HandlerMapping : BeanNameUrlHandlerMapping

HandlerAdapter :  HttpRequestHandlerAdapter

을 사용합니다.

 

RequestMappingHandlerMapping (핸들러 매핑)

RequestMappingHandlerAdapter (핸들러 어댑터)는 @RequestMapping 어노테이션 기반의 컨트롤러를 지원하는 매핑과 어댑터로 뒤에서 자세하게 설명하도록 하겠습니다.

---

ViewResolver

이번에는 뷰리졸버에 대해 자세히 알아보겠습니다.

 

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.handlerRequest");
        return new ModelAndView("new-form");
    }
}

http://localhost:8080/springmvc/old-controller 

실행해보면 웹브라우저에 Whitelabel Error Page가 나오고, 콘솔에 OldController.handlerRequest 출력.

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

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

 

뷰 리졸버 - InternalResourceViewResolver

스픙 부트는 InternalResourceViewResolver라는 뷰 리졸버를 자동으로 등록하는데 이 때, application.properties에 등록한 

view.prefix, view.suffix정보를 사용해서 등록합니다.

 

이 외에도 BeanNameViewResolver ( 빈 이름으로 뷰를 찾아러 리턴 ) 등등 여러가지 뷰 리졸버가 있습니다.

InternalResourceViewResolver는 JSP를 처리할 수 있는 뷰를 리턴합니다.

 

1. 핸들러 어댑터 호출 

핸들러 어댑터로 new-form이라는 뷰 이름 획득

 

2. ViewResolver 호출

new-form 이라는 뷰 이름으로 viewResolver를 순서대로 호출. ( BeanNameViewResolver -> InternalResourceViewResolver -> ...) 

BeanNameViewResolver는 new-form이라는 이름의 스프링 빈으로 등록된 뷰를 찾아야 하는데 없기 때문에 

InternalResourceViewResolver가 호출됩니다.

 

3. InternalResourceViewResolver 호출

InternalResourceView를 리턴

 

4. InternalResourceView는 JSP처럼 forward()를 호출해서 처리할 수 있는 경우에 사용

 

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

 

 

 ❗️JSP가 아닌 타임리프를 뷰 템플릿으로 사용하면 ThymeleafViewResolver를 등록해야 합니다.

최근에는 라이브러리만 추가하면 스프링 부트가 이런 작업도 모두 자동화 해줍니다.