[Spring Quick Start] Spring MVC 개발 환경 세팅하기

김희정·2023년 2월 10일

spring mvc spring 프로젝트 세팅 sts sts 3.9.9 sts 다운로드

Spring

목록 보기

1/18

💎 들어가며

What I have to do

누군가에겐 기초적일 수 있는 Spring Quick Start에 대한 기록을 작성하게 된 것은,

나조차도 처음부터 하나하나 짚어보고, "이 과정은 필요했던가? 그렇다면 과연 무엇을 위해 필요했던가?"에 대한 Question을 던지는 것과 동시에

처음 입사하면서 누군가 나에게 알려줬으면 좋았을 것들을 후임들에게 알려주기 위함입니다.

처음 입사하여 개발과정에 대해 상세하게 알고싶었지만, 그중에서도 특히 가장 원했던 부분은 처음 프로젝트를 구축하는 것, 즉 스프링 프로젝트 세팅 입니다.

이번 시리즈에서는 스프링 프로젝트로 애플리케이션을 구축하는 방법에 대해 써볼까합니다.

하지만 그렇다고 아무거나 생략하고 쓰고 싶은 것만 쓸수는 없기에 지루하지만, 개발환경 세팅부터 시작해볼까 합니다.

1. 개발 환경 세팅이란?

우선, 프로젝트를 개발을 시작하기에 앞서 개발자는 개발 환경을 세팅해야합니다. 개발 환경 세팅이란 거창한 말을 썼지만, 사실은 자기가 쓸 프로그램 목록(종속성 ⇒ JDK, IDE, 등)들과 작업 공간(workspace)을 세팅하는 것입니다.

1.1 개발 환경

제가 사용할 환경은 아래와 같습니다.

Java: JAVA SE8
IDE: STS (Spring Tool Suite)
WAS: Tomcat 9.0

Spring에서 현재 STS에 대한 다운로드를 내린 상태며, 현재는 Eclipse 혹은 다른 IDE의 플러그인 형태로만 지원하고 있습니다.

빠르게 세팅하기 위해 다운로드 링크를 준비해보았습니다. (아쉽게도 velog는 파일 업로드를 지원하지 않네요. 😣😣)

JDK 8 - 다운로드 링크
STS 3.9.9 - 다운로드 링크
Tomcat 9.0 - 다운로드 링크

STS란?

Spring Tool Suite라는 말을 직역하면 스프링 툴 모음이죠.

STS (Spring Tool Suite)는 쉽게 말해, 스프링 개발에 최적화된 이클립스입니다. 이클립스에 Spring Framwork Plugin이 자동으로 추가된 버전입니다.

1.2 실행 환경

Eclipse를 실행해보신 분들은 알겠지만, Eclipse 설치는 설치형(.msi)과 실행형(.exe)이 있습니다. 실행형 따로 프로그램을 설치하는 것이 아닌 폴더 내 프로그램을 실행하는 것입니다.

설치형에도 장점이 있지만, 작업 공간을 분리하기 어렵습니다. 다수의 프로젝트를 사용하는 만큼 프로젝트마다 작업공간을 분리하기 위해 실행형으로 세팅하여 STS를 분리합니다.

아래와 같이 폴더를 생성합니다
폴더 구조

STS: 다운받은 STS 프로그램을 STS 폴더로 복사합니다.
workspace: workspace 폴더는 앞으로 프로젝트 생성시 사용할 작업공간입니다.
tomcat: 다운받은 tomcat 프로그램을 tomcat 폴더로 복사합니다.

2. Java

2.1 Install

첨부한 Java 1.8 버전을 설치하고, 환경변수에 등록합니다.

1) 환경 변수 편집 메뉴에 들어갑니다.

Windows 앱 검색

2) JAVA_HOME 변수를 생성합니다. - JAVA를 설치한 경로를 넣어줍니다.

3) 시스템 환경변수 Path에 %JAVA_HOME%\bin을 추가해줍니다.

4) cmd를 열어 Java Version을 확인합니다.

3. STS

3.1 Install & launch

압축 파일의 sts-3.9.9.RELEASE 부분만 sts 폴더에 넣습니다.

STS를 실행해 아까 만들어둔 workspace 폴더를 지정합니다. 프로그램을 실행하면 아래와 같은 화면을 보실 수 있습니다.
(STS는 Eclipse의 확장프로그램과 같다고 보시면 되기 때문에 Eclipse와 거의 비슷한 화면을 보실 수 있습니다.)
Encoding 설정: [Window > Preferences] 창을 켜고 검색 창에 encoding을 검색합니다. 모든 항목의 encoding을 UTF-8로 설정합니다.
CSS,HTML, JSP Files도 모두 UTF-8로 설정합니다.

3.2 Window 검색창에서 검색하기

아까만들어둔 STS.exe실행 파일의 이름을 내가 원하는 이름으로 바꿉니다. ⇒ 저는 Blog_STS.exe로 변경하였습니다.
해당 파일을 우클릭하여 시작 화면에 고정을 클릭합니다. 이 때 주의할 점은 실행 파일이 C 드라이브에 없는 경우, C 드라이브에 바로가기 링크를 생성해줘야합니다.

Windows 검색창에서 Blog를 검색하면 아래와 같이 STS를 찾을 수 있습니다.

3.3 Eclipse Plugin 설치

STS의 기능을 확장하기 위해서는 Eclipse Plugin을 설치해야합니다. Plugin은 [Help > Eclipse Marketplace]에서 설치할 수 있습니다.

형상관리 플러그인 설치
저희는 형상관리 툴을 Git을 사용할 거기 때문에 git 플러그인을 추가로 설치해줍니다.
가장 많이 사용되는 Nodeclipse 를 설치합니다.

4. Spring Project 생성

4.1 Tomcat Server

STS 왼쪽 하단의 Servers에서 Create a new server... 버튼을 클릭하여 신규 WAS 생성
Tomcat 9.0 Server > Tomcat 폴더 경로 선택

4.2 Spring Legacy Project

[File > New > Spring Legacy Project] 를 통해 Spring Legacy Project를 생성합니다.

Project Name 설정 ⇒ Spring MVC Project 선택 ⇒ Package 명 설정

우선, Spring MVC Project 설명에 앞서, 프로젝트를 실행해보겠습니다.
[Run > Run on Server]를 클릭합니다.
아까 생성해둔 Tomcat Server를 선택합니다.
브라우저의 변경은 [Window > Web Browser]에서 선택하실 수 있습니다.
웹 브라우저(Web Browser)에서 해당 웹페이지로 접속합니다.