[스프링 MVC 5 / 인프런 김영한] 스프링 MVC - 구조 이해

스프링 MVC 전체 구조

• 스프링의 MVC에서의 DispatcherServlet이 바로 Front Controller이다.
• 스프링 부트는 DispatcherServlet을 서블릿으로 자동으로 등록하면서 모든 경로(urlPatterns="/")에 대해 매핑.
• DispatcherServlet은 플러그인 구조(전략 패턴)를 사용해서, 다양한 방식의 컨트롤러를 유연하게 처리할 수 있다.
  (예: @RequestMapping, SimpleController, HttpRequestHandler 등

직접 만든 MVC 프레임워크 구조

스프링 MVC 구조

 

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

 

1. 핸들러 조회: 핸들러 매핑을 통해 요청 URL에 매핑된 핸들러(컨트롤러)를 조회한다.
2. 핸들러 어댑터 조회: 핸들러를 실행할 수 있는 핸들러 어댑터를 조회한다.
3. 핸들러 어댑터 실행: 핸들러 어댑터를 실행한다.
4. 핸들러 실행: 핸들러 어댑터가 실제 핸들러를 실행한다. 
5. ModelAndView 반환: 핸들러 어댑터는 핸들러가 반환하는 정보를 ModelAndView로 변환해서 반환한다.
6. viewResolver 호출: 뷰 리졸버를 찾고 실행한다. JSP의 경우: InternalResourceViewResolver가 자동 등록되고, 사용된다.
7. View 반환: 뷰 리졸버는 뷰의 논리 이름을 물리 이름으로 바꾸고, 렌더링 역할을 담당하는 뷰 객체를 반환한다. JSP의 경우 InternalResourceView(JstlView) 를 반환하는데, 내부에 forward() 로직이 있다.
8. 뷰 렌더링: 뷰를 통해서 뷰를 렌더링 한다.

 

 

 

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

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

• http://localhost:8080/springmvc/old-controller -> 이 컨트롤러는 어떻게 호출될 수 있을까?
• HandlerMapping: 핸들러 매핑에서 해당 컨트롤러를 찾을 수 있어야 함.
  0 = RequestMappingHandlerMapping: 애노테이션 기반의 컨트롤러인 @RequestMapping에서 사용
  1 = BeanNameUrlHandlerMapping: 스프링 빈의 이름으로 핸들러를 찾는다.
  
  
• HandlerAdapter: 해당 컨트롤러를 실행할 수 있는 핸들러 어댑터가 있어야 함.
  0 = RequestMappingHandlerAdapter: 애노테이션 기반의 컨트롤러인 @RequestMapping에서 사용
  1 = HttpRequestHandlerAdapter: HttpRequestHandler 처리
  2 = SimpleControllerHandlerAdapter: Controller 인터페이스(애노테이션X, 과거에 사용) 처리
  
  

 

핸들러 매핑은 '무엇을 실행할지'를 찾고, 핸들러 어댑터는 '어떻게 실행할지'를 결정한다.

 

 

 

 

1. 핸들러 매핑으로 핸들러 조회: HandlerMapping을 순회해서 BeanNameUrlHandlerMapping을 통해  OldController를 찾음.
2. 핸들러 어댑터 조회: HandlerApapter의 supports()가 true를 반환하는 어댑터를 찾음. SimpleControllerHandlerAdapter가 Controller 인터페이스를 지원해서 조회 대상이 됨.
3. 핸들러 어댑터 실행: 디스패처 서블릿이 조회한 SimpleControllerHandlerAdapter를 실행하면서 핸들러 정보도 넘겨줌. SimpleControllerHandlerAdapter가 핸들러인 OldController를 내부에서 실행하고 결과를 반환함.

 

 

 

뷰 리졸버

• 논리 이름(viewName) → 물리 경로(view 객체)로 변환하는 컴포넌트
• 컨트롤러는 "new-form" 같은 논리 이름만 반환하고, DispatcherServlet은 이 이름을 실제 뷰로 보여줄 수 없으므로
  → ViewResolver가 이 작업을 대신 수행한다.

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

• new-form → /WEB-INF/views/new-form.jsp 로 변환. 그리고 forward를 통해 JSP를 실행할 수 있도록 View 객체를 만들어서 넘겨준다.
  
  ✅ InternalResourceViewResolver의 역할
  
  • 스프링 부트는 기본적으로 InternalResourceViewResolver를 등록. JSP를 사용하기 위한 표준 뷰 리졸버임.
    spring.mvc.view.prefix=/WEB-INF/views/
    spring.mvc.view.suffix=.jsp
  • 위 설정에 따라 동작함.
  ✅ 스프링 부트가 자동 등록하는 뷰 리졸버
  
  • 1 = BeanNameViewResolver: 빈 이름으로 뷰를 찾아서 반환한다. (예: 엑셀 파일 생성 기능 에 사용)
  • 2 = InternalResourceViewResolver: JSP를 처리할 수 있는 뷰를 반환한다.
  
  
• Thymeleaf 사용 시에는 ThymeleafViewResolver가 대신 동작함 (포워드 필요 없음, 바로 렌더링)

 

1. Controller 실행 결과로 ModelAndView("논리 이름") 반환
2. DispatcherServlet이 ViewResolver 목록을 순서대로 탐색
3. supports()로 해당 이름을 처리할 수 있는 ViewResolver 찾음
   -> resolveViewName()을 호출했을 때 null이 아닌 View를 반환하는 ViewResolver
4. InternalResourceViewResolver가 동작 → prefix + viewName + suffix 조합
5. View 객체(InternalResourceView) 생성
6. view.render(model, request, response) 호출 → 내부적으로 forward() 실행

 

 

 

스프링 MVC - 시작하기

✅ @RequestMapping

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

@Controller
public class SpringMemberFormControllerV1 {

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



// ----------------------------------------------------------------------



@Controller
public class SpringMemberListControllerV1 {

    private MemberRepository memberRepository = MemberRepository.getInstance();

    @RequestMapping("/springmvc/v1/members")
    public ModelAndView process() {
        List<Member> members = memberRepository.findAll();

        ModelAndView mv = new ModelAndView("members");
        mv.addObject("members", members);

        return mv;
    }
}



// ----------------------------------------------------------------------



@Controller
public class SpringMemberSaveControllerV1 {

    private MemberRepository memberRepository = MemberRepository.getInstance();

    @RequestMapping("/springmvc/v1/members/save")
    public ModelAndView process(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 mv = new ModelAndView("save-result");
        mv.addObject("member", member);

        return mv;
    }
}

• @Controller: 스프링이 자동으로 스프링 빈으로 등록해서, 컴퍼넌트 스캔의 대상이 되도록 함. 스프링 MVC에서 애노테이션 기반 컨트롤러로 인식함. -> 꺼낼 수 있는 핸들러로 인식함.
• @RequestMapping: 해당 URL이 호출되면, 이 메서드가 호출됨. 애노테이션 기반으로 동작해서 메서드 이름은 뭘로 해도 호출됨.
• ModelAndView에 논리 경로를 반환해주면 됨.
• 즉, URL-컨트롤러 매핑 / 핸들러 어댑터 및 핸들러 등록 / 뷰 리졸버 처리 등의 작업을 모두 스프링에서 처리해줌.
  -> 핵심 구조는 유지하되, 반복과 보일러플레이트는 제거

 

 

 

스프링 MVC - 컨트롤러 통합

• 도메인 기능 단위로 묶음. 공통 prefix URL 중복 제거.

@Controller
@RequestMapping("/springmvc/v2/members") // + 메서드 RequestMapping의 url -> 공통 prefix URL 제거
public class SpringMemberControllerV2 {

    private MemberRepository memberRepository = MemberRepository.getInstance();

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

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

        ModelAndView mv = new ModelAndView("members");
        mv.addObject("members", members);

        return mv;
    }

    @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 mv = new ModelAndView("save-result");
        mv.addObject("member", member);

        return mv;
    }
}

 

 

 

 

