4.1 Spring MVC

1) Spring MVC란?

MVC란?

• MVC는 Model-View-Controller의 약자입니다.

• 원래는 제록스 연구소에서 일하던 트뤼그베 린즈커그가 처음으로 소개한 개념으로, 데스트톱 어플리케이션용으로 고안되었습니다.

• Model : 모델은 뷰가 렌더링하는데 필요한 데이터입니다. 예를 들어 사용자가 요청한 상품 목록이나, 주문 내역이 이에 해당합니다.

• View : 웹 애플리케이션에서 뷰(View)는 실제로 보이는 부분이며, 모델을 사용해 렌더링을 합니다. 뷰는 JSP, JSF, PDF, XML등으로 결과를 표현합니다.

• Controller : 컨트롤러는 사용자의 액션에 응답하는 컴포넌트입니다. 컨트롤러는 모델을 업데이트하고, 다른 액션을 수행합니다.

MVC Model 1 아키텍처

브라우저가 요청을 하게 되면 해당 요청을 JSP가 받게 됩니다. 그러니까 따라서 요청만큼 JSP 페이지가 존재해야겠죠.

이런 JSP는 Java로 만들어진 클래스인 Java bean을(2) 이용해서 데이터베이스(3)를 사용하게 되고요.

이 결과를 화면에 출력하는 이런 일을 하게 되는 거죠.

여기에서 이야기하는 Java bean이라고 하는 것은 JDBC로 작성했던 Role Dao 같은 클래스.

문제점은 JSP 자체에 Java 코드랑 HTML 이런 코드들이 막 섞여있어 유지보수 어려움 -> 다음 모델

MVC Model 2 아키텍처

요청 자체를 서블릿이 받게 하고요.(1)

서블릿이 Java bean을 이용해서 DB에서 데이터를 꺼내오고

이런 결과들을 JSP를 통해서 결과를 화면에 보여주게 하는 모델 사용 (5)

서블릿은 요청과 데이터를 처리하는 컨트롤러의 역할을 수행하고 있고요.

JSP는 모델의 결과를 보여주게 하는 View의 역할을 하고 있는 것을 볼 수 있겠죠.

이렇게 함으로써 로직과 뷰를 분리할 수가 있게 되는 거예요.

MVC Model2 발전형태

클라이언트가 보내는 모든 요청을 프론터 컨트롤러라고 하는 서블릿 클래스가 다 받아요.

이 서블릿은 딱 하나만 존재해요. 이게 모든 요청을 다 받지만 프론트 컨트롤러는 요청만 받고 실제 일은 처리하지 않아요.

실제 일은 여기에 나오는 컨트롤러 클래스에게 위임합니다.

이런 컨트롤러 클래스를 가리켜서 컨트롤러 클래스 혹은 핸들러 클래스라고 이야기하기도 해요.

서블릿은 관련된 요청을 처리하기에 조금 불편한 구조를 가지고 있어요. 이런 단점을 해결하기 위해서 사용자의 모든 요청은 서블릿이 받고 그 요청의 실제 처리는 컨트롤러 혹은 핸들러라고 불리는 클래스에게 위임함으로써 관련된 URL을 하나의 클래스에서 다 처리할 수 있도록 하게 돼요.

이런 컨트롤러는 Java bean 등을 이용해서 결과를 만들어내고 만들어진 결과를 모델에다 담고 프론트 컨트롤러에게 보내면 프론트 컨트롤러는 알맞은 뷰에게 모델을 전달해서 그 결과를 출력하게 됩니다.

Spring Web Module

Model2 MVC 패턴을 지원하는 Spring Module

앞에서 얘기한 모델 2의 발전된 형태가 Spring 프레임워크 모듈 중에 하나인 Web 모듈에 구현이 되어 있고요. 이러한 Web 모듈을 보통 Spring MVC라고 해요.

---

2) Spring MVC구성요소

Spring MVC 기본 동작 흐름

파랑: 제공, 보라: 개발자직접, 녹색: 둘 다

DispatcherServlet

• 프론트 컨트롤러 (Front Controller)

• 클라이언트의 모든 요청을 받은 후 이를 처리할 핸들러에게 넘기고 핸들러가 처리한 결과를 받아 사용자에게 응답 결과를 보여준다.

• DispathcerServlet은 여러 컴포넌트를 이용해 작업을 처리한다.

DispatcherServlet 내부 동작흐름

요청 선처리 작업시 사용된 컴포넌트
org.springframework.web.servlet.LocaleResolver

• 지역 정보를 결정해주는 전략 오브젝트이다.

