Spring Legacy 개발환경 구축 및 설정

Spring Framework를 개발할 수 있는 소프트웨어를 다운로드하는 방법을 기술한 페이지

개발환경 구성 요소

  1. OPEN JDK 11

  2. Spring STS 3.9.x

  3. Maven 3.x.x

  4. Apache Tomcat 9.x.x

  5. Lombok

OPEN JDK11과 Apache Tomcat9.x.x는 이미 설치완료한 상태라면 스킵하고 넘어가도록 하자


1) OPEN JDK11

Amazon Correto Open JDK 11버전을 다운로드

설치경로 : https://docs.aws.amazon.com/corretto/latest/corretto-11-ug/downloads-list.html


2) Spring STS(Spring Tool Suite)

STS는 Spring Framework를 사용하기 위한 개발 툴을 의미한다. 이클립스 IDE에 Spring 관련 기능을 추가한 프로그램이며 STS는 3버전과 4버전으로 구분됨.

  • STS3 - Spring Legacy, Spring Boot지원

  • STS4 - Spring Boot지원

수업에서 진행한 Spring Legacy Proeject는 STS4에서 지원하지 않으므로 STS3의 최신버전을 다운로드 받는다.

STS 설치경로 : https://github.com/spring-attic/toolsuite-distribution/wiki/Spring-Tool-Suite-3


STS 설치 & 실행

1) Windowos를 사용중이라면 1번 zip파일을 다운로드 받는다

2) 다운로드 완료한 zip파일은 압축해제한다

주의사항

  1. zip파일 압축제시 윈도우 내장 압축해제 프로그램을 사용할 경우 기본경로 글자수를 초과하여 에러가 발생할 수 있다. 에러가 발생하지 않게끔 7z같은 압축해제 프로그램을 사용하는것을 추천

  2. 설치경로에 한글이 포함되어 있는 경우 프레임워크 사용시에 문제가 발생할 수 있다. sts를 설치할 폴더의 경로에는 한글이 포함되지 않도록 주의.

3) 압축 해제후 폴더 내부의 sts-bundle을 개발도구들을 관리하는 폴더로 이동시킨다.

압축해제후 다운로드폴더
C드라이브 tools폴더

4) sts-3.9.18폴더로 이동후 STS.exe 실행

5) C드라이브에 SpringWorkspace생성후 sts로 launch


3) Maven

  • Maven은 프로젝트의 버전관리, 의존성 라이브러리 관리, 배포관리등을 문서형태로 관리할 수 있도록 도와주는 유용한 프로젝트 관리 도구이다.

  • Maven은 각종 설정 정보들을 하나의 pom.xml파일로 관리한다.

  • 이제까지 프로젝트 내 lib 폴더에 사용할 라이브러리를 직접 추가하여 관리 해왔다면, Maven은 pom.xml 문서 하나만으로 필요한 라이브러리를 자동으로 설치하고 관리할 수 있다

Maven 설치

1) 아래 사이트에서 메이븐 3.9.7버전 다운로드 후 압축해제하여 dev폴더로 이동

메이븐 설치경로 : https://maven.apache.org/

다운로드 완료한 파일은 압축해제 후 dev폴더로 이동

참고) MVC프로젝트 생성시 내장 Maven이 이미 존재한다.

단, 직접 추가하는 이유는 내장Maven이 pom.xml의 정보를 통해 의존성 파일들을 다운로드하는 보관소의 경로가 모든 MVC프로젝트에서 항상 동일하기 때문에, 메이븐을 직접 설치하여 프로젝트 별로 서로 다른 경로에서 의존성을 관리하게끔 하는게 좋다.

2) C:\dev\apache-maven-3.9.7 내부로 이동한후 repository폴더생성

위 repository폴더는 앞으로 pom.xml을 통해 다운로드 받은 의존성 파일들을 저장할 저장소이다.

3) conf폴더의 settings에 접근하여 설정정보 수정

위 이미지에서 주석으로 감싸져있는 localRepository태그를 주석 밖으로 이동시킨후, 내부 경로값을 바꿔준다.

기존 :

<localRepository>/path/to/local/repo</localRepository>

변경 :

<localRepository>C:\dev\apache-maven-3.9.7\repository</localRepository>

4) Apache Tomcat 9.x.x

아파치 톰캣 다운로드 경로 : https://tomcat.apache.org/download-90.cgi

압축 해제후 dev폴더로 이동.

5) Lombok

  • Lombok의 정식 명칭은 Project Lombok으로 클래스 자동화 라이브러리이다

  • VO클래스에서 반복적으로 등장하는 코드들(constructor , getter , setter, toString....)을 @Annotaion으로 관리할 수 있어 코드작성의 편의성과 가독성, 유지보수성을 올려준다.

Lombk 설치

1) https://mvnrepository.com/ 로 이동

2) project lombok검색 후 첫번째 Project Lombok클릭

3) 아무 최신버전 클릭

4) jar파일 버튼 클릭 후 다운로드 완료된 lombok.jar파일 dev폴더로 이동

*** 실행중인 IDE가 있다면 종료후 진행해야 안전하게 lombok이 적용된다 ***

5) dev폴더로 이동하여 lombok.jar파일 실행한다.

더블클릭으로 lombok이 실행되지 않고 zip파일 형태로 열릴때는 현재 url에서 CMD창으로 다음 명령어를 입력한다

java -jar lombok-1.18.32.jar

6) Specify location 선택후 IDE가 설치된 위치를 찾은 후 Select

7) install/ update 누른 후 적용 완료되었다면 STS3를 재시작한다.

lombok.jar를 라이브러리로 프로젝트에 추가만 했을 때는 lombok의 annotation들을 사용할 수 있는 것처럼 보이나 , 실제 에디터에서는 인식하지 못하기 때문에 기능이 제대로 작동하지 않는다.

STS나 eclipse에 lombok을 적용하기 위해서는 lombok파일을 실행시켜서 lombok기능을 적용하고자하는 IDE를 직접 선택해줘야한다

Last updated