5. 스프링 MVC - 구조 이해

Joo·2022년 11월 17일

Spring

스프링 MVC 1편

목록 보기

5/7

5.1 전체 구조

직접 만든 프레임워크와 거의 동일
- FrontController → DispatcherServlet
  - DispatcherServlet도 서블릿으로 동작
    - HttpServlet의 상속을 받음
      - DispatcherServlet → FrameworkServlet → HttpServletBean → HttpServlet
  - 스프링 부트가 시작하면서 서블릿으로 DispatcherSevlet 자동 등록
  - 모든 경로(url=”/”)에 대해서 매핑 → 클라이언트가 어떤 경로로 요청하든 실행되는 서블릿
  - 이 서블릿의 service() 메소드가 호출
    - 정확히는 FrameworkServlet에서 오버라이드한 service() 메소드가 실행
    - service() 메소드를 시작으로 DispatcherServlet.doDispatch()가 호출됨
      1. 핸들러 조회
      2. 어댑터 조회
      3. 어댑터 실행 → 핸들러 실행 → ModelAndView 리턴
      4. ModelAndView를 통해 뷰의 논리주소 viewName을 얻음
      5. ViewResolver를 통해 뷰의 논리주소를 물리주소로 바꾸고 View 객체 얻음
        
        JSP에서 인터페이스 구현체
        
        ViewResolver → InternalResourceViewResolver
        
        View → InternalResourceView
      6. View로 렌더링
- 서블릿을 제외한 나머지는 모두 인터페이스
  - handlerMappingMap → HandlerMapping
  - MyHandlerAdapter → HandlerAdapter
  - viewResolver() → ViewResolver
  - MyView → View

1. HandlerMapping & HandlerAdapter

컨트롤러 호출 과정

핸들러 매핑에서 클라이언트 요청에 맞는 컨트롤러(핸들러)를 찾음
- 핸들러 찾는 방식
  1. 어노테이션
  2. 스프링 빈 이름
해당 핸들러를 지원하는 어댑터를 찾음
어댑터가 핸들러 호출

⇒ 스프링이 대부분의 필요한 핸들러 매핑과 어댑터를 구현해놨기 때문에 개발자가 직접 만들 일은 거의 없음

자동 등록된 HandlerMapping(인터페이스)

RequestMappingHandlerMapping(구현체)
- 어노테이션 기반 컨트롤러를 지원
  - @RequestMapping 어노테이션으로 만든 컨트롤러
BeanNameUrlHandlerMapping
- 스프링 빈 이름으로 컨트롤러 찾음

자동 등록된 HandlerAdapter(인터페이스)

RequestMappingHandlerAdapter(구현체)
- 어노테이션 기반 컨트롤러를 지원
HttpRequestHandlerAdapter
- HttpRequestHandler 인터페이스를 구현한 컨트롤러를 지원
SimpleControllerHandlerAdapter
- Controller 인터페이스를 구현한 컨트롤러를 지원
⇒ 자동 등록된 핸들러 매핑과 어댑터는 작성된 순서를 우선순위로 조회됨

⇒ 실무에서 어노테이션 기반의 컨트롤러가 99%

2. 옛날 방식의 스프링 컨트롤러

Controller interface

package org.springframework.web.servlet.mvc;

@FunctionalInterface
public interface Controller {

	@Nullable
	ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse response) throws Exception;

}

매개변수
- request, response
리턴 타입
- ModelAndView
  
  ⇒ 스프링도 예전에는 이렇게 딱딱한 형식의 컨트롤러를 사용했음

동작 과정

스프링 빈 이름의 컨트롤러를 등록

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

스프링 빈 이름은 URL
스프링 빈 클래스는 Controller 인터페이스를 구현함
- @Controller 아님!

HandlerMapping을 순서대로 조회
1. RequestMappingHandlerMapping
  - @RequestMapping("/springmvc/old-controller") 붙은 컨트롤러 찾음
    → 없음
2. BeanNameUrlHandlerMapping
  - ‘/springmvc/old-controller’을 이름으로하는 컨트롤러 조회
    → 찾음
