[스프링 1] 9장. 스프링 MVC 시작하기

해당 포스트는 초보 웹 개발자를 위한 스프링 5 프로그래밍 입문 [최범균 저] 책 내용을 참고하였습니다.

---

 

❗ 웹 어플리케이션 개발을 위한 디렉터리 구조

• src/main/java : 스프링 소스 코드
• src/main/webapp : HTML, CSS, JS, JSP 등 웹 어플리케이션을 구현하는데 필요한 코드
• src/main/webapp/WEB-INF : web.xml 파일 위치(DispatcherServlet 등록)
• src/main/webapp/WEB-INF/view

📌 pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" 
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
		http://maven.apache.org/xsd/maven-4.0.0.xsd">
	...
	<artifactId>sp5-chap09</artifactId>
    	<!--packaging 태그의 기본값은 jar-->
    	<!--서블릿/JSP 웹 어플리케이션을 개발할 경우 war-web application archive-를 값으로 줘야한다-->
	<packaging>war</packaging> 
    
    	<!--스프링으로 웹 어플리케이션 개발에 필요한 의존 설정-->
	<dependencies>
		<dependency>
			<groupId>javax.servlet</groupId>
			<artifactId>javax.servlet-api</artifactId>
			<version>3.1.0</version>
			<scope>provided</scope>
		</dependency>

		<dependency>
			<groupId>javax.servlet.jsp</groupId>
			<artifactId>javax.servlet.jsp-api</artifactId>
			<version>2.3.2-b02</version>
			<scope>provided</scope>
		</dependency>

		<dependency>
			<groupId>javax.servlet</groupId>
			<artifactId>jstl</artifactId>
			<version>1.2</version>
		</dependency>

		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-webmvc</artifactId>
			<version>5.0.2.RELEASE</version>
		</dependency>
	</dependencies>

	<build>
		...
	</build>

</project>

---

❗ 스프링 MVC를 위한 설정

스프링 MVC를 실행하는데 필요한 최소 설정

• 스프링 MVC의 주요 설정(HandlerMapping, ViewResolver 등)
• 스프링의 DispatcherServlet 설정

📌 스프링 MVC 설정

package config;

import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.DefaultServletHandlerConfigurer;
import org.springframework.web.servlet.config.annotation.EnableWebMvc;
import org.springframework.web.servlet.config.annotation.ViewResolverRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

@Configuration
@EnableWebMvc // 스프링 MVC 설정 활성화 애노테이션. 스프링 MVC를 사용하는데 필요한 다양한 설정을 생성
public class MvcConfig implements WebMvcConfigurer {

	// DispatcherServlet의 매핑 경로를 '/'로 주었을때, JSP/HTML/CSS 등을 올바르게 처리하기 위한 설정 추가
	@Override
	public void configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer) {
		configurer.enable();
	}
	
    	// JSP를 이용해 컨트롤러의 실행 결과를 보여주기 위한 설정 추가
	@Override
	public void configureViewResolvers(ViewResolverRegistry registry) {
		registry.jsp("/WEB-INF/view/", ".jsp");
	}

}

@EnableWebMvc 애노테이션은 스프링 MVC를 사용하기 위한 다양한 구성 요소 설정을 대신 해준다.

 

WebMvcConfigurer 인터페이스는 스프링 MVC의 개별 설정을 조정할 때 사용한다.

위 두 메소드는 각각 디폴트 서블릿과 ViewResolver와 관련된 설정을 조정한다.

 

📌 DispatcherServlet 설정

스프링 MVC가 웹 요청을 처리하려면 DispatcherServlet을 통해서 웹 요청을 받아야한다.

web.xml 파일에 DispatcherServlet을 등록한다.

<?xml version="1.0" encoding="UTF-8"?>

