[Spring] #5. 스프링 MVC - 구조 이해 (김영한_인프런_스프링MVC1)

bien·2023년 4월 18일

springMVC

Spring_MVC1

목록 보기

6/8

스프링 MVC 전체 구조

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

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

SpringMVC 구조

이름만 조금 다를 뿐. 구조가 매우 유사하다.

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

FrontController -> DispatcherServlet (제일 중요. 프론트컨트롤러 역할)
handlerMappingMap -> HandlerMapping
MyHandlerAdapter -> HandlerAdapter
ModelView -> ModelAndView
viewResolver -> ViewResolver (스프링에선 인터페이스로 만들어 놓음. 확장성 大)
MyView -> View (스프링에선 인터페이스로 만들어 놓음. 확장성 大)

DispatcherServlet 구조 살펴보기

org.springframework.web.servlet.DispatcherServlet
스프링 MVC도 프론트 컨트롤러 패턴으로 구현되어 있다. 스프링 MVC 프론트 컨트롤러가 바로 디스패처 서블릿(DispatcherServlet)이다. 그리고 이 디스패처 서블릿이 바로 스프링 MVC의 핵심이다.

우리는 @WebServlet으로 서블릿인걸 명시하고, HttpServlet도 상속 받았었는데 DispatcherServlet은 안하나요?
DispatcherServlet 서블릿 등록
DispatcherServlet도 부모 클래스에서 HttpServlet을 상속받아서 사용하고, 서블릿으로 동작한다.

DispatcherServlet -> FrameworkServlet -> HttpServletBean -> HttpServlet

스프링부트는 DispatcherServlet을 서블릿으로 자동으로 등록하면서 모든 경로(urlPatterns="/")에 대해서 매핑한다.

참고: 더 자세한 경로가 우선순위가 높다. 그래서 기존에 등록한 서블릿도 함께 동작한다.

요청 흐름

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

지금부터 DispacherServlet의 핵심인 doDispatch() 코드를 분석해보자. 최대한 간단히 설명하기 위해 예외처리, 인터셉터 기능은 제외했다.

DispatcherServlet.doDispatcher()

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

스프링 MVC 구조

동작 순서

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

인터페이스 살펴보기

스픠링 MVC의 큰 강점은 인터페이스를 통해 DispatcherServlet 코드의 변경 없이, 원하는 기능을 변경하거나 확장할 수 있다는 점이다.
이 인터페이스들만 구현해서 DispatcherServlet에 등록하면 여러분만의 컨트롤러를 만들 수도있다. ~~(쉬운건 아니다)~~

주요 인터페이스 목록

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

정리

스프링 MVC는 분량도 많고 내부 구조도 복잡하다. 개발자들의 요구에 맞추어 확장되어 왔고, 웹 애플리케이션을 만들 때 필요로 하는 대부분의 기능은 이미 구현되어 있다.
핵심 동작방식을 알아두어 향후 문제가 발생했을 때, 해당 지점 발견과 문제 해결에 적용하자.

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

핸들러 매핑과 핸들러 어댑터가 어떤 것들이 어떻게 사용되는지 알아보자. 지금은 전혀 사용하지 않지만, 과거에 주로 사용했던 스프링이 제공하는 간단한 컨트롤러로 핸들러 매핑과 어댑터를 이해해보자.
파라미터와 리턴 타입이 다른 여러 가지 버전의 컨트롤러가 있었고, 각 컨트롤러의 특성과 장단점이 달라 한 프로젝트에서 동시에 여러 버전의 컨트롤러를 이용하고자 할 때, 이를 가능하게 한 것은 인터페이스를 통한 추상화였다. 모든 컨트롤러를 포용하고 컨트롤러를 구분해 실제 컨트롤러를 손에 쥐어주는 추상화들의 이름이 핸들러 매핑과 핸들러 어댑터였다. 실제로 스프링이 어떤 컨트롤러들을 제공하고 있을까? 실제 스프링의 핸들러 매핑과 어댑터는 어떤 방식으로 작동하고 있을까? 또 여러 컨트롤러 중 가장 선호되는 컨트롤러는 무엇일까?

