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

Chooooo·2023년 1월 5일

MVC spring mvc 구조이해

스프링 MVC 1편

목록 보기

5/11

이 글은 강의 : 김영한님의 - "[스프링 MVC 1편 - 백엔드 웹 개발 핵심 기술]"을 듣고 정리한 내용입니다. 😁😁

스프링 MVC 전체 구조

이전 챕터(MVC 프레임워크 만들기)에서 스프링을 사용하지 않고 직접 만든 MVC 프레임워크의 구조와 spring MVC 구조를 비교해보면 거의 똑같다.

spring MVC 구조

명칭은 약간 다르지만 대부분의 구조가 똑같다.

우리가 FrontController라 부르던 서블릿은 DispatcherServlet으로 쓰이고 있고, handlerMappingMap은 HandlerMapping으로 불리는등 이름만 달라졌고, 사용처는 똑같다. 이름이 달라진 부분은 다음과 같다.

FrontController → DispatcherServlet
handlerMappingMap → HandlerMapping
MyHandlerAdapter → HandlerAdapter
ModelView → ModelAndView
viewResolver → ViewResolver
MyView → View

🎈 이제 스프링 MVC를 사용할 때 해당 키워드를 보면 직접 만들었던 것을 생각하며 역할을 상기하면 된다.

해당 구조에서 가장 중요한 DispatcherServlet의 방대한 코드중 중요한 몇가지 코드만 살펴보자. (DispatcherServlet이 스프링의 핵심 !)

DispatcherServlet 구조

이 서블릿도 부모 클래스에서 HttpServlet을 상속받아 사용하며, 서블릿으로 동작한다
(상속구조)
DispatcherServelt → FrameworkServlet → HttpServletBean → HttpServlet

🎃 스프링 부트 구동시 DispatcherServlet을 서블릿으로 자동등록하며 모든 경로(urlPatterns = "/")에 대해 매핑한다. 즉 Spring MVC 역시 프론트 컨트롤러 패턴으로 구현되어 있고 DispatcherServlet이 프론트 컨트롤러 역할을 한다고 생각하면 된다.

🎈 참고 : 경로의 우선순위도 자세할수록 높기 때문에 기존에 작성한 서블릿도 같이 동작한다.

요청 흐름

서블릿이 호출되면 HttpServlet이 제공하는 service() 메서드가 호출된다.
스프링 MVC는 DispatcherServlet의 부모인 FrameworkServlet에서 service()를 오버라이드 해뒀다.
FrameworkServlet.service()를 시작으로 여러 메서드가 실행되며 DispatcherServlet.doDispatcher()가 호출된다.

DispatcherServlet.doDispatcher() 핵심 로직 분석

지금부터 DispatcherServlet의 핵심인 doDispatcher()코드를 분석해보자.

메서드 이름대로 해당 메서드에서 적절한 컨트롤러를 찾아 매핑해주고 뷰까지 찾아 View를 반환해 렌더링까지 해주는 핵심 메서드이다.

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

🎈 mappedHandler = getHandler(processedRequest);

요청에 맞는 적절한 핸들러를 찾아 반환해준다.

🎈 noHandlerFound(processedRequest, response);

적절한 핸들러를 찾지 못한 경우 404 에러 코드를 반환해준다.

🎈 HandlerAdapter ha = getHandlerAdapter(mappedHandler.getHandler());

찾은 핸들러를 처리할 수 있는 핸들러 어댑터를 찾아준다.
만약 찾지 못할 경우 ServeltException 발생

🎈 mv = ha.handle(processedRequest, response, mappedHandler.getHandler());

찾은 핸들러 어댑터를 이용해 로직을 수행하는 handle 메서드를 호출한다.
결과로 ModelAndView를 반환받고, 이를 이용해 렌더링까지 수행된다.

🎈 processDispatchResult(processedRequest, response, mappedHandler, mv, dispatchException);

실제 코드는 복잡하게 되어 있는데 결국 render() 메서드를 호출해준다.
render()에서는 ModelAndView에서 View를 찾아 뷰 리졸버를 이용해 뷰의 물리적 이름을 완성해서 forward 해준다.

spring MVC 구조 & 동작 순서

(매우 중요!!!)
1. 핸들러 조회: 핸들러 매핑을 통해 요청 URL에 매핑된 핸들러(컨트롤러)를 조회한다.

