[Spring Web Project] 개발 환경 설정(1)

Eclispe 혹은 STS3 설치

 

스프링 프레임워크의 개발에는 다음과 같은 방법들을 사용할 수 있습니다.

 

• Eclipse + STS3 플러그인
• STS(Spring Tool Suite)3 통합 개발 도구
• IntelliJ 등

최근 Eclipse의 경우 버전에 따라서 플러그인 설치 시 여러 종류의 문제가 발생하기 때문에 가장 안전한 방법은 STS3를다운로드 받아서 설치하는 방법입니다. STS 4버전부터는 스프링 프레임워크 대신에 스프링 부트만을 지원하기 때문에 반드시 3버전을 찾아서 설치해야 합니다.

 

Spring Tool Suite 3

 

https://github.com/spring-attic/toolsuite-distribution/wiki/Spring-Tool-Suite-3에서 이전 버전의 STS3를 검색합니다.

 

 

3.9.14버전(2023년 10월 기준으로 3.9.18이 최신 버전)을 다운로드 해서 압축을 해제하고 STS.exe 파일을 실행합니다. 압축을 해제할 때 주의할 점은 다음과 같습니다.

 

• 중간에 한글 경로가 있는 폴더에 압축을 해제하지 않도록 합니다.
• 설치 경로가 너무 길거나 복잡한 경우 정상적으로 압축이 풀리지 못하는 문제가 발생할 수 있습니다.

압축이 해제되면 'sts-bundle'이라는 폴더가 생성되고 아래와 같은 구조가 생성됩니다.

 

 

이 중에서 'sts...' 폴더의 내부를 살펴보면 'STS.exe' 파일이 있어 이를 통해서 실행합니다.

 

Eclispse와 같이 STS 역시 최초 실행 시에는 워크스페이스를 지정해 주어야 합니다.

 

Tomcat 9(8) 서버 다운로드 및 설정

 

STS(혹은 Eclipse)로 생성하는 프로젝트의 구동은 Tomcat을 이용해서 진행합니다.

https://tomcat.apache.org/를 통해서 Tomcat 9.0버전을 이용합니다.(JDK 1.8 이상을 사용하기 위해서 입니다. 만일 Spring을 4.x로 진행한다면 Tomcat 8.x 버전을 이용해도 무방합니다.)

 

Apache Tomcat® - Welcome!

 

Tomcat을 사용할 때에는 항상 자신의 환경에 맞는 버전을 이용해야 합니다.

(Tomcat 버전은 http://tomcat.apache.org/whichversion.html 문서를 통해서 확인할 수 있습니다)

 

 

Tomcat 사이트의 다운로드 링크를 이용해서 적절한 버전(저는 9.0.81 버전을 다운받았습니다)을 다운로드 합니다.

 

Tomcat 9.0.81

zip이나 tar.gz 등의 압축형태를 다운로드해서 원하는 경로에 압축을 해제합니다.

Eclipse에서는 'Windows > Preferences' 메뉴의 'Server' 항목을 통해서 추가합니다.

'Add' 버튼을통해서 'Apache Tomcat 9'를 선택하고, Tomcat이 설치된 경로를 지정해줍니다.

 

스프링 프로젝트 생성

이클립스(STS)에서 스프링 프로젝트를 생성하는 방식은 1) 처음부터 스프링 프로젝트를 지정하고 생성하는 방식, 2) Maven이나 Gradle 프로젝트를 생성한 후 프레임워크를 추가하는 방식, 3) 직접 프레임워크 라이브러리를 추가하는 방식이 있습니다.

> 'ex00' 프로젝트 생성

화면 오른쪽 상단의 'Perspective'를 'Spring'으로 지정한 후 'File' 메뉴를 통해서 프로젝트를 생성합니다.

 

'Spring Legacy Project' 메뉴를 이용하면 아래 화면과 같이 여러 종류의 스프링 기반 프로젝트를 Maven 기반으로 생성할 수 있습니다.

 

 

프로젝트는 'Spring MVC Project'를 이용해서 생성합니다. 패키지명은 'org.noel.controller(원하시는 패키지명 설정)'로 지정합니다. ( ※ 패키지명은 중간에 절대 대문자 사용 금지 ※ )

 

> 스프링 버전 변경

앞으로의 예제들은 스프링 5번을 이용할 것이므로 이에 대한 수정이 필요합니다. 생성된 프로젝트의 라이브러리는 pom.xml 파일을 통해서 관리되므로 이를 수정합니다. pom.xml에서 springframework-version을 3.1.1에서 5.2.7 버전으로 수정합니다.

 <name>ex00</name>
 <packaging>war</packaging>
 <version>1.0.0-BUILD-SNAPSHOT</version>
 <properties>
     <java-version>1.6</java-version>
     <org.springframework-version>5.2.7.RELEASE</org.springframework-version>
     <org.aspectj-version>1.6.10</org.aspectj-version>
     <org.slf4j-version>1.6.6</org.slf4j-version>
 </properties>
 <dependencies>

스프링 프레임워크의 버전을 수정하고 나면 관련 라이브러리들을 새롭게 추가하는데 시간이 조금 걸립니다. 완료된 후에는 프로젝트 우클릭 > Maven > Update Project 눌러서 'Maven Dependencies' 항목을 통해서 스프링 프레임워크 라이브러리들이 제대로 변경되었는지를 확인합니다.

 

> Java version 변경

생성된 프로젝트의 JRE System Library를 보면 'JavaSE-1.6' 버전으로 생성된 것을 볼 수 있습니다. 스프링 5버전의 경우 최소 1.8 이상을 사용해야 하기 때문에 이를 변경해 주어야 합니다.

pom.xml 의 태그 중 maven-compiler-plugin의 내용을 1.6에서 1.8로 변경합니다.

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

 

이 후 프로젝트를 선택한 상태에서 'Maven > Update Project' 를 실행하여 프로젝트의 컴파일이나 실행환경이 JDK 11으로 설정된 것을 확인할 수 있습니다.

 

 

 

 

Tomcat을 이용한 프로젝트 실행 확인 

 

프로젝트가 정상적으로 동작하는지 프로젝트를 실행해서 확인하는 과정은 프로젝트의 'Run As > Run on Server'를 눌러 처리합니다.

 

 

 

프로젝트가 정상적으로 실행되면 STS 내에서 실행되는 모습을 확인할 수 있습니다. 프로젝트가 실행되면서 문제가 없다면 Eclipse 내 브라우저에서 'http://localhost:8080/controller/'라는 URL이 실행됩니다.