이번 섹션부터는 스프링 MVC의 구조에 대해서 알아보자.
(이전 섹션에서 직접 만들었던 MVC 프레임워크와 비교해보면서 학습해보자.)
👉 목차는 다음과 같다.
1) 스프링 MVC 전체 구조
2) 핸들러 매핑과 핸들러 어댑터
3) 뷰 리졸버
4) 스프링 MVC - 시작하기
5) 스프링 MVC - 컨트롤러 통합
6) 스프링 MVC - 실용적인 방식
7) 정리
먼저 스프링 MVC의 전체 구조를 확인해보고, 스프링 MVC가 지원하는 핸들러 매핑과 핸들러 어댑터에 대해서 알아보자. 그리고 스프링 MVC가 제공하는 뷰 리졸버에 대해서도 알아볼 것이다.
4)부터는 기존에 만들었던 코드를 스프링 MVC로 개발해볼 것이다.
직접 만든 MVC 프레임워크와 스프링 MVC를 비교해보자.
👉 먼저 DispatcherServlet의 구조를 살펴보자.
(org.springframework.web.servlet.DispatcherServlet
)
HttpServlet
이 제공하는 serivce()
가 호출된다.DispatcherServlet
의 부모인 FrameworkServlet
에서 service()
를 오버라이드 해두었다.FrameworkServlet.service()
를 시작으로 여러 메서드가 호출되면서 DispacherServlet.doDispatch()
가 호출된다.DispacherServlet.doDispatch()
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);
}
👉 SpringMVC 구조
InternalResourceViewResolver
가 자동 등록되고, 사용된다.InternalResourceView(JstlView)
를 반환하는데, 내부에 forward() 로직이 있다.
인터페이스 살펴보기
DispatcherServlet
코드의 변경 없이, 원하는 기능을 변경하거나 확장할 수 있다는 점이다. 지금까지 설명한 대부분을 확장 가능할 수 있게 인터페이스로 제공한다.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
👉 간단하게 구현해보자.
OldController
: src > main > java > hello > servlet > web > springmvc > old 패키지 생성 후, 내부에 OldController 클래스를 생성하자.@Component
: 이 컨트롤러는 /springmvc/old-controller
라는 이름의 스프링 빈으로 등록되었다. (빈의 이름으로 URL을 매핑할 것이다.)
🤔 이 컨트롤러는 어떻게 호출될 수 있을까?
스프링 MVC 구조
Controller
인터페이스를 실행할 수 있는 핸들러 어댑터를 찾고 실행해야 한다.👉 스프링은 이미 필요한 핸들러 매핑과 핸들러 어댑터를 대부분 구현해두었다. 개발자가 직접 핸들러 매핑과 핸들러 어댑터를 만드는 일은 거의 없다.
✔️ 스프링 부트가 자동 등록하는 핸들러 매핑과 핸들러 어댑터
(실제로는 더 많지만, 중요한 부분 위주로 설명하기 위해 일부 생략)
0순위
= RequestMappingHandlerMapping1순위
= BeanNameUrlHandlerMapping0순위
= RequestMappingHandlerAdapter1순위
= HttpRequestHandlerAdapter2순위
= SimpleControllerHandlerAdapter
✔️ 핸들러 매핑도, 핸들러 어댑터도 모두 순서대로 찾고 만약 없으면 다음 순서(순위)로 넘어간다.
HandlerMapping
을 순서대로 실행해서, 핸들러를 찾는다.BeanNameUrlHandlerMapping
가 실행에 성공하고 핸들러인 OldController
를 반환한다.HandlerAdapter
의 supports()
를 순서대로 호출한다.SimpleControllerHandlerAdapter
가 Controller
인터페이스를 지원하므로 대상이 된다.SimpleControllerHandlerAdapter
를 실행하면서 핸들러 정보도 함께 넘겨준다.SimpleControllerHandlerAdapter
는 핸들러인 OldController
를 내부에서 실행하고, 그 결과를 반환한다.OldController
를 실행하면서 사용된 객체는 다음과 같다.BeanNameUrlHandlerMapping
SimpleControllerHandlerAdapter
✔️ HttpRequestHandler
HttpRequestHandler
핸들러(컨트롤러)는 서블릿과 가장 유사한 형태의 핸들러이다. (리턴타입이 void이다. 해당 메서드 안에서 다 처리해야 한다.)👉 간단하게 구현해보자.
MyHttpRequestHandler
: src > main > java > hello > servlet > web > springmvc > old 패키지 내부에 MyHttpRequestHandler 클래스를 생성하자.
1) 핸들러 매핑으로 핸들러 조회
HandlerMapping
을 순서대로 실행해서, 핸들러를 찾는다.BeanNameUrlHandlerMapping
가 실행에 성공하고 핸들러인 MyHttpRequestHandler
를 반환한다.2) 핸들러 어댑터 조회
HandlerAdapter
의 supports()
를 순서대로 호출한다.HttpRequestHandlerAdapter
가 HttpRequestHandler
인터페이스를 지원하므로 대상이 된다.3) 핸들러 어댑터 실행
HttpRequestHandlerAdapter
를 실행하면서 핸들러 정보도 함께 넘겨준다.HttpRequestHandlerAdapter
는 핸들러인 MyHttpRequestHandler
를 내부에서 실행하고, 그 결과를 반환한다.정리 - MyHttpRequestHandler 핸들러 매핑, 어댑터
MyHttpRequestHandler
를 실행하면서 사용된(적용된) 객체는 다음과 같다.BeanNameUrlHandlerMapping
HttpRequestHandlerAdapter
이번에는 전체 구조의 마지막인 뷰 리졸버에 대해서 알아보자.
위에서 만들었던 OldController에서 View를 사용할 수 있도록 변경해보자.
👉 실행해보면 컨트롤러를 정상 호출되지만, Whitelabel Error Page 오류가 발생한다.
✔️ 뷰 리졸버 - InternalResourceViewResolver
InternalResourceViewResolver
라는 뷰 리졸버도 자동으로 등록해준다. 이때 application.properties
에 등록한 spring.mvc.view.prefix
, spring.mvc.view.suffix
설정 정보를 사용해서 등록한다.return new ModelAndView("/WEB-INF/views/new-form.jsp");
✔️ 뷰 리졸버 동작 방식
1순위
= BeanNameViewResolver : 빈 이름으로 뷰를 찾아서 반환한다. (예: 엑셀 파일 생성 기능에 사용 (ex. excelDownloadView등))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를 실행한다.
✔️ 참고
InternalResourceViewResolver
는 만약 JSTL 라이브러리가 있으면 InternalResourceView
를 상속받은 JstlView
를 반환한다. JstlView
는 JSTL 태그 사용시 약간의 부가 기능이 추가된다.
다른 뷰는 실제 뷰를 렌더링하지만, JSP의 경우 forward()
통해서 해당 JSP로 이동(실행)해야 렌더링이 된다. JSP를 제외한 나머지 뷰 템플릿들은 forward()
과정 없이 바로 렌더링 된다.
Thymeleaf 뷰 템플릿을 사용하면 ThymeleafViewResolver
를 등록해야 한다. 최근에는 라이브러리만 추가하면 스프링 부트가 이런 작업도 모두 자동화해준다.
이제 본격적으로 스프링 MVC를 시작해보자.
이제 본격적으로 스프링 MVC를 사용해서 코드를 만들어보자.
스프링이 제공하는 컨트롤러는 애노테이션 기반으로 동작해서, 매우 유연하고 실용적이다. 과거에는 자바 언어에 애노테이션이 없기도 했고, 스프링도 처음부터 이런 유연한 컨트롤러를 제공한 것은 아니다. (위에서 보았던 것 처럼 인터페이스를 기반으로 제공했었다.)
✔️ @RequestMapping
@RequestMapping
애노테이션을 사용하는 컨트롤러이다. 다들 한번쯤 사용해보았을 것이다. 여담이지만 과거에는 스프링 프레임워크가 MVC 부분이 약해서 스프링을 사용하더라도 MVC 웹 기술은 스트럿츠 같은 다른 프레임워크를 사용했었다. 그런데 @RequestMapping
기반의 애노테이션 컨트롤러가 등장하면서, MVC 부분도 스프링의 완승으로 끝이 났다.RequestMappingHandlerMapping
RequestMappingHandlerAdapter
RequestMappingHandlerMapping
, RequestMappingHandlerAdapter
이다.@RequestMapping
애노테이션이 있으면, RequestMappingHandlerMapping과 RequestMappingHandlerAdapter가 사용되는 것이다.)
그럼 이제 본격적으로 애노테이션 기반의 컨트롤러를 사용해보자.
지금까지 만들었던 프레임워크에서 사용했던 컨트롤러를 @RequestMapping 기반의 스프링 MVC 컨트롤러로 변경해보자.
회원 등록 폼 컨트롤러
: src > main > java > hello > servlet > web > springmvc > v1 패키지를 생성하고 내부에 SpringMemberFormControllerV1 클래스를 생성하자.@Controller
@Component
애노테이션이 있어서 컴포넌트 스캔의 대상이 됨)@RequestMapping
ModelAndView
👉 RequestMappingHandlerMapping
은 (이게 내가 인식할 수 있는 핸들러인지 아닌지를 어떤식으로 찾냐면) 스프링 빈 중에서 @RequestMapping
또는 @Controller
가 클래스 레벨에 붙어있는 경우에 매핑 정보로 인식한다.
따라서 다음 코드도 동일하게 동작한다.
@RequestMapping
이 있어도 스프링 컨트롤러로 인식하지 않는다. 오직 @Controller
가 있어야 스프링 컨트롤러로 인식한다. 참고로 @RestController 는 해당 애노테이션 내부에 @Controller 를 포함하고 있으므로 인식 된다. 따라서 @Controller 가 없는 위의 두 코드는 스프링 컨트롤러로 인식되지 않는다. ( RequestMappingHandlerMapping 에서 @RequestMapping 는 이제 인식하지 않고, Controller 만 인식한다. )
👉 나머지도 적용해보자.
회원 저장 컨트롤러
: src > main > java > hello > servlet > web > springmvc > v1 패키지 내부에 SpringMemberSaveControllerV1 클래스를 생성하자.mv.addObject("member", member)
: 스프링이 제공하는 ModelAndView
를 통해 Model 데이터를 추가할 때는 addObject()
를 사용하면 된다. 이 데이터는 이후 뷰를 렌더링 할 때 사용된다.회원 목록 컨트롤러
: src > main > java > hello > servlet > web > springmvc > v1 패키지 내부에 SpringMemberListControllerV1 클래스를 생성하자.@RequestMapping
을 잘 보면 클래스 단위가 아니라 메서드 단위에 적용된 것을 확인할 수 있다. 따라서 컨트롤러 클래스를 유연하게 하나로 통합할 수 있다.
통합 컨트롤러
: src > main > java > hello > servlet > web > springmvc > v2 패키지를 생성하고, 내부에 SpringMemberControllerV2 클래스를 생성하자.✔️ 참고
@RequestMapping("/springmvc/v2/members")
@RequestMapping("/new-form")
=> /springmvc/v2/members/new-form@RequestMapping("/save")
=> /springmvc/v2/members/save@RequestMapping
=> /springmvc/v2/members이렇게 컨트롤러를 통합하고 중복 코드를 제거해보았다.
그런데 아직 뭔가가 불편하다. 메소드마다 ModelAndView를 만들어서 반환해야 한다.
다음에는, 이전에 v4 버전에서 뷰의 이름만 반환했던 것처럼 개선해보자.
MVC 프레임워크 만들기에서 v3은 ModelView를 개발자가 직접 생성해서 반환했기 때문에, 불편했던 기억이 날 것이다. 물론 v4를 만들면서 실용적으로 개선한 기억도 날 것이다.
스프링 MVC는 개발자가 편리하게 개발할 수 있도록 수 많은 편의 기능을 제공한다. 실무에서는 지금부터 설명하는 방식을 주로 사용한다.
실용적인 컨트롤러
: src > main > java > hello > servlet > web > springmvc > v3 패키지를 생성하고, 내부에 SpringMemberControllerV3 클래스를 생성하자.✔️ ViewName 직접 반환
✔️ @RequestParam 사용
@RequestParam("username")
은 request.getParameter("username")
와 거의 같은 코드라 생각하면 된다.✔️ Model 파라미터
save()
, members()
를 보면 Model을 파라미터로 받는 것을 확인할 수 있다. 스프링 MVC도 이런 편의 기능을 제공한다. (스프링이 제공하는 Model을 그대로 쓸 수있다.)✔️ @RequestMapping -> @GetMapping, @PostMapping
@RequestMapping
은 URL만 매칭하는 것이 아니라, HTTP Method도 함께 구분할 수 있다. 예를 들어서 URL이 /new-form
이고, HTTP Method가 GET인 경우를 모두 만족하는 매핑을 하려면 다음과 같이 처리하면 된다.✔️ 참고 (도움이 될 만한 출처)
강의를 듣고 정리한 글입니다. 코드와 그림 등의 출처는 김영한 강사님께 있습니다.