스프링MVC5_구조 이해

하도야지·2021년 7월 26일

spring mvc

Spring MVC

목록 보기

5/7

(1) 스프링 MVC 전체구조

1. 구조 비교

직접 만든 MVC 프레임 워크 구조
SpringMVC 구조
직접 만든 프레임워크와 스프링 MVC 비교

FrontController -> DispatcherServlet
handlerMappingMap -> HandlerMapping
MyHandlerAdapter -> HandlerAdapter
ModelView -> ModelAndView
viewResolver -> ViewResolver
MyView -> View

2. DispatcherServlet 구조 살펴보기

스프링MVC의 핵심

org.springframework.web.servlet.DispatcherServlet
-> 스프링 MVC도 프론트 컨트롤러 패턴으로 구현되어 있음
--> 스프링 MVC의 프론트 컨트롤러가 디스패처 서블릿 이다.
DispacherServlet 서블릿 등록
-> DispacherServlet도 부모 클래스에서 HttpServlet을 상속받아서 사용하며, 서블릿으로 동작함
--> DispatcherServlet FrameworkServlet HttpServletBean HttpServlet
-> 스프링부트에서는 DispacherServlet을 서블릿으로 자동 등록하면서, 모든 경로(urlPatterns="/" ))에 대해서 매핑한다
--> 더 자세한 경로가 우선순위가 높음

3. 요청 흐름

서블릿이 호출되면 HttpServlet이 제공하는 service()가 호출된다.
스프링 MVC 는 DispatcherServlet-> FrameworkServlet에서 service()를 오버라이드 해 두었다.
FrameworkServlet.service() -> DispacherServlet.doDispatch() 호출

4. DispacherServlet.doDispatch()
DispacherServlet의 핵심

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

5. SpringMVC 구조

동작 순서

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

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

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

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

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

viewResolver 호출: 뷰 리졸버를 찾고 실행한다.
JSP의 경우: InternalResourceViewResolver 가 자동 등록되고, 사용된다.

View 반환: 뷰 리졸버는 뷰의 논리 이름을 물리 이름으로 바꾸고, 렌더링 역할을 담당하는 뷰 객체를
반환한다.
JSP의 경우 InternalResourceView(JstlView) 를 반환하는데, 내부에 forward() 로직이 있다.

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

인터페이스 살펴보기
-> 스프링 MVC의 강점은 DispatcherServlet 코드의 변경 없이, 원하는 기능을 변경하거나 확장 가능
-> 인터페이스를 구현하여 DispatcherServlet 등록 시 본인만의 컨트롤러 생성 가능
주요 인터페이스 목록
-> 핸들러 매핑: org.springframework.web.servlet.HandlerMapping
-> 핸들러 어댑터: org.springframework.web.servlet.HandlerAdapter
-> 뷰 리졸버: org.springframework.web.servlet.ViewResolver
-> 뷰: org.springframework.web.servlet.View

6. 정리

스프링 MVC는 코드 분량도 매우 많고, 복잡해서 내부 구조를 다 파악하는 것은 쉽지 않다.
해당 기능을 직접 확장하거나 나만의 컨트롤러를 만드는 일은 없으므로 걱정하지 않아도 된다.
-> 스프링 MVC는 전세계 수 많은 개발자들의 요구사항에 맞추어 기능을 계속 확장왔고, 그래서 여러분이 웹애플리케이션을 만들 때 필요로 하는 대부분의 기능이 이미 다 구현되어 있다.
그래도 이렇게 핵심 동작방식을 알아두어야 향후 문제가 발생했을 때 어떤 부분에서 문제가 발생했는지 쉽게 파악하고, 문제를 해결할 수 있다.
-> 그리고 확장 포인트가 필요할 때, 어떤 부분을 확장해야 할지 감을 잡을 수 있다.

(2) 핸들러 매핑과 핸들러 어댑터

1. Controller 인터페이스

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

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

2. OldController.java - 자체 구현

-> @Component : /springmvc/old-controller 라는 이름의 스프링 빈으로 등록
--> 빈의 이름으로 URL 매핑