핸들러 어댑터 조회: 핸들러를 실행할 수 있는 핸들러 어댑터를 조회한다.
핸들러 어댑터 실행: 핸들러 어댑터를 실행한다.
핸들러 실행: 핸들러 어댑터가 실제 핸들러를 실행한다.
ModelAndView 반환: 핸들러 어댑터는 핸들러가 반환하는 정보를 ModelAndView로 변환해서 반환한다.
viewResolver 호출: 뷰 리졸버를 찾고 실행한다.

JSP의 경우: InternalResourceViewResolver 가 자동 등록되고, 사용된다.

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

뷰 렌더링: 뷰를 통해서 뷰를 렌더링 한다.

인터페이스 살펴보기

spring MVC는 DispatcherServlet 코드 변경을 하지 않고도 원하는 기능을 변경하거나 확장할 수 있다. 그리고 이런 인터페이스들을 구현해 DispatcherServlet에 등록하면 커스텀 컨트롤러로 만들 수도 있다.

주요 인터페이스 목록

핸들러 매핑 : org.springframework.web.servlet.HandlerMapping
핸들러 어댑터 : org.springframework.web.servlet.HandlerAdapter
뷰 리졸버 : org.springframework.web.servlet.ViewResolver
뷰 : org.springframework.web.servlet.View

이처럼 springMVC의 구조와 흐름에 대해 몰라도 기본적인 사용법만 익혀서 애노테이션만 사용하면 서버를 구현하는데 어려움이 없고, 대부분의 기능은 수년간 이미 다 구현되고 확장되었기에 스프링에 기능자체가 없어서 직접 구현할일은 거의 없다.
하지만, 이런 내부 로직과 흐름에 대해 이해한다면 내 프로젝트의 문제가 생겼을때 디버깅을 할때 몹시 유리하다.
특정 컨트롤러에서 반환하는 ViewName을 제대로 찾지못해 페이지가 안나올때 이런 흐름이나 인터페이스를 전혀 모른다면 어디서부터 손대야할지 모르지만, 이렇게 공부를 한 뒤에는 뷰리졸버부터 확인을하며 어떻게 물리적 이름이 완성되는지부터 확인을 해 볼수 있을 것이다. 또한 기능을 구현하는것은 아닐지라도 기능의 확장이 필요할 때 어디를 확장해야 하는지에 대해서도 구조를 알고있는 것과 모르고 있는 것의 차이는 크다.

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

이전에는 핸들러 매핑과 핸들러 어댑터를 단순하게 Map, List 컬렉션을 이용해서 등록한 뒤 검색해서 사용을 해줬다. 이번에는 spring MVC에서는 어떻게 핸들러 매핑과 핸들러 어댑터를 사용하는지 알아보자.

Controller 인터페이스

과거 버전의 스프링 컨트롤러 인터페이스 ( 그 옛날에는 애노테이션 기반이 아닌 인터페이스를 사용했음)
org.springframework.web.servlet.mvc.Controller

🎈 간단한 예제

Controller 인터페이스를 구현해서 간단하게 핸들러 매핑 테스트를 진행해보자.

Controller 인터페이스를 구현하는 OldController

package hello.servlet.web.springmvc.old;

import org.springframework.stereotype.Component;
import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.mvc.Controller;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

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

🎃 @Controller 애노테이션과는 다르다
🎃 @Component("/springmvc/old-controller")
⇒ /springmvc/old-controller 라는 이름의 스프링 빈으로 등록되었다.
⇒ 스프링 빈의 이름으로 URL 매핑을 할 것이다.

🎇 어떻게 URL을 통해 해당 컨트롤러를 찾을 수 있는 것인가?

다시 상기해보자.

이 컨트롤러가 호출되기 위해서는 2가지가 필요하다.

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

스프링 부트에서는 자동으로 핸들러 매핑과 핸들러 어댑터를 등록해준다. 아주 다양하게 등록되지만, 여기서는 위 예제에 맞는 몇가지만 작성한다.

HandlerMapping

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

HandlerAdapter

0 = RequestmappingHandlerAdapter  : 애노테이션 기반의 컨트롤러인 @Requestmapping에서 사용한다. 
1 = HttpRequestHandlerAdapter     : HttpRequesthandler 처리
2 = SimpleControllerHandlerAdapter: Controller 인터페이스(애노테이션 X) 처리

