[Spring] 스프링 MVC 1편 5) 스프링 MVC 구조이해

스프링 MVC 1편 백엔드 웹 개발 핵심 기술 

Session 5 스프링 MVC 구조이해

1. 스프링 MVC 전체 구조

1) 스프링 MVC 구조

 

2) DispatcherServlet 구조 살펴보기

스프링 MVC도 프론트 컨트롤러 패턴으로 구현되어 있다. 

스프링 MVC의 프론트 컨트롤러가 DispatcherServlet 스프링 MVC의 핵심이다.

 

3) DispatcherServlet 서블릿 등록

DispatcherServlet도 부모 클래스에서 HttpServlet을 상속받아 사용, 서블릿으로 동작

스프링 부트는 DispatcherServlet을 서블릿으로 자동 등록하면서 모든 경로에 대하여 매핑

→ 더 자세한 경로가 우선순위가 높음, 그래서 기존에 등록한 서블릿도 함께 동작

 

4) 요청 흐름

서블릿 호출되면 HttpServlet이 제공하는 service() 호출

스프링 MVC는 DispatcherServlet 부모인 FrameworkServlet에서 service()를 오버라이드 해둠

FrameworkServlet.service()를 시작으로 여러 메서드가 호출되면서 DispatcherServlet.doDispatch()가 호출 

 

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

 

6) 스프링 MVC 구조 동작 순서

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

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

3. 핸들러 어댑터 실행 : 핸들러 어댑터 실행

4. 핸들러 실행 : 핸들러 어댑터가 실제 핸들러 실행

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

6. viewResolver 호출 : 뷰 리졸버를 찾고 실행, jsp경우 InternalResourceViewResolver 자동 등록되고 사용됨

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

8. 뷰 렌더링 : 뷰 통해서 렌더링

 

7) 인터페이스 살펴보기

스프링 MVC의 큰 강점은 DispatcherServlet 코드 변경없이 원하는 기능을 변경하거나 확장할 수 있다는 점

확장 가능할 수 있게 인터페이스로 제공

 

8) 정리

스프링 MVC는 복잡해서 내부 구조를 다 파악하기 쉽지 않다.

웹 애플리케이션을 만들 때 필요한 대부분의 기능이 이미 다 구현되어있어 실제 직접 확장하는 일은 없음

핵심 동작 방식을 알아두어야 문제 발생할 때 쉽게 파악 가능하고, 확장 포인트가 필요할 때 어느 부분을 확장해야 할지 알 수 있다.

---

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

1) 과거버전 스프링 컨트롤러

@Controller와 전혀 다름!!

@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") → /springmvc/old-controller라는 이름의 스프링 빈으로 등록

빈의 이름으로 URL을 매핑

 

2) OldController 동작

-HandlerMapping

핸들러 매핑에서 이 컨트롤러를 찾을 수 있어야 함

→스프링 빈 이름으로 핸들러를 찾을 수 있는 핸들러 매핑 필요

-HandlerAdapter

핸들러 매핑을 통해서 찾은 핸들러를 실행할 수 있는 핸들러 어댑터 필요

→Controller 인터페이스를 실행할 수 있는 핸들러 어댑터 찾고 실행

▶스프링은 이미 핸들러 매핑과 핸들러 어댑터를 대부분 구현

 

3) 스프링 부트가 자동 등록하는 핸들러 매핑과 핸들러 어댑터

실제로는 더 많지만 중요한 부분 위주로 작성, 숫자는 우선순위 의미

-HandlerMapping

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

-HandlerAdapter

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

-OldController 동작

HandlerMapping 순서대로 실행하며 핸들러 찾음 OldController의 경우 빈이름으로 찾아야 하기 때문에 BeanNameUrlHandlerMapping가 실행에 성공하고 핸들러인 OldController를 반환

HandlerAdapter의 supports()가 순서대로 호출

SimpleControllerHandlerAdapter가 Controller 인터페이스를 지원하므로 대상이 됨

디스패처 서블릿이 조회한 SimpleControllerHandlerAdapter를 실행하면서 핸들러 정보도 함께 넘겨준다

SimpleControllerHandlerAdapter는 핸들러인 OldController를 내부에서 실행하고 결과반환

 

4) HttpRequestHandlerAdapter

핸들러 매핑과 어댑터를 더 이해하기 위해 Controller 인터페이스가 아닌 다른 핸들러 알아보자

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

-MyRequestHandler 동작

HandlerMapping 순서대로 실행하며 핸들러 찾음 MyRequestHandler의 경우 빈이름으로 찾아야 하기 때문에 BeanNameUrlHandlerMapping가 실행에 성공하고 핸들러인 MyRequestHandler를 반환

HandlerAdapter의 supports()가 순서대로 호출