3. 어떻게 컨트롤러가 호출될 수 있을까?

컨트롤러 호출을 위해선 핸들러 매핑, 핸들러 어댑터가 필요함

HandlerMapping(핸들러 매핑)
핸들러 매핑에서 이 컨트롤러를 찾을 수 있어야 한다.
-> 예) 스프링 빈의 이름으로 핸들러를 찾을 수 있는 핸들러 매핑이 필요하다.

HandlerAdapter(핸들러 어댑터)
핸들러 매핑을 통해서 찾은 핸들러를 실행할 수 있는 핸들러 어댑터가 필요하다.
-> 예) Controller 인터페이스를 실행할 수 있는 핸들러 어댑터를 찾고 실행해야 한다.

스프링은 이미 필요한 핸들어 매핑과 핸들어 어댑터를 구현해 둠
스프링 부트가 자동 등록하는 핸들러 매핑과 핸들러 어댑터

HandlerMapping

0 = RequestMappingHandlerMapping : 애노테이션 기반의 컨트롤러인 @RequestMapping에서
사용
1 = BeanNameUrlHandlerMapping : 스프링 빈의 이름으로 핸들러를 찾는다.

HandlerAdapter

0 = RequestMappingHandlerAdapter : 애노테이션 기반의 컨트롤러인 @RequestMapping에서
사용
1 = HttpRequestHandlerAdapter : HttpRequestHandler 처리
2 = SimpleControllerHandlerAdapter : Controller 인터페이스(애노테이션X, 과거에 사용)
처리

동작 순서

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

핸들러 어댑터 조회
-> HandlerAdapter 의 supports() 를 순서대로 호출한다.
--> SimpleControllerHandlerAdapter 가 Controller 인터페이스를 지원하므로 대상이 된다.

핸들러 어댑터 실행
-> 디스패처 서블릿이 조회한 SimpleControllerHandlerAdapter 를 실행하면서 핸들러 정보도 함께 넘겨준다.
--> SimpleControllerHandlerAdapter 는 핸들러인 OldController 를 내부에서 실행하고, 그 결과를 반환한다.

정리

OldController 를 실행하면서 사용된 객체는 다음과 같다.
HandlerMapping = BeanNameUrlHandlerMapping
HandlerAdapter = SimpleControllerHandlerAdapter

4. HttpRequestHandler

서블릿과 가장 유사한 형태의 핸들러

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

5. MyHttpRequestHandler.java - 자체 구현

동작 순서

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

핸들러 어댑터 조회
-> HandlerAdapter 의 supports() 를 순서대로 호출한다.
-> HttpRequestHandlerAdapter 가 HttpRequestHandler 인터페이스를 지원하므로 대상이 된다.

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

정리

MyHttpRequestHandler 를 실행하면서 사용된 객체는 다음과 같다
HandlerMapping = BeanNameUrlHandlerMapping
HandlerAdapter = HttpRequestHandlerAdapter

6. @RequestMapping

가장 우선순위가 높은 핸들러 매핑과 핸들러어댑터

RequestMappingHandlerMapping
RequestMappingHandlerAdapter

스프링에서 주로 사용하는 애노테이션 기반의 컨트롤러 지원 매핑, 어댑터
실무에서 99.9% 이방식 컨트롤러 사용

(3) 뷰 리졸버

1. 뷰 리졸버 세팅

OldCOntroller - view 조회 처리

-> return new ModelAndView("new-form"); 추가
application.properties 세팅

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

2. 뷰 리졸버 - InternalResourceViewResolver

스프링 부트는 InternalResourceViewResolver 라는 뷰 리졸버를 자동으로 등록
-> application.properties 에 등록한 spring.mvc.view.prefix , spring.mvc.view.suffix 설정 정보를 사용해서 등록한다.
권장하지는 않으나 설정 없이 다음과 같이 전체 경로를 주어도 동작은 한다.
-> return new ModelAndView("/WEB-INF/views/new-form.jsp");

3. 뷰 리졸버 동작 방식

