org.springframework.web.servlet.DispatcherServlet
스프링 MVC도 프론트 컨트롤러 패턴으로 구현되어 있다.
스프링 MVC의 프론트 컨트롤러가 바로 디스패치 서블릿이다(DispatcherServlet)이다.
그리고 이 디스패처 서블릿이 바로 스프링 MVC의 핵심이ㅏㄷ.
DispatcherServlet
도 부모 클래스에서 HttpServlet
을 상속 받아서 사용하고, 서블릿으로 동작한다.DispatcherServlet
-> FrameworkSerlvet
-> HttpServletBean
-> HttpServlet
(상속 관계)DispatcherServlet
을 서블릿으로 자동으로 등록하면서 모든 경로(urlPatterns="/"
)에 대해서 매핑한다.HttpServlet
이 제공하는 servlet()
가 호출된다.DispatcherServlet
의 부모인 FrameworkServlet
에서 servlet()
를 오버라이드 해두었다.FrameworkServlet.service()
를 시작으로 여러 메서드가 호출되면서 DispatcherServlet.doDispatcher()
가 호출된다.doDispatch()
가 제일 중요한 역할이다. DispatcherServlet.doDispatcher()
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);
}
InternalResourceViewReslover
가 자동 등록되고 사용된다.InternalResourceView(JstView)
를 반환하는데, 내부에 forward()
로직이 있다.DispatcherServlet
코드의 변경 없이 원하는 기능을 변경하거나 확장할 수 있다는 점이다. 지금까지 설명한 대부분을 확장 가능할 수 있게 인터페이스가 제공된다.DispatcherServlet
에 등록하면 여러분만의 컨트롤러를 만들 수도 있다.스프링 MVC는 코드 분량도 매우 많고, 복잡해서 내부 구조를 다 파악하는 것은 쉽지 않다. 사실 해당 기능을 직접 확장하거나 나만의 컨트롤러를 만드는 일은 없으므로 걱정ㅇ하지 않아도 된다. 왜냐하면 스프링 MVC는 전세계 수 많은 개발자들의 요구사항에 맞추어 기능을 계속 확장왔고, 그래서 여러분이 웹 애플리케이션을 만들 때 필요로 하는 대부분의 기능이 이미 다 구현되어 있다. 그래도 이렇게 핵심 동작방식을 알아두어야 향후 문제가 발생했을 때 어떤 부분에서 문제가 발생했는지 쉽게 파악하고, 문제를 해결할 수 있다. 그리고 확장 포인트가 필요할 때, 어떤 부분을 확장해야 할지 감을 잡을 수 있다. 실제 다른 컴포넌트를 제공하거나 기능을 확장하는 부분들은 강의를 진행하면서 조금씩 설명하겠다. 지금은 전체적인 구조가 이렇게 되어 있구나하고 이해하면 된다.
package hello.servlet.web.springmvc.old;
import org.springframework.stereotype.Component;
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 null;
}
}
@Component
: 이 컨트롤러는 /springmvc/old-controller
라는 이름의 스프링 빈으로 등록되었다.이 컨트롤러를 호출되려면 다음 2가지가 필요하다.
Controller
인터페이스를 실행할 수 있는 핸들러 어댑터를 찾고 실행해야 한다.스프링은 이미 필요한 핸들러 매핑과 핸들러 어댑터를 대부분 구현해두었다. 개발자가 직접 핸들러 매핑과 핸들러 어댑터를 만드는 일은 거의 없다.
0 = RequestMappingHandlerMapping : 애노테이션 기반의 컨트롤러인 @RequestMapping에서 사용
1 = BeanNameUrlHandlerMapping : 스프링 빈의 이름으로 핸들러를 찾는다.
0 = RequestMappingHandlerAdapter : 애노테이션 기반의 컨트롤러인 @RequestMapping에서 사용
1 = HttpRequestHandlerAdapter : HttpRequestHandler 처리
2 = SimpleControllerHandlerAdapter : Controller 인터페이스(애노테이션X, 과거에 사용) 처리
핸들러 매핑도, 핸들러 어댑터도 모두 순서대로 찾고 만약 없으면 다음 순서로 넘어간다.
HandlerMapping
을 순서대로 실행해서, 핸들러를 찾는다.BeanNameUrlHandlerMapping
가 실행에 성공하고 핸들러인 OldController
를 반환한다.HandlerAdapter
의 supports()
를 순서대로 호출한다.SimpleControllerHandlerAdapter
는 핸들러인 OldController
를 내부에서 실행하고, 그 결과를 반환한다.OldController
를 실행하면서 사용된 객체는 다음과 같다.
HandlerMapping = BeanNameUrlHandlerMapping
HandlerAdapter = SimpleControllerHandlerAdapter
핸들러 매핑과, 어댑터를 더 잘 이해하기 위해 Controller 인터페이스가 아닌 다른 핸들러를 알아보자.
HttpRequestHandler
핸들러(컨트롤러)는 서블릿과 가장 유사한 형태이다.
MyHttpRequestHandler 를 실행하면서 사용된 객체는 다음과 같다.
HandlerMapping = BeanNameUrlHandlerMapping
HandlerAdapter = HttpRequestHandlerAdapter
조금 뒤에서 설명하겠지만, 가장 우선순위가 높은 핸들러 매핑과 핸들러 어댑터는 RequestMappingHandlerMapping
,
RequestMappingHandlerAdapter
이다.
@RequestMapping
의 앞글자를 따서 만든 이름인데, 이것이 바로 지금 스프링에서 주로 사용하는 애노테이션 기반의 컨트롤러를 지원하는 매핑과 어댑터이다. 실무에서는 99.9% 이 방식의 컨트롤러를 사용한다.
applicatiop.properties
에 다음 코드를 추가해주자.
spring.mvc.view.prefix=/WEB-INF/views/
spring.mvc.view.surffix=.jsp
스프링 부트는 InternalresourceViewResolver
라는 뷰 리졸버를 자동으로 등록하는데, 이때 application.properties
에 등록한 spring.mvc.view.prefix
, spring.mvc.view.suffix=.jsp
설정 정보를 사용해서 등록한다.
참고로 권장하지는 않지만 설정 없이 다음과 같이 전체 경로를 주어도 동작하기는 한다.
return new ModelAndView("WEB-INF/views/new-form.jsp");
new-form
이라는 논리 뷰 이름을 획득한다.new-form
이라는 뷰 이름으로 viewResolver
를 순서대로 호출한다.BeanNameViewResolver
는 new-form
이라는 이름의 스프링 빈으로 등록된 뷰를 찾아야 하는데 없다.InternalResourceViewResolver
가 호출된다.InterResourceViewResolver
이 뷰 리졸버는 InternalResourceView
를 반환한다.
뷰 - InterResourceView
InternalResourceView
는 JSP처럼 포워드 forward()
를 호출해서 처리할 수 있는 경우에 사용한다.
view.render()
view.render()
가 호출되고 InternalResourceView
는 forward()
를 사용해서 JSP를 실행한다.
참고
InternalResourceViewResolver
는 막약 JSTL 라이브러리가 있으면InterResourceView
를 상속받은JstlView
를 반환한다.JstlView
는 JSTL 태그 사용시 약간의 부가 기능이 추가된다.
스프링이 제공하는 컨트롤러는 애노테이션 기반으로 동작해서, 매우 유연하고 실용적이다. 과거에는 자바 언어에 애노테이션이 없기도 했고, 스프링도 처음부터 이런 유연한 컨트롤러를 제공한 것은 아니다.
RequestMappingHandlerMapping
RequestMappingHandlerAdapter
앞서 보았듯이 가장 우선순위가 높은 핸들러 매핑과 핸드럴 어댑터는 RequestMappingHandlerMapping
, RequestMappingHandlerAdapter
이다.
@RequestMapping
의 앞글자만 따서 만든 이름인데, 이것이 바로 지금 스프링에서 주로 사용하는 애노테이션 기반의 컨트롤러를 지원하는 핸들러 매핑과 어댑터이다.
@Controller
:@Component
애노테이션이 있어서 컴포넌트 스캔의 대상이 됨)@RequestMapping
: 요청 정보를 매핑한다. 해당 URL이 호출되면 이 메서드가 호출된다. 애노테이션을 기반으로 동작하기 때문에, 메서드의 이름은 임의로 지으면 안된다.ModelAndView
: 모델과 뷰 정보를 담아서 반환하면 된다.RequestMappingHandlerMapping
은 스프링 빈 중에서 @RequestMapping
또는 @Controller
가 클래스 레벨에 붙어 있는 경우에 매핑 정보로 인식한다.
따라서 다음 코드도 동일하게 동작한다.
@Component //컴포넌트 스캔을 통해 스프링 빈으로 등록 @RequestMapping
public class SpringMemberFormControllerV1 {
@RequestMapping("/springmvc/v1/members/new-form")
public ModelAndView process() {
return new ModelAndView("new-form");
}
}
mv.addObject("member", member)
ModelAndView
를 통해 Model 데이터를 추가할 때는 addObject()
를 사용하면 된다. 이 데이터는 이후 뷰를 렌더링 할 때 사용된다.mv.getModel().put("member", member);
-> JSP 코드와 동일하게 동작한다.컨트롤러 클래스를 톱합하는 것을 넘어서 조합도 가능하다.
다음 코드는 /springmvc/v2/members
라는 부분에 중복이 있다.
@RequestMapping(/springmvc/v2/members/new-form)
@RequestMapping(/springmvc/v2/members)
@RequestMapping(/springmvc/v2/members/save)
물론 이렇게 사용해도 되지만, 컨트롤러를 통합한 예제 코드를 보면 중복을 어떻게 제거했는지 확인할 수 있다. 클래스 레벨에 다음과 같이 @RequestMapping
을 두면 메서드 레벨과 조합이 된다.
@Controller
@RequestMapping("/springmvc/v2/members")
public class SpringMemberControllerV2 {}
@RequestMapping("/springmvc/v2/members")
@RequestMapping("/new-form")
-> @RequestMapping("/springmvc/v2/members/new-form")
@RequestMapping("/save)
-> @RequestMapping("/springmvc/v2/members/save")
@RequestMapping
-> @RequestMapping("/springmvc/v2/members")
MVC 프레임워크 만들기에서 v3는 ModelView를 개발자가 직접 생성해서 반환했기 때문에, 불편했던 기억이 날 것이다. 물론 v4를 만들면서 실용적으로 개선한 기억도날 것이다.
실무에서는 지금부터 설명하는 방식을 주로 사용한다.
save()
, members()
를 보면 Model를 파라미터로 받는 것을 확인할 수 있다. 스프링 MVC도 이런 편의 기능을 제공한다.
뷰의 논리 이름을 반환할 수 있다.
스프링은 HTTP 요청 파라미터를 @RequestParam
으로 받을 수 있다.
@RequestParam("username")
은 request.getParameter("username")
와 거의 같은 코드라 생각하면 된다.
물론 GET 쿼리 파라미터, POST Form 방식을 모두 지원한다.
@RequestMapping
은 URL만 매칭하는 것이 아니라, HTTP Method도 함께 구분할 수 있다.
예를 들어서 URL이 /new-form
이고, HTTP Method가 GET인 경우를 모두 만족하는 매핑을 하려면 다음과 같이 처리하면 된다.
@RequestMapping(value = "new-form", methdod = RequestMethod.GET)
이것을@GetMapping
, @PostMapping
으로 더편리하게 사용할 수 있다.
참고로 Get, Post, Put, Patch 모두 애노테이션이 준비되어 있다.