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

DispatcherServlet 구조 살펴보기

• 스프링 MVC도 프론트 컨트롤러 패턴으로 구현되어 있다.
• 프론트 컨트롤러가 바로 디스패처 서블릿(DispatcherServlet)이다.
• 디스패처 서블릿이 스프링 MVC의 핵심

 

DispacherServlet 서블릿 등록

• DispacherServlet도 부모 클래스에서 HttpServlet 을 상속 받아서 사용하고, 서블릿으로 동작한다.
  • DispacherServlet → FramewokrServlet → HttpServletBean → HttpServlet
• 스프링 부트는 DispacherServlet 을 서블릿으로 동작하면서 모든 경로(urlPatterns="/")에 대해서 매핑한다.
  • 참고: 더 자세한 경로가 우선순위가 높다.

 

요청 흐름

• 서블릿이 호출되면 HttpServlet이 제공하는 service 메소드가 호출 된다.
• 스프링 MVC는 DispacherServlet의 부모인 FrameworkServlet 에서 Service를 오버라이드 해두었다.
• FrameworkServlet .service()를 시작으로 여러 메서드가 호출되면서 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);
    
}

 

인터페이스 살펴보기

• 스프링 MVC의 큰 강점은 DispatcherServlet 코드의 변경 없이, 원하는 기능을 변경하거나 확장할 수 있다는 점이다.
• 인터페이스들만 구현해서 DispatcherServlet에 등록하면 컨트롤러를 만들 수 있다.

 

Spring MVC 구조

 

 

---

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

컨트롤러 호출이 되려면 2가지가 필요하다.

 

1. HandlerMapping(핸들러 매핑)
   • 핸들러 매핑에서 컨트로러를 찾을 수 있어야 한다.
   • 예) 스프링 빈의 이름으로 핸들러를 찾을 수 있는 핸들러 매핑이 필요하다.
2. HandlerAdapter(핸들러 어댑터)
   • 핸들러 매핑을 통해서 찾은 핸들러를 실행할 수 있는 핸들러 어댑터가 필요하다.
   • Controller 인터페이스를 실행할 수 있는 핸들러 어댑터를 찾고 실행해야한다.

 

public class SimpleControllerHandlerAdapter implements HandlerAdapter {

    @Override
    public boolean supports (Object handler) {
        return (handler instanceof Controller);
    }


	// 이하 생략
}

 

처리 순서

HandlerMapping

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

 

HandlerAdapter

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

 

1. 핸들러 매핑으로 핸들러 조회
   1. HandlerMapping 을 순서대로 실행해서, 핸들러를 찾는다.
   2. 스프링 빈 이름으로 핸들러를 찾아야 하기 때문에, 빈 이름 그대로 핸들러를 찾는다. BeanNameUrlHandlerMapping(1번)이 실행에 성공하고 핸들러를 반환한다.
      → @Component("/springmvc/old-controller") 에 있는 이름으로 찾는다.
2. 핸들러 어댑터 조회
   1. HandlerAdapter의 supports 를 순서대로 호출한다.
      → 0번, 1번, 2번 중에 하나를 지원하면 호출된다.
   2. SimpleControllerHandlerAdapter(2번)가 Controller 인터페이스를 지원하므로 대상이 된다.
3. 핸들러 어댑터 실행
   1. 디스패처 서블릿이 조회한 SimpleControllerHandlerAdapter 를 실행하면 핸들러 정보도 함께 넘겨준다.
   2. SimpleControllerHandlerAdapter는 핸들러를 내부에서 실행하고, 그 결과를 반환한다.

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

 

---

뷰 리졸버

new-form.jsp 를 뷰로 보여주려면 어떻게 해야할까?

 

• application.properties

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

 

@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 new ModelAndView("new-form");
    }
    
}

 

 

처리 순서

• 스프링 부트가 자동 등록하는 뷰 리졸버
  (실제로는 더 많지만, 일부 생략)

 

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

 

1. 핸들러 어댑터 호출
   • 핸들러 어댑터를 통해 논리 뷰 이름(문자열 이름)을 획득한다.
2. ViewResolver 호출
   • 논리 뷰 이름으로 viewResolver를 순서대로 호출
   • BeanNameViewResolver(1번)은 논리 뷰 이름의 스프링 빈으로 등록된 뷰를 찾는데 없다.
   • 그러면 InternalResourceViewResolver(2번)이 호출 된다.
3. InternalResourceViewResolver
   • 해당 뷰 리졸버는 InternalResourceView를 반환한다.
4. 뷰 - InternalResourceView
   • InternalResourceView는 JSP처럼 forward()를 호출해서 처리할 수 있는 경우에 사용한다.
5. view.render()
   • view.render()가 호출되고 InternalResourceView는 forward()를 사용해서 JSP를 실행한다.

 

---

스프링 MVC - 시작하기

스프링이 제공하는 컨트롤러는 애노테이션 기반으로 동작한다.

 

• @Controller
  • 어노테이션 안에는 @Component가 있어서 스프링 빈으로 자동 등록 된다.
  • 스프링 MVC에서 어노테이션 기반 컨트롤러로 인식한다.
    → RequestMappingHandlerMapping은 스프링 빈 중에서 @RequestMapping 또는 @Controller 가
    클래스 레벨에 붙어 있는 경우에 매핑 정보로 인식한다.
• @RequestMapping
  • 요청 정보를 매핑한다. 
  • URL이 호출되면 해당 메소드가 호출된다.

@Target({ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Component
public @interface Controller {
    @AliasFor(
        annotation = Component.class
    )
    String value() default "";
}

 

@Controller
public class SpringMemberFormControllerV1 {

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

 

---

스프링 MVC - 컨트롤러 통합

 

/**
* 클래스 단위 -> 메서드 단위
* @RequestMapping 클래스 레벨과 메서드 레벨 조합
*/
@Controller
@RequestMapping("/springmvc/v2/members")
public class SpringMemberControllerV2 {

	private MemberRepository memberRepository = MemberRepository.getInstance();

    @RequestMapping("/new-form")
    public ModelAndView newForm() {
    	return new ModelAndView("new-form");
    }

    @RequestMapping("/save")
    public ModelAndView save(HttpServletRequest request, HttpServletResponse response) {

        String username = request.getParameter("username");
        int age = Integer.parseInt(request.getParameter("age"));

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

        ModelAndView mav = new ModelAndView("save-result");
        mav.addObject("member", member);
        
        return mav;
    }

    @RequestMapping
    public ModelAndView members() {
        List<Member> members = memberRepository.findAll();

        ModelAndView mav = new ModelAndView("members");
        mav.addObject("members", members);
        
        return mav;
    }

}

 

 

---

스프링 MVC - 실용적인 방식

• @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";
    }

}