[SPRING] Spring 프로젝트 세팅하기

1. 프로젝트 생성하기 (File > New > Dynamic Web Project)

 

2. Maven 프로젝트로 변경 (프로젝트 > Configure > Convert to Maven Project)

 

3. pom.xml에 라이브러리 세팅

(servelt-api, jsp-api, jstl, springWebMVC)

<!-- pom.xml은 라이브러리 관리를 용이하게 한다. -->

	<!-- 라이브러리 버전관리 -->

	<properties>

		<javax.servlet-version>4.0.1</javax.servlet-version>
		<javax.servlet.jsp-version>2.3.3</javax.servlet.jsp-version>
		<javax.servlet.jsp.jstl-version>1.1.2</javax.servlet.jsp.jstl-version>
		<org.springframework-version>5.3.8</org.springframework-version>


	</properties>




	<!-- 라이브러리 셋팅 -->
	<dependencies>
		<!-- https://mvnrepository.com/artifact/javax.servlet/javax.servlet-api -->
		<dependency>
			<groupId>javax.servlet</groupId>
			<artifactId>javax.servlet-api</artifactId>
			<version>${javax.servlet-version}</version>
			<scope>provided</scope>
		</dependency>

		<!-- https://mvnrepository.com/artifact/javax.servlet.jsp/javax.servlet.jsp-api -->
		<dependency>
			<groupId>javax.servlet.jsp</groupId>
			<artifactId>javax.servlet.jsp-api</artifactId>
			<version>${javax.servlet.jsp-version}</version>
			<scope>provided</scope>
		</dependency>

		<!-- https://mvnrepository.com/artifact/javax.servlet/jstl -->
		<dependency>
			<groupId>javax.servlet</groupId>
			<artifactId>jstl</artifactId>
			<version>1.1.2</version>
		</dependency>

		<!-- https://mvnrepository.com/artifact/org.springframework/spring-webmvc -->
		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-webmvc</artifactId>
			<version>${org.springframework-version}</version>
		</dependency>

 

4. web.xml 세팅하기 ( 스프링MVC가 가지고 있는 DispatcherServlet으로 지정 )

-기본적으로 톰캣에 있는 web.xml을 사용하지만, 따로 적어져있을 시 그 파일을 따른다.

-브라우저에 공개되지 않게 하기 위해서 WEB-INF에 작성한다.