• 디폴트인 AcceptHeaderLocalResolver는 HTTP 헤더의 정보를 보고 지역정보를 설정해준다.

org.springframework.web.servlet.FlashMapManager

• FlashMap객체를 조회(retrieve) & 저장을 위한 인터페이스

• RedirectAttributes의 addFlashAttribute메소드를 이용해서 저장한다.

• 리다이렉트 후 조회를 하면 바로 정보는 삭제된다.

org.springframework.web.context.request.RequestContextHolder

• 일반 빈에서 HttpServletRequest, HttpServletResponse, HttpSession 등을 사용할 수 있도록 한다.

• 해당 객체를 일반 빈에서 사용하게 되면, Web에 종속적이 될 수 있다.

org.springframework.web.multipart.MultipartResolver

• 멀티파트 파일 업로드를 처리하는 전략

요청 전달시 사용된 컴포넌트

org.springframework.web.servlet.HandlerMapping

• HandlerMapping구현체는 어떤 핸들러가 요청을 처리할지에 대한 정보를 알고 있다.

• 디폴트로 설정되는 있는 핸들러매핑은 BeanNameHandlerMapping과 DefaultAnnotationHandlerMapping 2가지가 설정되어 있다.

org.springframework.web.servlet.HandlerExecutionChain

• HandlerExecutionChain구현체는 실제로 호출된 핸들러에 대한 참조를 가지고 있다.

• 즉, 무엇이 실행되어야 될지 알고 있는 객체라고 말할 수 있으며, 핸들러 실행전과 실행후에 수행될 HandlerInterceptor도 참조하고 있다.

org.springframework.web.servlet.HandlerAdapter

• 실제 핸들러를 실행하는 역할을 담당한다.

• 핸들러 어댑터는 선택된 핸들러를 실행하는 방법과 응답을 ModelAndView로 변화하는 방법에 대해 알고 있다.

• 디폴트로 설정되어 있는 핸들러어댑터는 HttpRequestHandlerAdapter, SimpleControllerHandlerAdapter, AnnotationMethodHanlderAdapter 3가지이다.

• @RequestMapping과 @Controller 애노테이션을 통해 정의되는 컨트롤러의 경우 DefaultAnnotationHandlerMapping에 의해 핸들러가 결정되고, 그에 대응되는 AnnotationMethodHandlerAdapter에 의해 호출이 일어난다.

요청 처리시 사용된 컴포넌트

org.springframework.web.servlet.ModelAndView

• ModelAndView는 Controller의 처리 결과를 보여줄 view와 view에서 사용할 값을 전달하는 클래스이다.

org.springframework.web.servlet.RequestToViewNameTranslator

• 컨트롤러에서 뷰 이름이나 뷰 오브젝트를 제공해주지 않았을 경우 URL과 같은 요청정보를 참고해서 자동으로 뷰 이름을 생성해주는 전략 오브젝트이다. 디폴트는 DefaultRequestToViewNameTranslator이다.

예외 처리시 사용된 컴포넌트

org.springframework.web.servlet.handlerexceptionresolver

• 기본적으로 DispatcherServlet이 DefaultHandlerExceptionResolver를 등록한다.

• HandlerExceptionResolver는 예외가 던져졌을 때 어떤 핸들러를 실행할 것인지에 대한 정보를 제공한다.

뷰 렌더링 과정시 사용된 컴포넌트

org.springframework.web.servlet.ViewResolver

• 컨트롤러가 리턴한 뷰 이름을 참고해서 적절한 뷰 오브젝트를 찾아주는 로직을 가진 전략 오프젝트이다.

• 뷰의 종류에 따라 적절한 뷰 리졸버를 추가로 설정해줄 수 있다.

---

3) Spring MVC를 이용한 웹 페이지 작성 실습

프로젝트 이름: mvcexam04

 

pom.xml은 링크에서 보기

 

error log1 - Dynamic Web Module 버전 바꾸기

.settings/org.eclipse.wst.common.project.facet.core.xml 파일에 jst.web 버전 2.3 -> 3.1로 바꾸고 업데이트 이클립스 재시작

<?xml version="1.0" encoding="UTF-8"?>
<faceted-project>
  <fixed facet="wst.jsdt.web"/>
  <installed facet="jst.web" version="3.1"/>
  <installed facet="wst.jsdt.web" version="1.0"/>
  <installed facet="java" version="1.8"/>
</faceted-project>

web.xml의 버전 바꾸기

xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
version="3.1">

<faceted-project>
  <fixed facet="wst.jsdt.web"/>
  <installed facet="jst.web" version="3.1"/>
  <installed facet="wst.jsdt.web" version="1.0"/>
  <installed facet="java" version="1.8"/>
