[Spring][01]MVC 프로젝트 생성 및 기본환경 설정(생성 및 구동 테스트)

개인 공부 후 자료를 남기기 위한 목적이기에 내용 상에 오류가 있을 수 있습니다.

---

목표

• Spring 에서 "MVC 프로젝트"를 생성할 수 있다.
• 새 프로젝트에서 pom.xml을 통해 '자바'와 '스프링' 버전을 변경할 수 있다.

해당 프로젝트에서 사용한 프로그램 환경

• JAVA SE 8u241
• Apache Tomcat 8.5
• STS 3.9.9

목차

1. MVC 프로젝트 생성

2. MVC 프로젝트 기본 구조

3. Spring 버전 변경

4. 프로젝트 실행 확인(Tomcat 활용)

5. Lombok설치[선택]

7.  프로젝트 JAVA(JDK, 컴파일러) 버전 변경

 

1. MVC 프로젝트 생성

1.1 상단 내비게이션 바에 [File] => [New] => [Spring Legacy Project]을 클릭합니다

그림 1-1

 

1.2 프로젝트 이름(Project name)을 입력 후 Templates에서 "Spring MVC Project"을 선택합니다. 둘 다 완료하였으면 [Next]을 클릭합니다.

그림 1-2

 

1.3 패키지명을 입력 후 [Finish]을 클릭합니다.

- com.'프로젝트명 혹은 원하는 이름'. controller을 입력합니다.

그림 1-3

 

1.4 정상적으로 프로젝트가 만들어졌는지 확인합니다.

- 아래와 같이 프로젝트에 빨간색 x표시가 떠있고, 오른쪽 하단에 아래 사진과 같은 표시다 떠잇다면 해당 프로젝트를 생성중이라는 의미입니다.

그림 1-4.1

- 완료가 되면 아래의 사진과 같이 x표시가 사라집니다.

그림 1-4.2

2. MVC 프로젝트 기본 구조

MVC 프로젝트 구조

 

ㄱ.  작성되는 코드의 경로

ㄴ. 실행할 때 참고하는 기본 경로(주로 설정 파일)

ㄷ. 테스트 코드를 넣는 경로

ㄹ. 테스트 관련 설정 파일 보관 경로

ㅁ. 뷰에서 참고로 할 js,css파일

ㅂ. 웹과 관련된 스프링 설정 파일

ㅅ. 스프링 설정 파일

ㅇ. 템플릿 프로젝트의 jsp 파일 경로

ㅈ. Tomcat의 web.xml 파일

ㅊ. Maven이 사용하는 pom.xml

 

3. Spring 버전 변경(pom.xml수정)

• 스프링 5.x 버전 이상을 이요하고 싶다면 JDK 1.8 이상 을 사용하는 것이 좋습니다.
• 자신이 원하는 버전으로 변경해주시면 됩니다.
• 전 스프링 5.0.7 / JDK1.8을 사용하였습니다.

3.1 스프링 버전(spring version) 변경

- <org.springframework-version> 3.x.x => 5.0.7 변경

그림 3-1

 

3.2 <build>태그 내부에 있는 <plugin> 태그에서 버전 변경

- <version> 2.5.1=> 3.5.1 변경

- <source> 1.6 =>1.8 변경

- <target> 1.6 =>1.8 변경

그림 3-2

 

3.3 변경 버전 적용(업데이트)

- pom.xml을 변경 후 저장을 하면 자동적으로 업데이트가 됩니다.

- 간혹 적용이 안 되는 경우가 있기 때문에 해당 과정을 진행합니다.

 

3.3.1 자신의 프로젝트를 선택 오른쪽 마우스 클릭 => [Maven] => [Update Project]을 클릭합니다.

그림 3-3

 

3.3.2 자신이 업데이트하고자 하는 프로젝트를 체크 후 [OK]를 클릭합니다.

그림 3-4

 

 

3.4 적용 확인

 

3.4.1 Java version 1.8 변경 확인

그림 3-5

 

3.4.2 Spring version 5.0.7 변경 확인

그림 3-6

 

4. 프로젝트 실행 확인

* 아파치 톰캣 연동이 안되었다면 아래의 링크를 참고해주세요.

• 아파치 톰캣 설치 참고
• 톰캣 이클립스(스프링) 연동 참고

4.1 Pacakge Explorer 태그에서 자신의 프로젝트를 선택 후 오른쪽 마우스 클릭 => [Run As] => [Run on Server]을 클릭

그림 4-1

 

4.2 [Next] 클릭

그림 4-2

 

4.3 자신의 프로젝트 Configured에 추가 후 [Finish] 클릭

그림 4-3

 

4.4 웹브라우저 Hello world! 

그림 4.4

 

 

5. Lombok 적용[선택]

• 필수는 아니고 필요시 적용합니다.
• Lombok 적용 참고

 

6. 프로젝트 JAVA(JDK, 컴파일러) 버전 변경

 자신의 프로젝트를 선택 -> 마우스 오른쪽 클릭 -> [properties]를 클릭합니다.

 

그림 13

 

 왼쪽 네비 목록 중 [Project Facets]를 클릭하여 해당 설정 창을 들어 간 후 [Java]의 버전을 자신이 설치한 버전으로 변경합니다.

 

그림 14

 

 왼쪽 네비 목록에서 [Java Compiler]를 선택하여 해당 설정 창을 들어갑니다. [use compilance from execution....] 체크를 해제한 후 자신이 원하는 컴파일러 버전을 선택합니다. 

 

그림 15

 

 모든 설정이 완료되었다면 [Apply and Close]를 클릭하여 설정을 저장 및 적용합니다.

 

그림 16

 

 프로젝트의 [pom.xml] 파일을 띄운 후 <java-version> 태그의 버전을 자신이 설치한 JAVA 버전으로 변경합니다.

 

그림 17

 

 [maven-compiler-plugin]의 <version> 태그의 버전을 최신 버전으로 변경합니다.  아래에 있는 <source>, <target> 태그의 버전을 자신이 설치한 JAVA 버전으로 변경합니다.

 

그림 18

 

 수정이 완료되었다면 [pom.xml] 파일의 수정사항을 저장합니다. [Package Explorer] 창의 [JRE System Library] 폴더를 통해 프로젝트의 JAVA 버전이 변경되었음을 확인합니다.

 

그림 19

 

6.1 오류가 뜨는 경우

 

 자바 관련 설정을 마치고 Maven 업데이트를 하였음에도 

 

"Description Resource Path Location TypeBuild path specifies execution environment JavaSE-11. There are no JREs installed in the workspace that are strictly compatible with this environment. Gugucoding Build path JRE System Library Problem"

 

혹은

 

"The compiler compliance specified is 11 but a JRE 15 is used"

 

 

 분명 자신이 설치한 JAVA버전에 맞는 버전으로 수정하였음에도 이러한 경고(Warnings)가 뜨는 이유는 자신의 컴퓨터에 설치한 JDK의 JRE와 이클립스(Eclipse)에 설정된 JRE와 다르기 때문에 이러한 현상이 일어납니다.

 

 이럴 경우 이클립스의 JRE를 실재 설치한 JRE와 일치시켜주어야 합니다. 재설정 방법은 아래의 포스팅을 참고해주세요.

 

[Eclipse] 이클립스 JRE 재설정 방법

 

 

 

 

Reference

• "코드로 배우는 스프링 웹 프로젝트"(남가람북스)

 

Date

• 2020.03.24 작성
• 2020.08.03 사진 및 오타 수정
• 2020.02.15  JAVA(JDK,JRE) 버전 변경 방법 추가