스프링 MVC - 실용적인 방식

@Controller
@RequestMapping("/springmvc/v3/members")
public class SpringMemberControllerV3 {

    private MemberRepository memberRepository = MemberRepository.getInstance();

    // @RequestMapping(value = "/new-form", method = RequestMethod.GET)
    @GetMapping("/new-form")
    public String newForm() {
        return "new-form";
    }

    // @RequestMapping(method = RequestMethod.GET)
    @GetMapping
    public String members(Model model) {
        List<Member> members = memberRepository.findAll();

        model.addAttribute("members", members);

        return "members";
    }

    // @RequestMapping(value = "/save", method = RequestMethod.POST)
    @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";
    }
}

 

 

기존 방식	현재
HttpServletRequest, HttpServletResponse 직접 사용	생략됨
request.getParameter()	@RequestParam 사용
request.setAttribute("member", obj)	model.addAttribute() 사용
ModelAndView	단순 문자열 반환으로 대체 가능
URL 전체 매핑	클래스 레벨에서 공통 prefix 분리(@RequestMapping)
반복적인 @RequestMapping(method = ~)	@GetMapping, @PostMapping 도입

 

 

스프링 MVC 구조

 

 

"필요한 정보만 선언적으로 기술하면, 나머지는 프레임워크가 처리해준다."