Spring

스프링 MVC 1편 - 백엔드 웹 개발 핵심 기술 - 4

haenni 2024. 1. 20. 14:59
 

👩‍💻 MVC 프레임워크 만들기

 

 

📌스프링 MVC 전체 구조

✏️직접 만든 MVC 프레임워크와 스프링 MVC를 비교해보자.

:사진 참고

 

 

 

 

 직접 만든 프레임워크 스프링 MVC 비교

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

 

 

 

✏️DispatcherServlet 구조

: org.springframework.web.servlet.DispatcherServlet

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

 

 

 

✏️DispatcherServlet 서블릿 등록

  • DispatcherServlet도 부모 클래스에서 HttpServet을 상속받아 사용 (서블릿으로 동작)
    • DispatcherServlet  ➜  FrameworkServlet  ➜  HttpservletBean  ➜  HttpServle
  • 스프링 부트는 DispatcherServlet을 서블릿으로 자동 등록 및 모든 경로(urlPatterns = "/")에 대해서 매핑

 

 

 

✏️요청 흐름

  • 서블릿이 호출되면 HttpServlet이 제공하는 service()가 호출됨
  • 스프링 MVC는 DispatcherServlet의 부모인 FrameworkServlet에서 service()를 오버레이드 해두었음
  • FrameworkServlet.service()를 시작으로 여러 메서드가 호출되며 DispatcherServlet.doDispatch()호출

 

 

✏️스프링 MVC 구조

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

 

 

 

✏️주요 인터페이스 목록 

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

 

 

 

 

 

 

 

 

 

 

 

 

 

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

✏️Controller 인터페이스 

 스프링도 처음엔 위와 같은 딱딱한 형식의 컨트롤러를 제공했다.

이를 바탕으로 간단하게 구현해보자

 

ㅇ   @Component: 이 컨트롤러는 "/springmvc/old-controller"이라는 이름의 스프링 빈으로 등록되었다.
ㅇ   빈의 이름으로 URL을 매핑할 것

1.   핸들러 매핑으로 핸들러 조회
   ㅇ   이 경우 빈 이름으로 핸들러를 찾기 때문에, 이름 그대로 빈 이름으로 핸들러를 찾아주는 BeanNameUrlHandlerMapping            이 실행에 성공하고, 핸들러인 OldController를 반환한다.
        (@Controller 애노테이션을 붙이면 자동으로 빈 등록되기 때문에 클래스 이름으로 빈이 등록 됨)

2.   핸들러 어댑터 조회
   ㅇ   "HandlerAdapter"의 supports()를 호출한다
   ㅇ   SimpleControllerHandlerAdapter가 Controller 인터페이스를 지원하므로 대상이 된다.

3.   핸들러 어댑터 실행
   ㅇ   디스패처 서블릿이 조회한 SimpleControllerHandlerAdapter를 실행하면서 핸들러 정보도 함께 넘겨줌
   ㅇ   SimpleControllerHandlerAdapter는 핸들러인 OldController를 내부에서 실행하고, 그 결과를 반환함

 

 

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

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

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

 

 

 

 

✏️스프링 부트가 자동 등록하는 핸들러 매핑과 핸들러 어댑터

:스프링은 이미 필요한 핸들러 매핑과 핸들러 어댑터를 대부분 구현 함. 직접 핸들러 매핑과 핸들러 어댑터를 만드는 일은 거의 없다

 

"스프링 부트가 자동 등록하는 핸들러 매핑과 핸들러 어댑터 (실제로는 더 많음)"

"HandlerMapping"
우선순위 이름 설명
0 RequestMappingHandlerMapping 애노테이션 기반 컨트롤러인 @RequestMapping에서 사용 
1 BeanNameUrlHandlerMapping 스프링 빈의 이름으로 핸들러를 찾는다


"HandlerAdapter"
우선순위 이름 설명
0 RequestMappingHandlerAdapter 애노테이션 기반의 컨트롤러인 @RequestMapping에서 사용
1 HttpRequestHandlerAdapter HttpRequestHandler 처리
2 SimpleControllerHandlerAdapter Controller 인터페이스(애노테이션 X, 과거에 사용) 처리

:핸들러 매핑도, 핸들러 어댑터도 모두 순서대로 찾고 만약 없으면 다음 순서로 넘어간다. ( 0 -> 1 -> 2 ...)

 

 

 

 

 

✏️HttpRequestHandler
:서블릿과 가장 유사한 형태의 핸들러

 

이를 바탕으로 간단하게 구현해보자

 

 

1.   핸들러 매핑으로 핸들러 조회
   ㅇ   HandlerMapping을 순서대로 실행해서, 핸들러를 찾는다.
   ㅇ   이 경우 빈 이름으로 핸들러를 찾아야 하기 때문에 BeanNameUrlHandlerMapping이 실행헤 성공하고 핸들러인
         MyHttpRequestHandler를 반환 함

2.   핸들러 어댑터 조회
   ㅇ   "HandlerAdapter"의 supports()를 호출한다
   ㅇ   HttpRequestHandlerAdapter가 HttpRequestHandler 인터페이스를 지원하므로 대상이 됨

3.   핸들러 어댑터 실행
   ㅇ   디스패처 서블릿이 조회한 HttpRequestHandlerAdapter를 실행하면서 핸들러 정보도 함께 넘겨줌
   ㅇ   HttpRequestHandlerAdapter는 핸들러인 MyHttpRequestHandler를 내부에서 실행하고, 그 결과를 반환함

 

 

 

 

 

 

 

 

 

 

 

 

📌 뷰 리졸버

✏️뷰 리졸버

: 이번에는 뷰 리졸버에 대해서 자세히 알아보자