Controller 인터페이스

과거 버전 스프링 컨트롤러

public interface Controller {
	ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse response) thrlows Exception;
}

스프링도 처음에는 이런 딱딱한 형식의 컨트롤러를 제공했다.

참고: Controller인터페이스는 @Controller 애노테이션과는 전혀 다르다.

OldController
Controller 인터페이스를 간단히 구현해 본 코드.

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")
// 스프링 빈의 이름을 url 패턴으로 맞춘 것
public class OldController implements Controller {
    @Override
    public ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse response) throws Exception {
        System.out.println("OldController.handleRequest");
        return null;
    }
}

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

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

스프링 MVC 구조

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

HandlerMapping(핸들러 매핑)

핸들러 매핑에서 이 컨트롤러를 찾을 수 있어야 한다.
예) 스프링 빈의 이름으로 핸들러를 찾을 수 있는 핸들러 매핑이 필요하다.

HandlerAdapter(핸들러 어댑터)

핸들러 매핑을 통해서 찾은 핸들러를 실행할 수 있는 핸들러 어댑터가 필요하다.
예) Controller 인터페이스를 실행할 수 있는 해들러 어댑터를 찾고 실행해야 한다.

스프링은 이미 필요한 핸들러 매핑과 핸들러 어댑터를 대부분 구현해두었다. 개발자가 직접 핸들러 매핑과 핸들러 어댑터를 만드는 일은 거의 없다.

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

(실제로는 더 많지만, 중요한 부분 위주로 설명하기 위해 일부 생략)

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

HandlerAdapter
0 = RequestMappingHandlerAdapter: 애노테이션 기반의 컨트롤러인 @RequestMapping에서 사용
1 = HttpRequestHandlerAdapter: HttpRequestHandler 처리
2 = SimpleControllerHandlerAdapter: Controller 인터페이스 (애노테이션X, 과거에 사용)처리

핸들러 매핑도, 핸들러 어댑터도 모두 순서대로 찾고 만약 없으면 다음 순서로 넘어간다.
(99% 0순위를 사용한다.)

1. 핸들러 매핑으로 핸들러 조회
1.HandlerMapping을 순서대로 실행해서, 핸들러를 찾는다.
2. 이 경우 빈의 이름으로 핸들러를 찾아야 하기 때문에 이름 그대로 빈 이름으로 핸들러를 찾아주는 BeanNameUrlHandlerMapping가 실행에 성공하고 핸들러인 OldController를 반환한다.

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

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

정리- OldController 핸들러 매핑, 어댑터
OldController를 실행하면서 사용된 객체는 다음과 같다.
HandlerMapping = BeanNameUrlHandlerMapping
HandlerAdapter = SimpleControllerHandlerAdapter

HttpRequestHandler

핸들러 매핑과, 어댑터를 잘 이해하기 위해 Controller 인터페이스가 아닌 다른 핸들러를 알아보자. HttpRequestHandler 핸들러(컨트롤러)는 서블릿과 가장 유사한 형태의 핸들러이다.

public interface HttpRequestHandler {
	void handleRequest(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException;
}

반환 타입이 void이다. 거의 서블릿 코드와 유사한 모습이다.

MyHttpRequestHandler

package hello.servlet.web.springmvc.old;

import org.springframework.stereotype.Component;
import org.springframework.web.HttpRequestHandler;

import javax.servlet.ServletException;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;

@Component("/springmvc/request-handler")
public class MyHttpRequestHandler implements HttpRequestHandler {
    @Override
    public void handleRequest(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        System.out.println("MyHttpRequestHandler.handleRequest");
    }
}

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

2. 핸들러 어댑터 조회
1. HandlerAdapter 의 support()를 순서대로 호출한다.
2. HttpRequestHandlerAdapter 가 HttpRequestHandler 인터페이스를 지원하므로 대상이 된다.

정리- MyHttpRequestHandler 핸들러 매핑, 어댑터
MyHttpRequestHandler를 실행하면서 사용된 객체는 다음과 같다.
HandlerMapping = BeanNameUrlHandlerMapping
HandlerAdapter = HttpRequestHandlerAdapter

@RequestMapping

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

(Controller 인터페이스, HttpRequestHander 방식의 컨트롤러를 살펴본것은 구조적 이해를 위한 것. 실제 실무에서는 가장 좋은것들을 주로 사용하고 있어 다른것들에 대해 깊은 이해를 요구하지는 않습니다.)

뷰 리졸버

스프링이 올라올때 뷰 리졸버도 자동으로 등록해 줌. 그때 설정에 있는 값들을 가져와서 같이 등록한다.

스프링 부트가 가져와서 직접 해주기 때문에 우리가 따로 설정할 필요가 없다.

OldController - View 조회할 수 있도록 변경

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 new ModelAndView("new-form");
    }
}

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