</faceted-project>

 

error log2 - jsp 파일 이름 변경 후 404 에러

 

WEB-INF/views 폴더 내에 jsp 파일 생성했는데 파일명에 오타가 나서 이름 변경한 경우 계속 404에러가 뜨는 경우 발행.해결책: 파일 삭제 후 JSP File을 통해 정확한 이름으로 다시 생성하기

 

error log3 한글 깨짐 _ web.xml에 첨부 (web-app 태그 안에)

    <filter-name>encodingFilter</filter-name>

    <filter-class>

        org.springframework.web.filter.CharacterEncodingFilter

</filter-class>

<init-param>

        <param-name>encoding</param-name>

        <param-value>UTF-8</param-value>

</init-param>

    <filter-name>encodingFilter</filter-name>

    <url-pattern>/\*</url-pattern>

 

DispatcherServlet을 FrontController로 설정하기 (3가지 방법)

• web.xml 파일에 설정 (많이 사용, 또 다시 2가지 방법으로 나뉨)

 첫번째 방법, web.xml 파일에 spring 설정 읽어들이도록 DispathcerServlet설정

두번째 방법, Java config(클래스)를 spring 설정 읽어들이도록 DispathcerServlet설정 (강의에서 진행한 실습)

• javax.servlet.ServletContainerInitializer 사용 (강의에서는 알려주지 않음)

  • 서블릿 3.0 스펙 이상에서 web.xml파일을 대신해서 사용할 수 있다.

  • Spring MVC는 ServletContainerInitializer를 구현하고 있는 SpringServletContainerInitializer를 제공한다.

  • SpringServletContainerInitializer는 WebApplicationInitializer 구현체를 찾아 인스턴스를 만들고 해당 인스턴스의 onStartup 메소드를 호출하여 초기화한다.
  • 그래서 맨 처음 실행 시 시간이 걸린다는 점이 있다.

• org.springframework.web.WebApplicationInitializer 인터페이스를 구현해서 사용 (많이 사용)

 

Spring MVC 설정

kr.or.connect.webmvc.config.WebMvcContextConfiguration

error log4 - implements WebMvcConfigurer시 구현해야 하는 메서드가 너무 많다.

public class WebMvcContextConfiguration implements WebMvcConfigurer 

public class WebMvcContextConfiguration extends WebMvcConfigurerAdapter

둘 중 되는 걸로 하자

 

### 관련 설명

@Configuration

• org.springframework.context.annotation의 Configuration 애노테이션과 Bean 애노테이션 코드를 이용하여 스프링 컨테이너에 새로운 빈 객체를 제공할 수 있다.

@EnableWebMvc

• DispatcherServlet의 RequestMappingHandlerMapping, RequestMappingHandlerAdapter, ExceptionHandlerExceptionResolver, MessageConverter 등 Web에 필요한 빈들을 대부분 자동으로 설정해준다.

• xml로 설정의 mvc:annotation-driven/ 와 동일하다.(수업 안다룸)

• 기본 설정 이외의 설정이 필요하다면 WebMvcConfigurerAdapter 를 상속받도록 Java config class를 작성한 후, 필요한 메소드를 오버라이딩 하도록 한다.

WebMvcConfigurationSupport 을 더 자세히 알아보고 싶다면

• https://github.com/spring-projects/spring-framework/blob/master/spring-webmvc/src/main/java/org/springframework/web/servlet/config/annotation/WebMvcConfigurationSupport.java

@ComponentScan

• ComponentScan애노테이션을 이용하면 Controller, Service, Repository, Component애노테이션이 붙은 클래스를 찾아 스프링 컨테이너가 관리하게 된다.

• DefaultAnnotationHandlerMapping과 RequestMappingHandlerMapping구현체는 다른 핸드러 매핑보다 훨씬 더 정교한 작업을 수행한다. 이 두 개의 구현체는 애노테이션을 사용해 매핑 관계를 찾는 매우 강력한 기능을 가지고 있다. 이들 구현체는 스프링 컨테이너 즉 애플리케이션 컨텍스트에 있는 요청 처리 빈에서 RequestMapping애노테이션을 클래스나 메소드에서 찾아 HandlerMapping객체를 생성하게 된다.

• HandlerMapping은 서버로 들어온 요청을 어느 핸들러로 전달할지 결정하는 역할을 수행한다.

• DefaultAnnotationHandlerMapping은 DispatcherServlet이 기본으로 등록하는 기본 핸들러 맵핑 객체이고, RequestMappingHandlerMapping은 더 강력하고 유연하지만 사용하려면 명시적으로 설정해야 한다.