SimpleControllerHandlerAdapter를 사용해 컨트롤러 실행

3. 현재 사용하는 스프링 컨트롤러

어노테이션 기반의 컨트롤러를 등록

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

    private MemberRepository memberRepository = MemberRepository.getInstance();

    // HTTP 메소드가 GET 일 때만 동작
    // = @GetMapping
    @RequestMapping(value = "/new-form", method = RequestMethod.GET)
    public String newForm() {
        return "new-form";
    }
}

@Controller, @RequestMapping 어노테이션 사용
스프링 빈의 이름은 따로 있음

HandlerMapping을 순서대로 조회
- RequestMappingHandlerMapping
  - @RequestMapping("/springmvc/v3/members") 붙은 컨트롤러 존재
    → 찾음
RequestMappingHandlerAdapter를 사용해 컨트롤러 실행

4. 컨트롤러 인터페이스가 아닌 핸들러

HttpRequestHandler

package org.springframework.web;

@FunctionalInterface
public interface HttpRequestHandler {

	void handleRequest(HttpServletRequest request, HttpServletResponse response)
			throws ServletException, IOException;

}

매개변수
- request, response
리턴 타입
- void
  ⇒ 서블릿과 가장 유사한 형태의 핸들러

동작 과정

스프링 빈 이름의 핸들러를 등록

@Component("/springmvc/request-handler")
public class MyHttpRequestHandler implements HttpRequestHandler {

    @Override
    public void handleRequest(HttpServletRequest request, HttpServletResponse response) 
            throws ServletException, IOException {
        System.out.printIn("MyHttpRequestHandler.handleRequest");
    }
}

HandlerMapping을 순서대로 조회
1. RequestMappingHandlerMapping
  → 없음
2. BeanNameUrlHandlerMapping
  - ‘/springmvc/request-handler’를 이름으로하는 핸들러 조회
    → 찾음
HttpRequestHandlerAdapter를 사용해 컨트롤러 실행

4. View Resolver

자동 등록된 `뷰 리졸버`

BeanNameViewResolver
- 빈 이름으로 된 뷰를 찾아서 반환
InternalResourceViewResolver
- jsp를 처리할 수 있는 뷰를 반환
- application.properties의 설정 정보를 기반으로 등록함
```
spring.mvc.view.prefix=/WEB-INF/views/
spring.mvc.view.suffix=.jsp
```

동작 과정

컨트롤러가 만든 ModelAndView를 처리할 수 있는 뷰 리졸버를 찾음 (DispatcherServlet)

DispatcherServlet
ViewResolver를 순서대로 조회
1. BeanNameViewResolver
  - new-form라는 이름을 갖는 스프링 빈을 조회 → 없음
2. InternalResourceViewResolver
  - /WEB-INF/views/ 에서 해당 이름을 갖는 jsp 파일을 조회 → 찾음 => InternalResourceView 리턴
    - JSP처럼 forward()를 호출해서 처리할 수 있는 경우 사용
    - 만약 JSTL 라이브러리가 있으면 InternalResourceView를 상속받은 JstlView를 리턴

💡 템플릿 뷰로 타임리프를 사용하는 경우 `ThymeleafViewResolver`를 등록해야 함!

→ 라이브러리만 추가하면 스프링부트가 자동으로 추가해줌

5.2 스프링 MVC

실무에서는 99% 어노테이션 기반의 컨트롤러를 사용함

1. 컨트롤러 V1 - spring mvc 적용

컨트롤러 3개 존재

@Controller
public class SpringMemberFormControllerV1 {}

@Controller
public class SpringMemberListControllerV1 {}

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

각각의 컨트롤러가 따로 존재하고 스프링 빈으로 등록됨
@RequestMapping 어노테이션을 이용해 컨트롤러에 해당하는 URL 매핑
- 메소드 이름은 임의로 지어도 무관
mv.addObject()
- 모델에 데이터를 넣는 메소드
메소드 실행 결과 ModelAndView를 리턴

2. 컨트롤러 V2 - 컨트롤러 통합