실행해보면 컨트롤러를 정상 호출하지만, Whitelabel Error Page 오류가 발생한다.
application.properties에 다음 코드를 추가하자.

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

뷰 리졸버 - InteranlResourceViewResolver
스프링 부트는 InternalResourceViewResolver라는 뷰 리졸버를 자동으로 등록하는데, 이때 application.properties에 등록한 spring.mvc.view.prefix,spring.mvc.view.suffix설정 정보를 사용해서 등로갛ㄴ다.

권장하지는 않으나 다음과 같이 전체 경로를 주어도 동작하기는 한다.
return new ModelAndView("/WEB-INF/views/new-form.jsp");

실행

http://localhost:8080/springmvc/old-controller
폼 정상출력 확인 가능. 물론 저장기능을 개발하지 않았으므로 폼만 출력되고, 더
진행하면 오류가 발생한다.

뷰 리졸버 동작 방식

스프링 MVC 구조

스프링 부트가 자동으로 등록하는 뷰 리졸버
(실제로는 더 많지만, 중요한 부분 위주로 설명하기 위해 일부 생략)

BeanNameViewResolver: 빈 이름으로 뷰를 찾아서 반환한다.(예: 엑셀 파일 생성 기능에 사용)

InternalResourceViewResolver: JSP를 처리할 수 있는 뷰를 반환한다.

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

2. ViewResolver 호출

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

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

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

5. view.render()
view.render()가 호출되고 InternalResourceView는 forward()를 사용해서 JSP를 실행한다.
InternalResourceView: jsp forward기능이 잇는 것. 예전에 만든 MyView와 유사.

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

참고
다른 뷰는 실제 뷰를 렌더링하지만, jsp의 경우 forward()를 통해서 해당 JSP로 이동(실행)해야 렌더링이 된다. jsp를 제외한 나머지 뷰 템플릿들은 forward()과정 없이 바로 렌더링 된다.

참고
Thymeleaf 뷰 템플릿을 사용하면 ThymeleafViewResolver를 등록해야 한다. 최근에는 라이브러리만 추가함녀 스플이 부트가 이런 작업도 모두 자동화해준다.

스프링 MVC - 시작하기

스프링이 제공하는 컨트롤러는 애노테이션 기반으로 동작해서, 매우 유연하고 실용적이다. 과거에는 자바 언어에 애노테이션이 없기도 했고, 스프링도 처음부터 이런 유연한 컨트롤러를 제공한 것은 아니다.

@RequestMapping
스프링은 애노테이션을 활용한 매우 유연하고, 실용적인 컨트롤러를 만들었는데 이것이 바로 @RequestMapping 애노테이션을 사용하는 컨트롤러이다. 다들 한번쯤 사용해보았을 것이다. 여담이지만 과거에는 스프링 프레임워크가 MVC부분이 약해서 스프링을 사용하더라도 MVC 웹 기술은 스트럿츠 같은 다른 프레임워크를 사용했었다. 그런데 @RequestMapping기반의 애노테이션 컨트롤러가 등장하면서 MVC 부분도 스프링의 완승으로 끝이났다.

@RequestMapping

ReuqestMappingHandlerMapping
ReuqestMappingHandlerAdapter