핸들러 매핑, 핸들러 어댑터 모두 순서대로 찾고 만약 없을 경우 다음 순서로 넘어간다.
🎃 위 내용을 토대로 정리해보면 우리가 작성한 OldController는 웹브라우저에서 URL 요청시 다음과 같이 매핑되어 수행된다.

핸들러 매핑으로 핸들러 조회

HandlerMapping에서 순서대로 수행하는데 BeanNameUrlHandlerMapping에서 검색이 되기에 URL을 빈 이름으로 등록한 핸들러(OldController)가 매핑되어 반환된다.

핸들러 어댑터 조회

어댑터를 순서대로 호출하며 이전에 찾은 핸들러(OldController)가 실행 가능한 어댑터를 찾는다.
이 중에서 SimpleControllerHandlerAdapter가 Controller 인터페이스를 실행 가능하기에 반환된다.

핸들러 어댑터 실행

반환된 어댑터(SimpleControllerHandlerAdapter)를 실행하면서 핸들러 정보를 넘겨주고 그 결과를 반환한다.

뷰 리졸버

View의 논리 이름을 물리 이름으로 완성시켜주는 뷰 리졸버를 springMVC에서는 어떻게 만들어줄까?
위에서 만든 OldController는 현재는 반환값이 null이라 URL을 요청해도 어떤 화면도 안나오지만 이제 조회가 되도록 변경해보자.

OldController - View 조회 되도록 변경

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

View를 사용할 수 있도록 new ModelAndView("new-form")을 반환해준다.

그럼 이제 다시 http://localhost:8080/springmvc/old-controller 경로로 접속해서 동작이 되는지 확인을 해보자. 정상적으로 나오는가? 아마 여전히 컨트롤러 호출은 되지만 페이지는 나오지 않을 것이다.
그 이유는 new-form 이라는 viewPath를 물리이름으로 완성하기위해선 어떤 경로인지 상위 경로 prefix와 이게 html인지 jsp인지 확장자를 저장한 suffix가 없기 때문이다.
그렇기에 application.properties 라는 속성 파일에 다음 코드를 추가한다.

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

다시 구동해보면 이제 정상적으로 페이지가 노출될 것.

뷰 리졸버 - InternalResourceViewResolver

스프링 부트는 InternalResourceViewResolver라는 뷰 리졸버를 자동 등록하는데, 이때 설정파일에서 작성한 spring.mvc.view.prefix, spring.mvc.view.suffix 설정 정보를 사용한다.

뷰 리졸버 동작 방식

위 springMVC 구조에서 6번, 7번 과정에서 뷰 리졸버가 동작한다.

스프링 부트는 구동 시 자동 등록하는 뷰 리졸버가 많은데, 이 중 몇가지를 말하면 다음과 같다.

1 = BeanNameViewResolver         : 빈 이름으로 뷰를 찾아 반환한다. 
2 = InternalResourceViewResolver : JSP를 처리할 수 있는 뷰를 반환한다.

여기서 이번 OldController에 동작하는 뷰 리졸버는 무엇일까? 우선 new-form으로 등록된 Bean은 없다. 그렇기에 다음으로 InternalResourceViewResolver가 호출된다.

핸들러 어댑터 호출

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

ViewResolver 호출

new-form이라는 뷰 이름으로 viewResolver를 순서대로 호출한다.
BeanNameViewResolver는 new-form이라는 이름의 스프링 빈으로 등록된 뷰를 찾는데 없다. (빈 이름으로 뷰를 찾는데 없어)
InternalResourceViewResolver가 호출된다. (JSP가 처리할 수 있는 뷰를 반환)

InteralResourceViewResolver

이 뷰 리졸버는 InternalResourceView를 반환한다.

뷰 - InternalResourceView

InternalResourceView는 JSP처럼 forward()를 호출해서 처리할 수 있는 경우 사용한다.

view.render()

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

🎃 참고 : JSTL 라이브러리가 있는 경우

InternalResourceViewResolver는 JSTL 라이브러리가 있으면 InternalResourceView를 상속받은 JstlView를 반환한다. JstlView는 JSTL 태그 사용시 약간의 부가기능이 추가된다.