<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee" 
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee 
             http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
	version="3.1">

	<servlet>
            	<!--DispatcherServlet을 dispatcher라는 이름으로 등록-->
		<servlet-name>dispatcher</servlet-name>
		<servlet-class>
			org.springframework.web.servlet.DispatcherServlet
		</servlet-class>
        	<!--contextClass 초기화 파라미터 설정. 자바 설정을 이용한다면, 웹 어플리케이션 용 스프링 컨테이너 클래스인 AnnotationConfigWebApplicationContext 클래스를 사용-->
		<init-param>
			<param-name>contextClass</param-name>
			<param-value>
				org.springframework.web.context.support.AnnotationConfigWebApplicationContext
			</param-value>
		</init-param>
        	<!--contextConfiguration 초기화 파라미터 값 지정. 파라미터로는 스프링 설정 클래스 목록을 지정-->
		<init-param>
			<param-name>contextConfigLocation</param-name>
			<param-value>
				config.MvcConfig
				config.ControllerConfig
			</param-value>
        	<!--톰캣과 같은 컨테이너가 웹 어플리케이션을 구동할 때 이 서블릿을 함께 실행하도록 설정-->
		</init-param>
		<load-on-startup>1</load-on-startup>
	</servlet>
	
    	<!--모든 요청을 DispatcherServlet이 처리하도록 서블릿 매핑 설정-->
	<servlet-mapping>
		<servlet-name>dispatcher</servlet-name>
		<url-pattern>/</url-pattern>
	</servlet-mapping>

    	<!--HTTP 요청 파라미터의 인코딩 처리를 위한 서블릿 필터 등록. 사용할 인코딩 지정-->
	<filter>
		<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>
	<filter-mapping>
		<filter-name>encodingFilter</filter-name>
		<url-pattern>/*</url-pattern>
	</filter-mapping>

</web-app>

---

❗ 코드 구현

• 클라이언트의 요청을 알맞게 처리할 컨트롤러
• 처리 결과를 보여줄 JSP

📌 컨트롤러 구현

@Controller // 스프링 MVC에서 컨트롤러로 사용
public class HelloController {

	@GetMapping("/hello") // 메서드가 처리할 요청 경로 지정. "/hello" 경로로 들어온 GET 요청을 hello() 메서드로 처리
	public String hello(Model model, //Model 파라미터는 컨트롤러의 처리 결과를 뷰에 전달할 때 사용
	    //@RequestParam: HTTP 요청 파라미터의 값을 메서드의 파라미터로 전달
            @RequestParam(value = "name", required = false) String name) {
            	// greeting 이라는 모델 속성에 두번째 인자를 값으로 설정
		model.addAttribute("greeting", "안녕하세요, " + name);
        	// 컨트롤러의 처리 결과를 보여줄 뷰 이름으로 hello 사용
		return "hello";
	}
}

스프링 MVC 프레임워크에서 컨트롤러(Controller)는 웹 요청을 처리하고 그 결과를 뷰에 전달하는 스프링 빈 객체이다.

 

스프링 컨트롤러로 사용될 클래스는 @Controller 애노테이션을 붙여야 하고, @GetMapping이나 @PostMapping 애노테이션과 같은 요청 매핑 애노테이션으로 처리할 경로를 지정해줘야한다.

코드에서의 매핑은 아래와 같이 될 것이다.

 

http://host:port/sp5-chap09/hello?name=bk

톰캣의 경우. webapps\sp5-chap09 폴더는 웹 브라우저에서 http://host/sp5-chap09 경로가 되고, 여기서 sp5-chap09는 컨텍스트 경로가 된다.

경로에서 받은 name 요청 파라미터의 값인 "bk" 는 hello() 메서드의 name 파라미터에 전달된다.

 

컨트롤러를 구현했다면 컨트롤러를 스프링 빈으로 등록해야한다.

package config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import chap09.HelloController;

@Configuration
public class ControllerConfig {

	@Bean
	public HelloController helloController() {
		return new HelloController();
	}

}

 

📌 JSP 구현

컨트롤러가 생성한 결과를  보여줄 뷰 코드를 view 폴더에 hello.jsp 파일로 추가한다.

<%@ page contentType="text/html; charset=utf-8" %>
<!DOCTYPE html>
<html>
  <head>
    <title>Hello</title>
  </head>
  <body>
    인사말: ${greeting}
  </body>
</html>

뷰이름과 JSP 파일과의 연결은 MvcConfig 클래스에서 이루어진다.

@Override
	public void configureViewResolvers(ViewResolverRegistry registry) {
		registry.jsp("/WEB-INF/view/", ".jsp");
	}

/WEB-INF/view/hello.jsp

위와 같이 뷰 이름과 MvcConfig 클래스에서 설정한 대로 JSP 파일은 연결된다.

 

 

아래와 같이 JSP EL(Expression Language)가 사용되었다.

인사말: %{ greeting }

컨트롤러를 구현할 때 Model에 추가한 속성인 greeting과 동일하다.

스프링 MVC 프레임워크가 JSP 코드에서 접근할 수 있게 HttpServletRequest에 옮겨주기 때문에 가능하다.

---

Spring 1

EDITOR: OJO