@RequestMapping 어노테이션

메소드 단위가 아닌 클래스 단위로 적용
→ 3개의 컨트롤러를 하나의 컨트롤러로 통합함

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

        return mv;
    }

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

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

        return mv;
    }
}

클래스의 @RequestMapping
- 3개의 메소드의 공통적인 부분을 맵핑
메소드의 @RequestMapping
- 각 요청에 해당하는 세부 URL 맵핑

→ @RequestMapping은 메소드 단위로 적용됨

cf) 하나의 컨트롤러로 통합하고 메소드 레벨에서만 어노테이션을 지정해도 가능하긴 함

→ 중복 코드가 존재하므로 권장하진 않음
```
@RequestMapping("/springmvc/v2/members/save")
public ModelAndView save(){}
```

3. 컨트롤러 V3 - 실용적인 방식

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

    private MemberRepository memberRepository = MemberRepository.getInstance();

    // HTTP 메소드가 GET 일 때만 동작
    // = @GetMapping
    @RequestMapping(value = "/new-form", method = RequestMethod.GET)
    public String newForm() {
        return "new-form";
    }

    // HTTP 메소드가 POST 일 때만 동작
    @PostMapping("/save")
    public String save(
            // =request.getParameter("userName")
            // =Integer.parseInt(request.getParameter("age"))
            @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 list(Model model) {
        List<Member> members = memberRepository.findAll();

        model.addAttribute("members", members);

        return "members";
    }
}

리턴 타입
- viewName
  - String으로 viewName만 받아도 뷰의 논리주소로 인식함
    
    → ModelAndView를 반환하는게 아니므로 매개변수로 model을 받아야 함
매개 변수
- @RequestParam(object) Object object
  - request, response 대신 request parameter를 받음
- Model
@GetMapping & @PostMapping
- 단순히 URL 매핑만하는 @RequestMapping이 아닌 HTTP 메소드를 구분하여 동작하는 방식
  - @GetMapping = @RequestMapping(value = "/new-form", method = RequestMethod.GET)
- Get, Post, Put, Delete, Patch 모두 지원

Joo

이전 포스트

MVC 프레임워크 만들기

다음 포스트

5. 스프링 MVC - 구조 이해

스프링 MVC 1편

5.1 전체 구조

1. HandlerMapping & HandlerAdapter

컨트롤러 호출 과정

자동 등록된 HandlerMapping(인터페이스)

자동 등록된 HandlerAdapter(인터페이스)

2. 옛날 방식의 스프링 컨트롤러

Controller interface

동작 과정

3. 현재 사용하는 스프링 컨트롤러

4. 컨트롤러 인터페이스가 아닌 핸들러

HttpRequestHandler

동작 과정

4. View Resolver

자동 등록된 `뷰 리졸버`

동작 과정

5.2 스프링 MVC

1. 컨트롤러 V1 - spring mvc 적용

2. 컨트롤러 V2 - 컨트롤러 통합

3. 컨트롤러 V3 - 실용적인 방식

MVC 프레임워크 만들기

스프링 MVC - 기본 기능

0개의 댓글

5. 스프링 MVC - 구조 이해

스프링 MVC 1편

5.1 전체 구조

1. HandlerMapping & HandlerAdapter

컨트롤러 호출 과정

자동 등록된 HandlerMapping(인터페이스)

자동 등록된 HandlerAdapter(인터페이스)

2. 옛날 방식의 스프링 컨트롤러

Controller interface

동작 과정

3. 현재 사용하는 스프링 컨트롤러

4. 컨트롤러 인터페이스가 아닌 핸들러

HttpRequestHandler

동작 과정

4. View Resolver

자동 등록된 뷰 리졸버

동작 과정

5.2 스프링 MVC

1. 컨트롤러 V1 - spring mvc 적용

2. 컨트롤러 V2 - 컨트롤러 통합

3. 컨트롤러 V3 - 실용적인 방식

MVC 프레임워크 만들기

스프링 MVC - 기본 기능

0개의 댓글

자동 등록된 `뷰 리졸버`