🎃 참고 : 렌더링
다른 뷰는 실제 뷰를 렌더링하지만, JSP는 forward() 를 통해 해당 JSP로 이동해야 렌더링이 된다. (이동이 필수 과정)
다른 뷰 템플릿은 forward() 과정 없이 바로 렌더링된다. (그래서 JSP를 잘 안쓴다는 것인가?)

🎃 참고 : Thymeleaf
Thymeleaf 뷰 템플릿을 사용하면 ThymeleafViewResolver를 등록해야 한다. 물론 최근에는 라이브러리만 추가해주면 스프링 부트에서 자동으로 등록해준다.

스프링 MVC - 시작하기

이제 스프링에서 제공하는 애노테이션을 기반으로 컨트롤러를 구현해 동작을 확인해보자.
과거에는 자바에 애노테이션이 없었고, 스프링도 유연한 컨트롤러를 제공해주지 못했지만, 이제는 애노테이션 기반으로 유연하고 실용적이다.

RequestMapping

🎃 기존에 @WebServlet에서 urlPattern을 사용해주고, Component에 빈 이름으로 URL을 작성해서 사용해지만, 이제는 이 @RequestMapping 애노테이션을 사용해서 편리하게 컨트롤러 구현이 가능해졌다.

@RequestMapping

RequestMappingHandlerrMapping
RequestMappingHandlerAdapter

지금까지 학습한 챕터에서 여러 핸들러 매핑과 핸들러 어댑터가 등록된다고 했고 우선순위가 있다고 했는데, 가장 우선순위가 높은 핸들러 매핑과 핸들러 어댑터가 RequestMappingHandlerMapping과 RequestMappingHandlerAdapter이다. @Requestmapping 애노테이션은 이 핸들러 매핑과 어댑터의 앞 글자를 따서 만든 애노테이션이다. 그리고 실무에서는 99.9% 이 방식의 컨트롤러를 사용한다.
이렇게 대략적으로 @RequestMapping 애노테이션에 대해 알아봤으면 이제 실제 코드를 작성해서 사용해보자.

코드 - 회원 등록 폼, 가입, 목록 조회 컨트롤러

SpringMemberFormControllerV1 - 회원 등록 폼

package hello.servlet.web.springmvc.v1;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.servlet.ModelAndView;

@Controller
public class SpringMemberFormControllerV1 {

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

🎃 @Controller
⇒ 스프링이 자동으로 스프링 빈으로 등록한다(내부에 @Component 애노테이션이 있다.)
⇒ 스프링 MVC에서 애노테이션 기반 컨트롤러로 인식한다. 즉, RequestMapnpingHandlerMapping에서 매핑시켜줄수 있는(사용할 수 있는) 핸들러로 인식된다는 의미. (아 이거는 핸들러 정보구나~ 하면서 꺼낼 수 있는 대상이 된다는 뜻, 그렇기에 핸들러 매핑 과정에서 꺼낼 수 있음)

@Component가 있으면 ComponentScan의 대상이 되어서 자동으로 스프링 빈으로 등록이 된다는거 기억하고 생각하자 그렇기에 @Controller 안에는 @Component가 있기에 @Controller만 있어도 ComponentScan의 대상이 돼! 그래서 자동으로 스프링 빈에 등록이 된다.

🎃 @RequestMapping
⇒ 요청 정보를 매핑한다. 해당 URL이 호출되면 이 메서드가 호출된다. (중요!)
⇒ 애노테이션을 기반으로 동작하기에 메서드명은 임의대로 작성해도 된다.

🎃 ModelAndView
⇒ 모델과 뷰 정보를 담아 반환하면 된다.

하나 참고할 것은 RequestMappingHandlerMapping은 스프링 빈 중에서 @RequestMapping 또는 @Controller가 클래스 레벨에 붙어 있는 경우에 매핑 정보로 인식한다. (RequestMappingHandlerMapping이 아 너는 내가 처리할 수 있는 핸들러구나! 하고 찾아낸다는 뜻!)
근데 @Controller가 편해.

SpringMemberSaveControllerV1 - 회원가입

package hello.servlet.web.springmvc.v1;

import hello.servlet.domain.member.Member;
import hello.servlet.domain.member.MemberRepository;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.servlet.ModelAndView;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

@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);
        Member save = memberRepository.save(member);

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