-WEB-INF > NEW > OTHER > Xml File 생성

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="4.0"
	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_4_0.xsd">

	<!-- Spring Container에 web.xml을 보고 api를 배치한다!! -->
	<!-- Spring Container란, 주입을 이용하여 객체를 관리하는 컨테이너이다. 
    java bean(클래스)의 생성과 관계, 사용, 생명주기등을 관장한다. -->
	<!-- Spring에서는 new로 객체 생성 하지 않고, Spring Container가 만들어 놓은 객체를
  	  미리 생성해놓고, 그걸 주입한다. (의존성 주입) -->


	<!--현재 웹 어플리케이션에서 받아들이는 모든 요청에 대해
    appServlet이라는 이름으로 정의되어있는 서블릿을 사용하겠다고 명시 -->

	<servlet-mapping>
		<servlet-name>appServlet</servlet-name>
		<url-pattern>/</url-pattern>
	</servlet-mapping>

	<!-- 요청정보를 분석해서 컨트롤러를 선택하는 서블릿을 지정한다. -->

	<servlet>

		<servlet-name>appServlet</servlet-name>
		<!-- Spring MVC에서 제공하고 있는 기본 서블릿을 지정 (2번 작동) -->
		<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>


		<!-- Spring MVC 설정을 위한 xml 파일을 지정한다. -->
		<init-param>
			<param-name>contextConfigLocation</param-name>
			<param-value>/WEB-INF/config/servlet-context.xml</param-value>
		</init-param>
		<load-on-startup>1</load-on-startup>

	</servlet>



	<!-- bean을 정의할 xml 파일을 지정한다 / DB 연결 정보가 들어가 있음 -->

	<context-param>
		<param-name>contextConfigLocation</param-name>
		<param-value>/WEB-INF/config/root-context.xml</param-value>
	</context-param>

	<!-- 리스너설정 / 서버가 가동이 되면 
    위의 파일(servlet-context, root-context.xml) 을 읽어서 Bean을 구성해준다. 
    (가장 먼저 작동 / 1번) -->

	<listener>
		<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
	</listener>


	<!-- 파라미터 인코딩 필터 설정 -->

	<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>
		<init-param>
			<param-name>forceEncoding</param-name>
			<param-value>true</param-value>
		</init-param>
	</filter>


	<filter-mapping>
		<filter-name>encodingFilter</filter-name>
		<url-pattern>/*</url-pattern>
	</filter-mapping>
</web-app>

 

5. ApplicationContext설정하기

-SpringMVC로 만든 웹 애플리케이션에 대한 설정을 하는 파일

*4번의 코드(web.xml) 중 이 부분!

	<!-- Spring MVC 설정을 위한 xml 파일을 지정한다. -->
		<init-param>
			<param-name>contextConfigLocation</param-name>
			<param-value>/WEB-INF/config/servlet-context.xml</param-value>
		</init-param>
		<load-on-startup>1</load-on-startup>

 

6.RootContext파일 설정하기

-SpringMVC 프로젝트 수행 시 사용할 Bean등을 정의하는 파일

*4번의 코드(web.xml) 중 이 부분!

<!-- bean을 정의할 xml 파일을 지정한다 / DB 연결 정보가 들어가 있음 -->

	<context-param>
		<param-name>contextConfigLocation</param-name>
		<param-value>/WEB-INF/config/root-context.xml</param-value>
	</context-param>

 

7.리스너 설정하기

-5번, 6번의 파일을 읽어서 Bean을 구성하는 등의 역할을 하는 리스너를 설정해준다.

*4번의 코드(web.xml) 중 이 부분!

	<!-- 리스너설정 / 서버가 가동이 되면 위의 파일(servlet-context, root-context.xml) 을 읽어서 
    Bean을 구성해준다. (가장 먼저 작동 / 1번) -->

	<listener>
		<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
	</listener>

 

8.파라미터 필터 설정

-파라미터에 한글이 있을 경우를 위해 인코딩을 설정

-UTF-8방식으로 인코딩 될 수 있도록

-스프링에서 제공하는 필터를 사용한다.

<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>
		<init-param>
			<param-name>forceEncoding</param-name>
			<param-value>true</param-value>
		</init-param>
	</filter>


	<filter-mapping>
		<filter-name>encodingFilter</filter-name>
		<url-pattern>/*</url-pattern>
	</filter-mapping>

-모든 요청에 대해 filter-name으로 지정된 필터를 거쳐가도록 맵핑

 

9. 스키마 설정하기

WEB-INF > New > File > Config에 root-context.xml과 servlet-context.xml 생성 후 세팅해준다.

 

root-context.xml

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://www.springframework.org/schema/beans
		http://www.springframework.org/schema/beans/spring-beans.xsd"></beans>

 

servlet-context.xml파일에 Controller를 찾을 수 있도록 설정을 해줍니다.

-스캔한 패키지 내부의 클래스 중 Controller 어노테이션을 가지고 있는 클래스들을 Controller로 로딩하도록 한다.

<?xml version="1.0" encoding="UTF-8"?>
<beans:beans
	xmlns="http://www.springframework.org/schema/mvc"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xmlns:beans="http://www.springframework.org/schema/beans"
	xmlns:context="http://www.springframework.org/schema/context"
	xsi:schemaLocation="http://www.springframework.org/schema/mvc
						http://www.springframework.org/schema/mvc/spring-mvc.xsd
						http://www.springframework.org/schema/beans
						http://www.springframework.org/schema/beans/spring-beans.xsd
						http://www.springframework.org/schema/context
						http://www.springframework.org/schema/context/spring-context.xsd">

	<annotation-driven />

	<!-- 스캔한 bean들이 모여있는 패키지를 지정한다. @Annotation 붙은 것을 찾기 시작 -->
	<context:component-scan base-package="kr.yena.controller" />

 

10.Controller만들어보기

@Controller
public class HomeController {
	
	@RequestMapping(value = "/", method = RequestMethod.GET)
	public String home() {
		
		return "/WEB-INF/views/index.jsp";
		
	}
}

 

11.jsp 설정

-WEB-INF > New folder > views > New jsp

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>Insert title here</title>
</head>
<body>
<h1> Hello Spring MVC JAVA~ </h1>
</body>
</html>

 

12. servlet-context.xml에 뷰리졸버 생성

-모든 jsp 파일은 "/WEB-INF/views/"폴더 하위 경로로 붙기 때문에 리졸버를 이용해서 중복되는 내용 제거

-Controller 작성이 수행되고 랜더링 될 jsp를 설정한다.

	<!--  Controller의 매서드에서 반환하는 문자열 앞 뒤에 붙일 경로 정보를 세팅한다.뷰리졸버 -->	
		<beans:bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
			<beans:property name="prefix" value="/WEB-INF/views/"/>
			<beans:property name="suffix" value=".jsp"/>
		</beans:bean>

 

13. servlet-context.xml에 정적 파일 경로 설정

-HTML에서 사용할 정적 파일들(이미지, 사운드, js, css등)이 배치될 경로를 지정한다.

-resources > New File > image 파일 생성 후 그 안에 이미지 등을 담아주기

		<!--  정적파일(이미지, 사운드, 동영상, JS, CSS 등 ) 경로 설정-->
		<resources mapping="/resources/**" location="/resources/"/>