WebMvcConfigurer

• org.springframework.web.servlet.config.annotation.WebMvcConfigurer

• @EnableWebMvc 를 이용하면 기본적인 설정이 모두 자동으로 되지만, 기본 설정 이외의 설정이 필요할 경우 해당 클래스(인터페이스)를 상속 받은 후, 메소드를 오버라이딩 하여 구현한다.

Controller(Handler) 클래스 작성하기 (실제 요청을 처리하는 클래스)

• @Controller 애노테이션을 클래스 위에 붙인다.

• 맵핑을 위해 @RequestMapping 애노테이션을 클래스나 메소드에서 사용한다.

@RequestMapping

• Http 요청과 이를 다루기 위한 Controller 의 메소드를 연결하는 어노테이션

• Http Method 와 연결하는 방법
  - @RequestMapping(value="/users", method=RequestMethod.POST)
  - From Spring 4.3 version (@GetMapping, @PostMapping, @PutMapping, @DeleteMapping, @PatchMapping)

• Http 특정 해더와 연결하는 방법
  - @RequestMapping(method = RequestMethod.GET, headers = "content-type=application/json")

• Http Parameter 와 연결하는 방법
  - @RequestMapping(method = RequestMethod.GET, params = "type=raw")

• Content-Type Header 와 연결하는 방법
  - @RequestMapping(method = RequestMethod.GET, consumes = "application/json")

• Accept Header 와 연결하는 방법
  - @RequestMapping(method = RequestMethod.GET, produces = "application/json")

Controller작성 실습

1. 웹 브라우저에서 http://localhost:8080/mvcexam/plusform 이라고 요청을 보 내면 서버는 웹 브라우저에게 2개의 값을 입력받을 수 있는 입력 창과 버튼이 있는 화면을 출력한다.

2. 웹 브라우저에 2개의 값을 입력하고 버튼을 클릭하면 http://localhost:8080/mvcexam/plus URL로 2개의 입력값이 POST방식으로 서버에게 전달한다. 서버는 2개의 값을 더한 후, 그 결과 값을 JSP에게 request scope으로 전달하여 출력한다.

Spring MVC가 지원하는 Controller메소드 인수 타입

• javax.servlet.ServletRequest

• javax.servlet.http.HttpServletRequest

• org.springframework.web.multipart.MultipartRequest

• org.springframework.web.multipart.MultipartHttpServletRequest

• javax.servlet.ServletResponse

• javax.servlet.http.HttpServletResponse

• javax.servlet.http.HttpSession

• org.springframework.web.context.request.WebRequest

• org.springframework.web.context.request.NativeWebRequest

• java.util.Locale

• java.io.InputStream

• java.io.Reader

• java.io.OutputStream

• java.io.Writer

• javax.security.Principal

• java.util.Map

• org.springframework.ui.Model

• org.springframework.ui.ModelMap

• org.springframework.web.multipart.MultipartFile

• javax.servlet.http.Part

• org.springframework.web.servlet.mvc.support.RedirectAttributes

• org.springframework.validation.Errors

• org.springframework.validation.BindingResult

• org.springframework.web.bind.support.SessionStatus

• org.springframework.web.util.UriComponentsBuilder

• org.springframework.http.HttpEntity<?>

• Command 또는 Form 객체

Spring MVC가 지원하는 메소드 인수 애노테이션

• @RequestParam

• @RequestHeader

• @RequestBody

• @RequestPart

• @ModelAttribute 사용예시는 UserController

• @PathVariable

• @CookieValue

@RequestParam 사용예시는 PlusController

• Mapping된 메소드의 Argument에 붙일 수 있는 어노테이션

• @RequestParam의 name에는 http parameter의 name과 멥핑

• @RequestParam의 required는 필수인지 아닌지 판단

@PathVariable 사용예시는 GoodsController

• @RequestMapping의 path에 변수명을 입력받기 위한 place holder가 필요함

• place holder의 이름과 PathVariable의 name 값과 같으면 mapping 됨

• required 속성은 default true 임

@RequestHeader

• 요청 정보의 헤더 정보를 읽어들 일 때 사용

• @RequestHeader(name="헤더명") String 변수명

Spring MVC가 지원하는 메소드 리턴 값

• org.springframework.web.servlet.ModelAndView

• org.springframework.ui.Model

• java.util.Map

• org.springframework.ui.ModelMap

• org.springframework.web.servlet.View

• java.lang.String

• java.lang.Void

• org.springframework.http.HttpEntity<?>

• org.springframework.http.ResponseEntity<?>

• 기타 리턴 타입