🎃 mv.addObject("member", member);
⇒ 스프링이 제공하는 ModelAndView를 통해 Model 데이터를 추가할 때는 addObject()를 사용하면 된다.
이 데이터는 이후 뷰를 렌더링 할 때 사용된다.

SpringMemberListControllerV1 - 회원 목록 조회

package hello.servlet.web.springmvc.v1;

import hello.servlet.domain.member.Member;
import hello.servlet.domain.member.MemberRepository;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.servlet.ModelAndView;

import java.util.List;

@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 애노테이션이 없어도 직접 설정 영역에서 빈으로 등록해줘도 되고, 클래스 영역에 @RequestMapping과 @Component 애노테이션을 사용하면 정상적으로 등록되어 사용할 수 있다.

스프링 MVC - 컨트롤러 통합

@RequestMapping 애노테이션 기반 컨트롤러 구축시 URL 매핑이 클래스 단위가 아니라 메서드 단위로 되는 것을 확인할 수 있었는데, 이러한 메서드들을 하나로 통합할 수 있다.

SpringMemberControllerV2

package hello.servlet.web.springmvc.v2;

import hello.servlet.domain.member.Member;
import hello.servlet.domain.member.MemberRepository;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.servlet.ModelAndView;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.util.List;

@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);
        Member save = memberRepository.save(member);

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

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

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

        return mv;
    }
}

현재 스프링부트에서 뷰 리졸버 자동 등록 해놨기에(applicaion.properties) ModelAndView만 반환해도 prefix, suffix 설정 정보를 사용하기에 바로 렌더링이 된다!!

🎃 SpringMemberXXXXControllerV1에 있던 회원 등록 폼, 회원 가입, 회원 목록 조회 메서드들을 모두 SPringMemberControllerV2로 모아놨다.

🎃 기존 V1의 매핑 URL을 보면 /springmvc/vX/members/ 까지는 중복되는데 이런 중복되는 경로는 클래스 단위의 @RequestMapping에 작성해서 경로 조합을 시도할 수 있다.

물론 이렇게 사용해도 되지만(중복해서), 컨트롤러를 통합한 예제 코드를 보면 중복을 어떻게 제거했는지 확인할 수 있다.
클래스 레벨에 다음과 같이 @RequestMapping 을 두면 메서드 레벨과 조합이 된다

@Controller
@RequestMapping("/springmvc/v2/members")
public class SpringMemberControllerV2 {}

조합

컨트롤러 클래스를 통합하는 것을 넘어 조합도 가능한데, 클래스 레벨의 @RequestMapping("/springmvc/vX/member") 애노테이션을 추가해주고, 각각의 메서드 레벨에서 중복 경로를 제거해주면 클래스 레벨과 메서드 레벨이 조합되서 등록된다.

중복되는 것은 @RequestMapping으로("/springmvc/v2/members") 밖으로 뺏기에 이렇게 간단히 써줄 수 있었다.

조합 결과

클래스 레벨 @RequestMapping("/springmvc/vX/member")
- 메서드 레벨 @RequestMapping("/new-form") → /springmvc/vX/members/new-form
- 메서드 레벨 @RequestMapping("/save") → /springmvc/vX/members/save
- 메서드 레벨 @RequestMapping → /springmvc/vX/members

(굉장히 단순해보이고 직관적임)

스프링 MVC - 실용적인 방식

MVC 프레임워크 만들기에서 v3은 ModelView를 개발자가 직접 생성해서 반환했기 때문에, 불편했던 기억이 날 것이다. 물론 v4를 만들면서 실용적으로 개선한 기억도 날 것이다.

스프링 MVC는 개발자가 편리하게 개발할 수 있도록 수 많은 편의 기능을 제공한다.
실무에서는 지금부터 설명하는 방식을 주로 사용한다 (중요!!!)

SpringMemberControllerV3

Model 도입
viewName 직접 반환
RequestParam 사용
@RequestMapping
→ @GetMapping, @PostMapping

package hello.servlet.web.springmvc.v3;

import hello.servlet.domain.member.Member;
import hello.servlet.domain.member.MemberRepository;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.*;

import java.util.List;

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

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

        model.addAttribute("members", members);

        return "members";
    }
}