앞서 보았듯이 가장 우선순위가 높은 핸들러 매핑과 핸드러 어뎁터는 위의것들이다.

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

그럼 이제 본격적으로 애노테이션 기반의 컨트롤러를 사용해보자.
지금까지 만들었던 프레임워크에서 사용했던 컨트롤러를 @RequestMapping기반의 스프링 MVC 컨트롤러를 변경해보자.

SpringMemberFormControllerV1 - 회원등록 폼

package hello.servlet.web.springmvc.v1;

import org.springframework.stereotype.Component;
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에서 애노테이션 기반 컨트롤러로 인식한다.

@RequestMapping: 요청정보를 매핑한다. 해당 URL이 호출되면 이 메서드가 호출된다. 애노테이션을 기반으로 작동하기 때문에, 메서드의 이름은 임의로 지으면 된다.
RequestMapping HandlerMapping에서 아, 이거 핸들러 정보구나!하고 꺼낼 수 있는 대상이 된다.

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

package hello.servlet.web.springmvc.v1;

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

@Component
@RequestMapping
public class SpringMemberFormControllerV1 {

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

RequestMappingHandlerMapping의 핸들러 인식 판단 기준: 스프링 빈 중에서(스프링 빈으로 등록되어 있어야 한다.) @RequestMapping또는 @Controller가 클래스 레벨에 붙어 있는 경우.
위의 2번째 예시도 클래스 레벨에서 @Component와 @RequestMapping이 붙어있어 컨트롤러로 인식할 수 있다.

3.
컴포넌트 스캔 없이 스프링빈으로 직접 등록해 사용

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

< ServletApplication >

//스프링 빈 직접 등록
@Bean
SpringMemberFormControllerV1 springMemberFormControllerV1() {
	return new SpringMemberFormControllerV1(); 
}

주의! - 스프링 3.0이상
스프링부터 3.0(스프링 프레임워크 6.0)부터는 클래스 레벨에 @RequestMapping이 있어도 스프링 컨트롤러로 인식하지 않는다. 오직 @Controller가 있어야 스프링 컨트롤러로 인식한다. 참고로 @RestController는 해당 애노테이션 내부에 @Controller를 포함하고 있으므로 인식된다. 따라서 @Controller가 없는 2번, 3번 코드는 스프링 컨트롤러로 인식되지 않는다.
(RequestMappingHandlerMapping에서 @RequestMapping는 이제 인식하지 않고, 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);
        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;
    }
}

스프링 MVC - 컨트롤러 통합

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

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;

/**
 *  클래스 단위 -> 메서드 단위
 * @RequestMapping 클래스 레벨과 메서드 레벨 조합
 */

@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 members() {

        List<Member> members = memberRepository.findALl();

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

        return mv;
    }

}

조합

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

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

이런 경우, 클레스 레벨에 @RequestMapping을 두면 메서드레벨과 조합이 된다.

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

조합결과
클래스 레벨 @RequestMapping("/springmvc/v2/members")

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

스프링 MVC - 실용적인 방식

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

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

SpringMemberControllerV3

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="/new-form", method= RequestMethod.GET)
    @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";
    }
}

Model파라미터

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

ViewName 직접 반환

뷰의 논리 이름을 반환할 수 있다. (단순히 return값을 String으로 바꾸어도, 스프링에서 해당 변경이 가능하도록 설계되어 있다.)

@RequestParam 사용

스프링은 HTTP 요청 파라미터를 @RequestParam으로 받을 수 있다. @RequestParam("username")은 request.getParameter("username")와 거의 같은 코드라 생각하면 된다. 물론 GET 쿼리 파라미터, POST Form 방식을 모두 지원한다.

@RequestMapping -> @GetMapping, @PostMapping

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

+) @GetMapping코드를 열어보면 @RequestMapping애노테이션(method = RequestMethod.GET까지)을 내부에가지고 있음을 확인할 수 있다.

정리

bien

Good Luck!

이전 포스트

[Spring] #4. MVC 프레임워크 만들기 (김영한_인프런_스프링MVC1)

다음 포스트