(스프링 MVC1) 스프링 MVC구조 이해

짜스의 하루 ·2024년 3월 5일
김영한 - 스프링 MVC1 참조

스프링 MVC 전체 구조

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

**Spring MVC 구조

  • FrontController -> DispatcherServlet
  • handlerMappingMap -> HandlerMapping
  • MyHandlerAdatper-> HandlerAapter
  • ModelView -> ModelAndView
  • viewResolver -> ViewResolver
  • MyView -> View
  • 우리는 viewResolver를 메서드로 만들었지만, 스프링에서는 viewResolver를 인터페이스로 만들었다.
  • 스프링의 View또한 인터페이스로 만들어졌다.

DispatcherServlet
org.springframework.web.servlet.DispatcherServlet

  • 스프링 MVC도 프론트 컨트롤러 패턴으로 구현되어있다.
  • 스프링 MVC의 프론트 컨트롤러가 바로 디스패치 서블릿(DispatcherServlet)이다.
  • DispatcherServlet도 부모 클래스에서 HttpServlet을 상속 받아서 사용하고, 서블릿으로 동작한다
  • 스프링 부트는 DispatcherServlet을 서블릿으로 자동 등록하면서, 모든 경로(urlPattern="/")에 대해서 매핑한다.
    --> 더 자세한 경로가 우선순위가 높다. 그래서 기존에 등록한 서블릿도 함께 등록한다.

SpringMVC 동작 순서

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

인터페이스 살펴보기
스프링 MVC의 큰 강점은 DispatcherServlet 코드의 변경 없이, 원하는 기능을 변경하거나 확장할 수 있다는 점이다. 지금까지 설명한 대부분을 확장 가능할 수 있게 인터페이스로 제공한다.
이 인터페이스들만 구현해서 DispatcherServlet 에 등록하면 여러분만의 컨트롤러를 만들 수도 있다.

주요 인터페이스 목록
핸들러 매핑: org.springframework.web.servlet.HandlerMapping
핸들러 어댑터: org.springframework.web.servlet.HandlerAdapter
뷰 리졸버: org.springframework.web.servlet.ViewResolver
뷰: org.springframework.web.servlet.View

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

과거에는 Controller 인터페이스를 사용하였다.
이 인터페이스로 핸들러 매핑, 핸들러 어댑터를 알아보자

OldController.java

/@Component : 스프링 빈 이름을 URL로 맞추어 사용 가능
@Component("/springmvc/old-controller")
public class OldController implements Controller {
    @Override
    public ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse response) throws Exception {
        System.out.println("OldController.handleRequest");
        
        //뷰리졸버를 만들어주자 -> application.properties
        return new ModelAndView("new-form");
    }
  • @Component에이름을 주어 /springmvc/old-controller 이라는 이름의 스프링 빈을 만들어 등록했다.
  • http://localhost:8080/springmvc/old-controller로 접속 가능하다. 논리명 "new-form"으로 리턴했는데 호출이 정상적으로 된다.

이 컨트롤러는 어떻게 호출이 될까?

  • 우선 핸들러매핑을 통해 컨트롤러를 찾을 수 있어야 하는데, 이 컨트롤러는 스프링 빈으므로 스프링 빈 이름으로 핸들러매핑을 한다.

  • 핸들러 매핑 통해 찾은 핸들러를 실행할 수 있는 어댑터가 필요하다. 여기서는 Controller인터페이스를 실행할 수 있는 핸들러 어댑터가 필요한 것이다.

  • 스프링은 기본적으로 대부분의 핸들러매핑, 핸들러어댑터를 구현해 두었다. 스프링부트는 이것들을 자동으로 등록한다.

HanglerMapping

  • 0순위 : RequestMappingHandlerMapping / 애노테이션 기반 컨트롤러인 @RequestMapping에서 사용
  • 1순위 : BeanNameUrlHandlerMapping/ 스프링 빈 이름으로 핸들러를 찾음 -> OldController

HandlerMapping

  • 0순위: RequestMappingHandlerAdapter/ 애노테이션 기반의 컨트롤러인 @RequestMapping에서 사용
  • 1순위 : HttpRequestHandlerAdapter / HttpRequestHandler 처리
    2순위 : SimpleControllerHandlerAdapter / Controller 인터페이스 처리 -> OldController

매핑은 순위별로 진행한다. 0순위에서 처리 불가하면 1순위로 넘어가는 식이다.
핸들러 조회 -> 핸들러어댑터조회 -> 핸들러어댑터 실행 으로 실행이 된다.

가장 우선순위가 높은 핸들러매핑과 핸들러어댑터는 RequestMappingHandlerMapping이다. @RequestMapping 애노테이션 컨트롤러를 지원한다.

