버전 변경

스프링 버전 변경

<properties>
	<java-version>11</java-version>
	<org.springframework-version>5.0.7.RELEASE</org.springframework-
    version>
	<org.aspectj-version>1.6.10</org.aspectj-version>
	<org.slf4j-version>1.6.6</org.slf4j-version>
</properties>

pom.xml에서 스프링 프레임워크 버전은 3.1.1로 생성되므로, 예제는 5.0.7 버전으로 수정한다.

완료된 후에는 프로젝트 구조의 'Properties→Maven Dependencies' 항목을 통해서 스프링 프레임워크 라이브러리들이 위와 같이 제대로 변경되었는지를 확인한다.

---

Java version 변경

            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>2.5.1</version>
                <configuration>
                    <source>11</source>
                    <target>11</target>
                    <compilerArgument>-Xlint:all</compilerArgument>
                    <showWarnings>true</showWarnings>
                    <showDeprecation>true</showDeprecation>
                </configuration>
            </plugin>

생성된 프로젝트의 JRE System Library를 보면 'JavaSE-1.6'버전으로 생성된 것을 볼 수 있다. 스프링 5버전의 경우 최소 1.8 이상을 사용해야 하기 때문에 이를 변경해야 한다. 앞에서 JDK 환경은 11버전으로 변경했으므로 프로젝트의 JRE System Library 역시 변경해야 한다.
pom.xml의 <plugin> 태그 중 maven-compiler-plugin의 내용을 위와 같이 1.6에서 11로 변경한다.

이 후 프로젝트를 선택한 상태에서 'Maven > Update Project'를 실행한다.

실행한 후에 프로젝트의 컴파일이나 실행환경이 JDK 11으로 설정된 것을 확인할 수 있다.

---

인코딩

한글이 깨지는 건 인코딩이 맞지 않아서 발생하는 문제이다. 우린 이를 해결하기 위해 인코딩을 UTF-8로 맞춘다.

@GetMapping("/my")
public String home(Locale locale, Model model) {
	logger.info("Welcome home! The client locale is {}.", locale);

	Date date = new Date();
	DateFormat dateFormat = 
    DateFormat.getDateTimeInstance(DateFormat.LONG, 
    	DateFormat.LONG, locale);

	String formattedDate = dateFormat.format(date);
	System.out.println(formattedDate);
	model.addAttribute("serverTime", formattedDate);

	return "home";
}

위의 HomeController.java 파일에 System.out.println(formattedDate); 를 추가한다.

콘솔에서는 위와 같이 한글이 깨지지 않고 출력되는 것을 확인할 수 있다. 그런데 똑같은 문자열을 외부로 보냈을 때, 브라우저에서는 한글이 깨진다.

위의 코드에서 formattedDate 문자열을 그대로 model 객체에 집어넣어서 jsp에서 출력을 하는데 한글이 깨진 것이다.

이를 해결하기 위해 <filter>를 이용해야 한다.

web.xml을 열고 다음의 코드를 <servlet-mapping> 밑에 추가한다.

	<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.xml 코드는 다음과 같다.

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://java.sun.com/xml/ns/javaee https://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">

	<!-- The definition of the Root Spring Container shared by all Servlets and Filters -->
	<context-param>
		<param-name>contextConfigLocation</param-name>
		<param-value>/WEB-INF/spring/root-context.xml</param-value>
	</context-param>
	
	<!-- Creates the Spring Container shared by all Servlets and Filters -->
	<listener>
		<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
	</listener>

	<!-- Processes application requests -->
	<servlet>
		<servlet-name>appServlet</servlet-name>
		<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
		<init-param>
			<param-name>contextConfigLocation</param-name>
			<param-value>/WEB-INF/spring/appServlet/servlet-context.xml</param-value>
		</init-param>
		<load-on-startup>1</load-on-startup>
	</servlet>
		
	<servlet-mapping>
		<servlet-name>appServlet</servlet-name>
		<url-pattern>/</url-pattern>
	</servlet-mapping>
	
	<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>

<filter> 필터란?

서비스함수에서 메소드에 따라서 doPost/doGet으로 나뉘는데, Parameter인 request와 response가 들어온다. 이 request와 response를 수행하기 직전에 실행할 수 있는 것이 필터이다. 필터는 모든 요청이 들어오면 <filter-mapping>에 선언되어 있는 <url-pattern>에 따라서 특정한 필터를 동작시킬 수 있다. 이 필터는 서비스 시작 전과 종료 전에 동작할 수 있다.

그럼 위 코드를 분석해보자. 우리한테 전달되는 것은 url이므로 <url-pattern> 부터 확인하도록 한다.

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

<url-pattern>/*</url-pattern> : 모든 요청에 대해서 encodingFilter를 동작시킨다라는 뜻이다. 그럼 이제 encodingFilter가 뭔지 확인해보자.

	<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-name>encodingFilter</filter-name>는 스프링이 제공하는 필터중에 CharacterEncoding을 해주는 필터를 동작시키겠다. 인코딩을 UTF-8로 맞춘다. 어떻게? 강제적으로! 을 뜻하는 코드인 것이다. 즉, 모든 요청과 응답에 대해 CharacterEncoding을 강제적으로 맞춘다는 의미이다.

위와 같이 정상적으로 출력이 되는 모습을 확인할 수 있다.

인코딩 추가작업

'Window > Preferences > Web' 의 CSS Files, HTML Files, JSP Files을 모두 UTF-8로 변경한다.

'General > Workspace' 의 Text file encoding 역시 UTF-8로 변경한다.

---

home.jsp

다음 코드를 테스트할때 추가한다.

<%@ page session="false" language="java" contentType="text/html; charset=UTF-8" 
	pageEncoding="UTF-8"%>