MVC 프로젝트 생성 및 기본 설정 - 3

순서

1. Servlet 버전 변경

2. 필수 패키지 추가 및 설정

3. 아파치 톰캣 연동

4. 프로젝트 '절대 경로' 구조 변경

5. 구동 테스트

6. 한글 환경 설정

1. Servlet 버전 변경

JAVA 설정 등을 이용하기 위해서 servlet 3.0 이상 버전으로 변경해줍니다.

pom.xml에 있는 기존의 servlet 2.5 버전은 주석 처리 혹은 삭제한 후 servlet 3.1 버전을 추가 및 저장합니다.

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

변경 전

변경 후

2. 필수 패키지 추가 및 설정

패키지 추가

src/main/java 경로에 3개의 패키지를 추가합니다.

- com.swan.model : VO(value Object) 패키지입니다. 데이터 타입을 저장합니다.

- com.swan.mapper : DAO(Data Access Object) 역할을 하는 패키지입니다. 데이터베이스 접속하는 역할을 합니다.

- com.swan.service :  Service 패키지입니다. Mapper와 Controller 사이를 연결해주는 역할을 합니다.

 

스프링에서 각 패키지를 인식할 수 있도록 root-context.xml 파일 설정을 변경해줘야 합니다.

 

root-context.xml 파일을 연 후 하단의 Namespace를 클릭해서 해당 창을 열고, context, mybatis-spring을 체크하여 저장합니다.

다시 하단의 Source 탭을 누른 후 아래의 코드를 추가합니다. 

<mybatis-spring:scan base-package="com.swan.mapper"/>
<context:component-scan base-package="com.swan.model"></context:component-scan>
<context:component-scan base-package="com.swan.service"></context:component-scan>

Mapper XML 저장 경로 생성

동적 SQL문을 사용하기 위해 .xml 파일들을 저장할 경로를 생성합니다.

 

src/main/resources 경로에 mapper 패키지 명(com.swan.mapper)과 동일한 폴더 경로를 생성합니다.

 

해당 경로에 mapper로 사용할. xml 파일들을 저장할 예정입니다.

3. 아파치 톰캣 연동

현재의 이클립스 환경에 아파치 톰캣(Apache Tomcat)을 연동합니다.

3-1. 이클립스 톰캣 연동 방법

상단 내비게이션 바에서 File 클릭 → New 클릭 → Other 클릭 후 Wizards란에 Server를 입력 → Server를 선택 → Next > 클릭

Select the server type 목록에 자신이 컴퓨터에 설치한 아파치 톰캣 버전을 선택해준 후 Next > 클릭합니다.

- 제일 상단에 Apache 폴더가 있습니다.

(저는 9.0 버전을 설치했기 때문에 Tomcat v9.0 Server를 선택했습니다.)

Browse를 클릭하여 자신이 톰캣을 설치한 경로를 선택해준 후 Finish 클릭합니다.

- 첫 서버 설정 시에만 해당 과정이 있습니다.

- 이후 서버 추가 시 해당 과정은 생략됩니다.

경로 설정 전

경로 설정 후

하단 Server 탭에서 정상적으로 서버가 추가되었는지 확인합니다.

3-2. 프로젝트와 톰캣 연동

Server 탭에서 구동하는 Server(저 같은 경우 Tomcat v9.5 Server...)을 선택 후 오른쪽 마우스를 클릭하고 이후 등장하는 목록 중 Add and Remove를 클릭합니다.

 

자신이 원하는 데로 프로젝트 추가 혹은 제거 후 Finish를 클릭합니다.

4. 프로젝트 '절대 경로' 구조 변경

경로 설정 없이 아파치 톰캣 서버를 구동하게 된다면 "http://localhost:8080/controller/" 경로의 홈페이지로 들어가게 됩니다.

해당 url 경로가 절대 경로인데 추후 작업들의 편의를 위해서 기존 절대 경로에서 "controller"를 제거합니다.

 

Servers 창에 있는 Tomcat v9.0 at localhost... 를 더블 클릭하여 창을 띄운 후, 하단의 Modules 탭을 클릭합니다.

현재 연결된 Module을 클릭하여 선택 후 Edit... 버튼을 클릭합니다.

Path 입력란에 "controller"를 지우고 OK 버튼을 클릭합니다.

지우기 전

지운 후

설정 이후 반드시 Ctrl + s를 눌러서 설정을 저장해줘야 합니다.

이후 다시 Overview 탭을 클릭하고 Port Number를 바꿔줍니다. (Port Number는 9000대에서 바꿔주시는 게 좋습니다.)

Port Number 변경 전

Port Number 변경 후

5. 서버 구동 테스트

프로젝트를 선택 후 마우스 오른쪽 클릭 → Run As →  Run on Server를 클릭합니다.

위의 창이 나오면 Finish를 클릭하여 서버를 실행합니다.

 

실행하면 아래의 브라우저 창이 뜹니다.

절대 경로 설정에서 "controller"를 뺏기 때문에 "http://localhost:9180" 경로로 접속된 것을 확인할 수 있습니다. 

6. 한글 환경 설정

앞의 서버 구동 테스트에서 한 가지 문제점이 있습니다.

원래는 '20xx 년 xx월 xx일...' 이런 식으로 한글이 출력되어야 하는데 인식을 하지 못하고 물음표(?)로 뜨고 있습니다.

 

이것을 고치기 위해 추가적인 설정을 진행하겠습니다.

필터 설정 (web.xml)

web.xml 파일에 아래의 코드를 추가 후 저장합니다.

경로: src/main/webapp/ WEB-INF/

<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>

설정 완료 후 서버를 다시 구동하시면 한글이 정상적으로 출력된 것을 확인할 수 있습니다. 

이로써 기본적인 설정이 완료되었습니다:)