스프링부트가 자동 등록하는 뷰 리졸버(핵심만)

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를 실행한다.

참고


- InternalResourceViewResolver 는 만약 JSTL 라이브러리가 있으면 InternalResourceView 를
상속받은 JstlView 를 반환한다. JstlView 는 JSTL 태그 사용시 약간의 부가 기능이 추가된다.

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

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

(4) 스프링 MVC 시작하기

1. @RequestMapping

@RequestMapping : 스프링 진영에서 만든 애노테이션을 활용한 매우 유연하고, 실용적인 컨트롤러
-> @RequestMapping 애노테이션을 사용하는 컨트롤러
과거에는 스프링 프레임워크가 MVC 부분이 약해서 스프링을 사용하더라도 MVC 웹 기술은 스트럿츠 같은 다른 프레임워크를 사용했었다.
-> 이후 @RequestMapping 기반의 애노테이션 컨트롤러가
등장하면서, MVC 부분도 스프링을 사용함.

@RequestMapping
- RequestMappingHandlerMapping : 핸들러 매핑
- RequestMappingHandlerAdapter : 핸들러 어댑터

2. 애노테이션 기반 컨트롤러 사용하기

SpringMemberFormControllerV1.java - 회원 등록 폼

@Controller
-> 스프링이 자동으로 스프링 빈으로 등록한다. (내부에 @Component 애노테이션)
-> 스프링 MVC 에서 애노테이션 기반 컨트롤러로 인식

@RequestMapping
-> 요청 정보를 매핑
-> 해당 URL이 호출되면 이 메서드가 호출됨

ModelAndView : 모델과 뷰 정보를 담아서 반환

(참고) RequestMappingHandlerMapping 은 스프링 빈 중에서 @RequestMapping 또는 @Controller 가
클래스 레벨에 붙어 있는 경우에 매핑 정보로 인식한다.

SpringMemberSaveControllerV1.java - 회원 저장

mv.addObject("member", member)
-> 스프링이 제공하는 ModelAndView 를 통해 Model 데이터를 추가할 때는 addObject() 를 사용.
--> 이 데이터는 이후 뷰를 렌더링 할 때 사용된다

SpringMemberListControllerV1.java - 회원 목록

(5) 스프링 MVC 컨트롤러 통합

@RequestMapping 을 잘 보면 클래스 단위가 아니라 메서드 단위에 적용된 것을 확인할 수 있다.
따라서 컨트롤러 클래스를 유연하게 하나로 통합할 수 있다.

SpringMemberControllerV2.java
RequestMapping 조합
-> /springmvc/v2/members 중복 부분을 조합처리하여 제거

클래스 레벨 @RequestMapping("/springmvc/v2/members")
- 메서드 레벨 @RequestMapping("/new-form") /springmvc/v2/members/new-form
- 메서드 레벨 @RequestMapping("/save") /springmvc/v2/members/save
- 메서드 레벨 @RequestMapping /springmvc/v2/members

(5) 스프링 MVC 실용적인 방식

실무에서는 지금부터 설명하는 방식을 주로 사용한다.

1. 실무에서 사용하는 스프링MVC 방식

SpringMemberControllerV3.java

Model 파라미터
: save() , members() 를 보면 Model을 파라미터로 받는 것을 확인할 수 있다.

ViewName 직접 반환
: 뷰의 논리 이름을 반환할 수 있다.

@RequestParam 사용
: 스프링은 HTTP 요청 파라미터를 @RequestParam 으로 받을 수 있다.
-> @RequestParam("username") 은 request.getParameter("username") 와 거의 같은 코드라 생각하면 된다.

@RequestMapping -> @GetMapping, @PostMapping
: @RequestMapping 은 URL만 매칭하는 것이 아니라, HTTP Method도 함께 구분할 수 있다.
-> @GetMapping , @PostMapping 으로 더 편리하게 사용할 수 있다.( Get, Post, Put, Delete, Patch )

하도야지

프로그래머를 꿈꾸는 코더

이전 포스트

스프링MVC4_프레임워크 만들기

다음 포스트