[Spring] 스프링 MVC 핵심 기술 - 스프링 MVC 구조 이해

이글은 스프링 MVC 1편 - 백엔드 웹 개발 핵심 기술 강의를 학습 후 
나중에 다시 복습하기 위해 정리한 글입니다.
문제시 비공개로 처리하겠습니다.

스프링 MVC 1편 - 백엔드 웹 개발 핵심 기술 - 인프런 | 강의

 

목차

1. 스프링 MVC 전체 구조
2. 핸들러 매핑과 핸들러 어댑터
3. 뷰 리졸버
4. 스프링 MVC로 변환

---

1. 스프링 MVC 전체 구조

직접 만든 MVC 프레임워크  와 스프링 MVC 를 비교해보자.

- 직접 만든 MVC 프레임워크 구조 (v5)

- 스프링 MVC 구조

비교

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

DispatcherServlet 

이 클래스도 부모 클래스에서 HttpServlet을 상속 받아서 사용하고, 서블릿으로 동작한다.

(DispatcherServlet -> FrameworkServlet -> HttpServletBean -> HttpServlet)

 

스프링 부트는 DispatcherServlet을 서블릿으로 자동 등록하면서 모든 경로(urlPatterns="/")에 대해 매핑한다.

 

- 요청흐름

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

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

---

2. 핸들러 매핑과 핸들러 어댑터

스프링은 이미 필요한 핸들러 매핑과 핸들러 어댑터를 대부분 구혔해두었다. 

개발자가 직접 만들일은 없을 것이다.

HandlerMapping

// 0 : 애노테이션 기반의 컨트롤러인 @RequestMapping 에서 사용
RequestMappingHandlerMapping 

// 1 : 스프링 빈의 이름으로 핸들러를 찾는다.
BeanNameUrlHandlerMapping

HandlerAdapter

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

// 1 : HttpRequestHandler 처리
HttpRequestHandlerAdapter

// 2 : Controller 인터페이스 처리 (어노테이션 x, 과거에 사용)
SimpleControllerHandlerAdapter

 

핸들러 매핑도, 핸들러 어댑터도 모두 순서대로 찾고 만약 없으면 다음 순서로 넘어간다.

(실제로는 더 많지만, 일부는 생략)

@RequestMapping

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

RequestMappingHandlerMapping, RequestMappingHandlerAdapter 이다.

 

이것이 바로 지금 스프링에서 주로 사용하는 애노테이션 기반의 컨트롤러를 지원하는 매핑과 어댑터이다.

실무에선 주로 이 방식의 컨트롤러를 사용한다.

---

3. 뷰 리졸버

스프링 부트에선 

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

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

스프링 부트에선

InternalResourceViewResolver 라는 뷰 리졸버를 자동으로 등록하는데, 이때 

application.properties 에 등록한 prefix, suffix 설정 정보를 사용해서 등록한다.

스프링 부트가 자동 등록하는 뷰 리졸버

(실제로는 더 많지만, 일부 생략)

// 1 : 빈 이름으로 뷰를 찾아서 반환한다.
BeanNameViewResolver

// 2 : JSP 를 처리할 수 있는 뷰를 반환한다.
InternalResourceViewResolver

 

만약 빈 이름으로 등록된 뷰가 있다면 BeanNameViewResolver 가 호출이 되지만

없다면 InternalResourceViewResolver가 호출된다.

 

ex) 핸들러 어댑터를 통해 new-form 이라는 논리 뷰 이름을 획득한다.

return new ModelAndView("new-form");

new-form 이라는 뷰 이름으로 viewResolver를 순서대로 호출한다.

스프링 빈으로 등록된 뷰를 찾는데 없다면 InternalResourceViewResolver 가 호출된다.

 

InternalResourceViewResolver 이 뷰 리졸버는 InternalResourceView 를 반환한다.

InternalResourceView 는 JSP 처럼 포워드(forward() )를 호출해서 처리할 수 있는 경우에 사용한다.

view.render() 가 호출되고 InternalResourceView는 forward()를 사용해서 JSP를 실행한다.

 

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

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

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

---

4. 스프링 MVC로 변환

스프링이 제공하는 컨트롤러는 애노테이션 기반으로 동작해서 매우 유연하고 실용적이다.

실무에서 자주 사용하는 스프링 MVC로 예제

/**
 * Model 도입
 * ViewName 직접 입력
 * @RequestParam 사용
 * @RequestMapping -> @GetMapping , @PostMapping
 */
@Controller
@RequestMapping("/springmvc/v3/members")
public class SpringMemberControllerV3 {
    private MemberRepository memberRepository = MemberRepository.getInstance();

    @GetMapping("/new-form")
    public String newForm(){
        return "new-form";
    }

    @PostMapping("/save")
    public String save(
            @RequestParam("username") String username,
            @RequestParam("age") int age,
            Model model) {

        Member member = new Member(username, age);
        memberRepository.save(member);

        model.addAttribute("member",member);
        return "save-result";
    }

    @GetMapping
    public String members(Model model){
        List<Member> members = memberRepository.findAll();
        model.addAttribute("members",members);
        return "members";
    }
}

Model 파라미터

스프링 MVC가 제공하는 편의기능.

Model 객체에 model.addAttribute("member",member) 로 담아주면 

return "save-result" 로 viewName을 리턴할 때 

핸들러 어댑터에서 ModelAndView로 Model 과 View를 담아서 DispatcherServlet에 반환한다.

ViewName 직접 반환

뷰의 논리 이름을 반환할 수 있다.

return "save-result" 처럼

@RequestMapping -> @GetMapping, @PostMapping

@RequestMapping은 URL만 매칭하는 것이 아닌, HTTP Method도 함꼐 구분할 수 있다. 

@RequestMapping(value="/new-form", method=RequestMethod.GET)
// ->
@GetMapping("/new-form")

참고 : Get, Post, Put, Delete, Patch 도 모두 애노테이션으로 준비되어 있다.