뷰 리졸버

return new ModelAndView("new-form");

위의 코드에 View를 사용할 수 있도록 코드를 추가해 주었다.
실행하면, Whitelabel Error Page 오류가 발생하는 것을 확인할 수 있다.

application.properties 에 prefix, suffix를 설정

#스프링부트 뷰리졸버(InternalResourceViewResolver 자동 등록 / 아래 prefix, suffix 사용해서 등록)
spring.mvc.view.prefix=/WEB-INF/views/
spring.mvc.view.suffix=.jsp

를 등록하면, "/WEB-INF/views/new-form.jsp" 으로 실행이 된다.

뷰 리졸버 - InternalResourceViewResolver
스프링부트는 애플리케이션이 띄워질 떄, 여러가지를 자동등로글 해주는데, 그 중에서 InternalResourceViewResolver이라는 뷰 리졸버도 자동 등록을 해준다.
이때, application.properties에 등록한 spring.mvc.view.prefix, spring.mvc.view.suffix 설정 정보를 사용해서 등록한다.

뷰 리졸버 동작 방식

  • 스프링 부트가 자동 등록하는 뷰 리졸버
    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를 실행한다.

스프링 MVC - 시작하기

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

@RequestMapping

  • 스프링은 애노테이션을 활용한 매우 유연하고, 실용적인 컨트롤러를 만들었는데, 이것이 바로 @RequestMapping 애노테이션이다.
  • handlerMapping = RequestMappingHandlerMapping
    handlerAdapter = RequestMappingHandlerAdapter
    --> 앞서 보았듯이 가장 우선순위가 높은 핸들러 매핑과 핸들러 어댑터는 RequestMappingHandlerMapping , RequestMappingHandlerAdapter 이다.
    --> @RequestMapping 의 앞글자를 따서 만든 이름인데, 이것이 바로 지금 스프링에서 주로 사용하는 애노테이션 기반의 컨트롤러를 지원하는 핸들러 매핑과 어댑터이다.

지금까지 만들었던 프레임워크에서 사용했던 컨트롤러를 @RequestMapping 기반의 스프링 MVC 컨트롤러로 변경해보자.

SpringMemberFormControllerV1

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

  • @Controller : 스프링이 자동으로 스프링 빈에 등록된다. (내부에 @Component 애노테이션이 있어서 컴포넌트 스캔의 대상이 되기 때문)
    --> 스프링 MVC에서 애노테이션 기반 컨트롤러로 인식한다.
    즉 RequestMapppingHandlerMapping에서 매핑시켜줄 수 있는 핸들러로 인식된다는 의미이다.

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

  • ModelAndView : 모델과 뷰 정보를 담아서 반환하면 된다.

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

SpringMemberSaveControllerV1

@Controller
public class SpringMemberSaveControllerV1 {
    private MemberRepository memberRepository = MemberRepository.getInstance();
    
    @RequestMapping("/springmvc/v1/members/save")
    public ModelAndView process(HttpServletRequest request){
        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;
    }
}
  • mv.addObject("member",member): 스프링이 제공하는 ModelAndView를 통해 Model데이터를 추가할 때, addObject()를 사용하면 된다. 이 데이터는 이후 뷰를 렌더링할 때 사용된다.

SpringMemberListControllerV1

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

스프링 MVC - 컨트롤러 통합

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

SpringMemberControllerV2

@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){
        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;
    }
    
    @RequestMapping
    private ModelAndView list(){
        List<Member> members = memberRepository.findAll();
        
        ModelAndView mv = new ModelAndView("members");
        mv.addObject("members", members);
        
        return mv;

    }
}

조합
컨트롤러 클래스를 통합하는 것을 넘어서 조합도 가능하다. 다음 코드는 /springmvc/v2/members 라는 부분에 중복이 있다

  • @RequestMapping("/springmvc/v2/members/new-form")
  • @RequestMapping("/springmvc/v2/members/save")
  • @RequestMapping("/springmvc/v2/members")

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

조합 결과

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

이렇게 컨트롤러를 통합하고, 중복 코드를 제거해 보았다
메소드마다 ModelAndView를 만들어서 반환하는 점이 불편하다.
v4 버전에서 뷰의 이름만 반환했던 것처럼 개선해보자.

스프링 MVC - 실용적인 방식

실용적인 컨트롤러 : SpringMemberControllerV3

profile
짜스의 하루
2024. 01. 02 ~ 백앤드 공부 시작, 2024. 04.01 ~ 프론트 공부 시작
이전 포스트

(스프링 MVC1) 서블릿,JSP, MVC 패턴

다음 포스트

(스프링 MVC1) MVC 프레임워크 만들기

0개의 댓글