View를 사용할 수 있도록 다음 코드를 추가하였다.
"return new ModleAndView("new-form");

실행해보면 컨트롤러는 정상 호출되지만, Whitelable Error Page 오류가 발생한다.

`application.properties` 에 다음 코드를 추가하자
spring.mvc.view.prefix=/WEB-INF/views/
spring.mvc.view.suffix=.jsp

 

 

 

 

✏️뷰 리졸버 동작 방식

 

"스프링 부트가 자동 등록하는 뷰 리졸버"

우선순위 이름 설명
1 BeanNameViewResolver 빈 이름으로 뷰를 찾아서 반환 함
2 InternalResourceViewResolver JSP를 처리할 수 있는 뷰를 반환 함

1. 핸들러 어댑터 호출
   ㅇ   핸들러 어댑터를 통해 "new-form"이라는 논리 뷰 이름을 흭득한다.

2. ViewResolver 호출
   ㅇ   new-form이라는 뷰 이름으로 viewResolver를 순서대로 호출한다.
   ㅇ   BeanNameViewResolver는 new-form이라는 이름의 스프링 빈으로 등록된 뷰를 찾아야 하는데 없다.
   ㅇ   InteranlResourceViewResolver가 호출 됨

3. InternalResourceViewResolver
   ㅇ   이 뷰 리졸버는 InternalResourceView를 반환 함

4. 뷰 - InternalResourceView
   ㅇ   InternalResourceView는 JSP처럼 포워드 forward()를 처리해서 처리할 수 있는 경우에 사용한다.

5. view.render()
   ㅇ   view.render()가 호출되고, InternalResourceView는 forward()를 사용해서 JSP를 실행

 

 

 

 

 

 

 

 

 

 

 

 

📌 스프링 MVC - 시작하기

✏️@RequestMapping이란?

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

 

 

1.   @RequestMapping

: 스프링은 애노테이션을 활용한 매우 유연하고, 실용적인 컨트롤러를 만들었는데, 이것이 바로 @RequestMapping 애노테이션을

 사용하는 컨트롤러이다.

 

  • RequestMappingHandlerMapping
  • RequestMappingHandlerAdapter

앞서 보았듯이 가장 우선순위가 높은 핸들러 매핑과 핸들러 어댑터는 RequestMappingHandlerMapping, RequestMappingHandlerAdapter이다.

 

@RequestMapping의 앞글자를 따서 만든 이름인데, 이것이 바로 지금 스프링에서 주로 사용하는 애노테이션 기반의 컨트롤러를 지원하는 핸들러 매핑과 어댑터이다. 실무에서는 99.9%이 방식의 컨트롤러를 사용한다

 

 

 

✏️SpringMemberFormControllerV1 - 회원 등록 폼

ㅇ   @Controller
      1.   스프링이 자동으로 스프링 빈으로 등록한다.(내부에 @Component 애노테이션이 있어서 컴포넌트 스캔의 대상이 됨)
      2.   스프링 MVC에서 애노테이션 기반 컨트롤러로 인식한다.

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

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

 

 

 

 

✏️SpringMemberSaveControllerV1 - 회원 저장

ㅇ   mv.addObject("member", member)
      1. 스프링이 제공하는 ModelAndView를 통해 Model 데이터를 추가할 때는 addObject()를 사용하면 된다.

 

 

 

 

✏️SpringMemberListControllerV1 - 회원 목록

 

 

 

 

 

 

 

 

 

 

📌 스프링 MVC - 컨트롤러 통합

✏️컨트롤러 통합하기

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

 

 

조합
:컨트롤러 클래스를 통합하는 것을 넘어서 조합도 가능하다.
다음 코드는 "/springmvc/v2/member"라는 부분에 중복이 있다
ex) @RequestMapping("/spinrg/v2/members/new-form")
      @RequestMapping("/spinrg/v2/members")
      @RequestMapping("/spinrg/v2/members/save")

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

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

 

 

 

 

 

 

 

 

📌 스프링 MVC - 실용적인 방식

✏️실용적인 방식을 사용해보자

:MVC 프레임워크 만들기에서 v3은 ModelView를 개발자가 직접 생성해서 반환했기 때문에, 불편했던 기억이 날 것이다.

물론 v4를 만들면서 실용적으로 개선한 기억도 날 것이다.

 

스프링 MVC는 개발자가 편리하게 개발할 수 있도록 수 많은 편의 기능을 제공한다.

실무에서는 지금부터 설명하는 방식을 주로 사용한다.

 

 

 

✏️SpringMemberControllerV3

1. Model 파라미터
: save(), members()를 보면 Model을 파라미터로 받는 것을 확인할 수 있다. 스프링 MVC도 이런 편의 기능을 제공한다.

2. ViewName 직접 반환 (메소드의 반환 값이 ModelAndView  ➜ String 변경)
: 뷰의 논리 이름을 반환할 수 있다.

3. @RequestParam 사용
: 스프링은 HTTP 요청 파라미터를 @RequestParam으로 받을 수 있다.
@RequestParam("username")은 request.getParamter("username")와 거의 같은 코드라 생각하면 된다.

4. @RequestMapping ➜ @GetMapping, @PostMapping
: @RequestMapping은 URL만 매칭하는 것이 아니라, HTTP Method도 함꼐 구분할 수 있다.
예를 들어서 URL이 /new-from이고, HTTP Method가 GET인 경우 모두 만족하는 매핑을 하려면 다음과 같이 처리하면 된다.
" @RequestMapping(value = "/new-form", method = RequestMethod.GET) "
이것을 @GetMapping, @PostMapping으로 더 편리하게 사용할 수 있다.
참고로 Get, Post, Put, Delete, Patche 모두 애노테이션이 있다.