HttpRequestHandlerAdapter가 HttpRequestHandler 인터페이스를 지원하므로 대상이 됨

디스패처 서블릿이 조회한 HttpRequestHandlerAdapter를 실행하면서 핸들러 정보도 함께 넘겨준다

HttpRequestHandlerAdapter는 핸들러인 MyRequestHandler를 내부에서 실행하고 결과반환

 

5) @RequestMapping

가장 우선순위가 높은 핸들러 매핑과 핸들러 어댑터는 RequestMappingHandlerMapping, RequestMappingHandlerAdapter이다.

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

실무에서는 대부분 이 방식의 컨트롤러를 사용

---

3. 뷰 리졸버

1) OldController view 조회할 수 있도록 변경

@Override
public ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse response) throws Exception {
    System.out.println("OldController.handleRequest");
    return new ModelAndView("new-form");
}

 

2) application.properties 코드추가

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

 

3) 뷰 리졸버 InternalResourceViewResolver

스프링 부트는 InternalResourceViewResolver 뷰 리졸버를 자동 등록할 때 application.properties에 등록한 prefix, suffix 설정 정보를 사용해 등록

1 = BeanNameViewResolver :빈 이름으로 뷰를 찾아서 반환한다. (예: 엑셀 파일 생성기능에 사용)
2 = InternalResourceViewResolver : JSP를 처리할 수 있는 뷰를 반환

 

4) 뷰 리졸버 동작 방식

핸들러 어댑터 통해 new-form이라는 논리 뷰 이름 획득

viewResolver를 순서대로 호출 InternalResourceViewResolver가 호출되고 InternalResourceView를 반환

InternalResourceView는 JSP처럼 forward() 기능이 있음

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

 

5) 참고

InternalResourceViewResolver는 jstl 라이브러리가 있으면 InternalResourceView를 상속받은 JstlView 반환

jsp의 경우 forward()통해 해당 jsp로 이동해야 렌더링 됨 나머지 뷰 템플릿은 forward() 과정 없이 바로 렌더링

---

4. 스프링 MVC 시작하기

1) @RequestMapping

애노테이션 기반의 컨트롤러, 유연하고 실용적

 

2) SpringMemberFormControllerV1 생성

@Controller
public class SpringMemberFormControllerV1 {
    @RequestMapping("/springmvc/v1/members/new-form")
    public ModelAndView process() {
        return new ModelAndView("new-form");
    }
}

@Controller : 스프링이 자동으로 스프링 빈으로 등록, 스프링 mvc에서 애노테이션 기반 컨트롤러로 인식

@RequestMapping : 요청 정보를 매핑, 해당 URL이 호출되면 이 메서드 호출, 애노테이션 기반으로 동작하기 때문에 메서드 이름은 임의로 지으면 된다.

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

RequestMappingHandlerMapping은 스프링 빈 중에서 @Controller가 클래스 레벨에 붙어 있는 경우에 매핑 정보로 인식

---

5. 스프링 MVC 컨트롤러 통합

1) 컨트롤러 통합과 조합

@RequestMapping을 보면 클래스 단위가 아니라 메서드 단위에 적용되어있다.

→ 컨트롤러 클래스를 유연하게 하나로 통합할 수 있다.

클래스 레벨에 @RequestMapping을 두면 메서드 레벨과 조합된다.

@Controller
@RequestMapping("/springmvc/v2/members")
public class SpringMemberControllerV2 {
	private MemberRepository memberRepository = MemberRepository.getInstance();
    
	@RequestMapping("/new-form")
	public ModelAndView newForm() {
    
	...
	@RequestMapping("/save")
	public ModelAndView save(HttpServletRequest request, HttpServletResponse response) {
	
    ...
}

---

6. 스프링 MVC 실용적인 방식

1) SpringMemberControllerV3

/**
* v3
* Model 도입
* ViewName 직접 반환
* @RequestParam 사용
* @RequestMapping -> @GetMapping, @PostMapping */
@Controller
@RequestMapping("/springmvc/v3/members")
public class SpringMemberControllerV3 {

    private MemberRepository memberRepository = MemberRepository.getInstance();
    
    // @RequestMapping(value = "/new-form", method = RequestMethod.GET) // HTTP 메서드 제약
    @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";
    }

    ...
}

Model 파라미터 : Model을 파라미터로 받음

viewName : ModelAndView 객체를 반환하는 것이 아닌 뷰의 이름을 직접 반환

@RequestParam : HTTP 요청 파라미터를 @RequestParam으로 받음

@RequestMapping → @GetMapping, @PostMapping : HTTP 메서드를 구분해 사용, method = RequestMethod.GET 지정하던 것을 @GetMapping 애노테이션으로 편리하게 사용