🎃 스프링 애노테이션 기반 컨트롤러는 ModelAndView를 반환해도 되고, 문자열로 반환해도 된다!
그러면 그냥 문자열이 뷰 이름이라고 알고 프로세스가 알아서 진행한다.

🎃 Model model
⇒ save(), members() 에서 Model을 파라미터로 받는다.
⇒ 추가할 데이터는 이 Model에 추가해주면되며, 기존처럼 ModelAndView 객체를 만든 뒤 여기에 데이터를 넣어줄 필요가 없어진다.

🎃 viewName 직접 반환
⇒ 애노테이션 기반의 컨트롤러는 ModelAndView 뿐 아니라 ViewName을 직접 반환해도 동작한다.

🎃 @RequestParam 사용
⇒ 스프링은 HTTP 요청 파라미터(HttpServletRequest, HttpServletResponse)를 @RequestParam으로 받을 수 있다. 코드에서 사용 된 @RequestParam("username")은 request.getParameter("username")과 거의 같다.
그렇기에 GET, POST Form 방식 모두 지원한다.

🎃 @GetMapping, @PostMapping
⇒ 메서드들을 보면 @RequestMapping이 아니라 @GetMapping, @PostMapping 애노테이션이 있는데, @RequestMapping 애노테이션은 URL만 매칭하는게 아니라 HTTP Method도 구분할 수 있다.
예를들어 회원 등록 폼 요청은 GET 으로 올 때만 매핑시키려면 method 속성에 GET을 작성하면 된다.

그리고 @GetMapping, @PostMapping 는 이런 method를 미리 지정해둔 애노테이션으로 가독성과 편의성을 더 높혀서 쓰기 편하다. 물론, 이 뿐아니라 Put, Delete, Patch 모두 존재한다.

🎆 참고
@GetMapping, @PostMapping 내부 코드를 보면 결국 @RequestMapping 애노테이션의 메소드를 미리 지정해둔 애노테이션이고 이런 애노테이션의 유연함이 스프링 사용을 편리하게 해준다.

@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@RequestMapping(method = RequestMethod.GET)
public @interface GetMapping {
	...
}

이번에는 진짜 실무에서 사용하는 스프링 구조에 대해서 알아봤다 이제 기본 기능들을 알아볼 것이다!

정리

먼저 스프링 MVC의 구조는

고객이 HTTP 요청을 하면 DispatcherServlet에서 핸들러 매핑을 해서 핸들러를 조회(핸들러 매핑이 처리할 수 있는 핸들러를 찾아준다.) 그리고 다시 핸들러 어댑터 목록에 던져서 해당 핸들러를 처리할 수 있는 핸들러 어댑터를 가져온다. 그리고 DispathcerServlet에서 해당 핸들러 어댑터를 사용해서 실제 핸들러를 호출한다. 그리고 핸들러 어댑터가 ModelAndView를 반환한다.

그리고 다시 ViewResolver를 호출해서 논리 이름 뿐인 뷰에서 실제 뷰를 찾아서 반환 받는다. 그리고 해당 뷰를 render(model) 해서 실제 고객에게 HTTP 응답을 해서 렌더링을 한다!
(이게 전체 큰 라이프 사이클)

근데 이 과정 중 핸들러 매핑을 해서 핸들러를 조회하고 그리고 다시 핸들러 어댑터 목록에서 해당 핸들러 어댑터 찾고.. 그리고 해당 핸들러 호출해주는 것(handler) 까지... 이 과정을 애노테이션 하나로 모두 해결 가능해짐. @RequestMapping

스프링 빈의 이름으로 핸들러를 찾을 수 있는 핸들러 매핑
스프링 부트에서는 자동으로 핸들러 매핑과 핸들러 어댑터를 등록해준다!!!
핸들러 매핑으로는 - RequestMappingHandlerMapping (애노테이션 기반의 컨트롤러인 @RequestMapping에서 사용)
핸들러 어댑터로는 - RequestMappingHandlerAdapter (애노테이션 기반의 컨트롤러인 @RequestMapping에서 사용)
애노테이션만 사용하면 간편하다는 뜻

Chooooo

back-end, 지속 성장 가능한 개발자를 향하여

이전 포스트

[스프링 MVC 1편] - MVC 프레임워크 만들기

다음 포스트

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