IT : 기초라는 뿌리

백기선님의 스프링 프레임워크 입문 개정판(초기 설정 부분) - 이클립스 본문

스프링(Spring Framework)

백기선님의 스프링 프레임워크 입문 개정판(초기 설정 부분) - 이클립스

Parkej 2021. 7. 30. 16:04
더보기

학습 내용 정리

 - 인프런 강의 중 백기선님의 무료 스프링프레임워크 입문(개정판)에 대한 강의 영상 중 초기 설정 부분입니다. 

 - 영상에서는 개발툴은 인텔리J로 하셨지만 저는 이클립스로 했고 혹여나 다른분들에게 도움이 될까하여 포스팅 하였습니다. 

 - 초기 작업 전 환경설정 및 구성요소

운영체제 : Windows 10

JAVA 버전 : JDK 11

개발 툴 : Eclipse (이클립스)

 

출처 : https://www.inflearn.com/course/spring

 

 

- 이 전에 저는 스프링 프레임워크를 마켓플레이스로 다운받았었고 토이프로젝트를 한 경험이 있습니다. 
- 피드백 언제나 환영이고 더 좋은 방법과 수정할 부분이 있다면 언제든 말씀주세요.

 

처음부터 이클립스를 해서 그런지 아직 익숙치 않지만 익숙한(?) 이클립스로 학습을 진행했습니다. 
느낀점은 항상 학습을 따라갈땐 문제가 없지만 초기 개발환경 세팅부분에서 많은 시간을 소요했지요. 그 부분을 조금이라도 줄이고자 저한테 일어났던 오류들을 해결하고 깃에서 다운받은 프로젝트가 정상작동 하는지 까지만 보겠습니다. 

- JDK 11 버전 설치 및 환경변수 설정
- 깃에서 이클립스로 프로젝트 가져오기
- ./mvnw package 와 jar 실행 명령어를 윈도우 cmd를 이용해 실행시키기 

 

 

JDK 11 버전 설치하고 환경변수 경로 잡아주기 

 저는 JDK 15버전을 사용했는데 사실상 학습을 진행하려면 최대한 같은 환경설정에서 하는게 오류도 덜 나고 좋습니다. 그래서 JDK 11을 다운받았습니다.

 - https://www.oracle.com/kr/java/technologies/javase-jdk11-downloads.html

해당 링크를 타고 스크롤을 아래로 내립니다. 

 - 위 그림과 같이 Windows x64 Installer 로 다운받습니다. 

 - 다운 후 위 그림과 같이 exe 파일을 실행시킵니다.
 - 그냥 Next 눌러서 경로로 따로 수정하지마시고 기본값으로 설치 진행해 주세요 

- 설치가 다 되면 아래와 같은 경로에 폴더가 생성됩니다. 

- C:\Program Files\Java 저의 JDK 설치 경로입니다. 
- 이제 환경 변수를 설정해 줍시다. (훗날 jar파일 실행을 위해서 .... )

- 타고타고 해서 '시스템 속성'이라는 데까지 들어가야합니다. (여기 들어가는 법은 구글링으로 .....양해바랍니다.)


 - 환경변수 등록

 1. 시스템변수에서 '새로 만들기' 클릭 (기존에 설정된 분들은 JDK 11 설치된 경로로 수정해주세요)
 2. 변수이름에는 JAVA_HOME
 3. 변수 값에는 JDK 11 을 설치한 경로 그리고 jdk 11 폴더까지 접근된 경로.. 입력 후 확인
 - C:\Program Files\Java\jdk-11.0.12 (제 컴퓨터의 경로입니다. )
 4. 시스템 변수목록에 잘 등록되어 있는지 확인하기 


 그리고 확인 누르고 컴퓨터를 재부팅 합시다. (꼭 해야함 미리하세요 번거롭더라도)


 

 

깃에 올라온 프로젝트를 이클립스에 슥삭하기

저는 이부분 좀 애먹었습니다. 인텔리J는 하나의 프로젝트를 관리하는데 유용하지만 이클립스는 여러개의 프로젝트를 관리해서 구조를 이해하는데 시간을 썼습니다. 

 

1. 먼저 빈 워크스페이스 폴더를 생성해줍니다. (아무곳이나 상관없으며 자신이 프로젝트들을 관리하기 용이한 곳으로)
Root : D:\springGitclone
 - 제 컴퓨터의 경로고 임의로 설정해준것입니다. 여러분들은 다를 수 있습니다. (꼭 같은것이 아님!!)
 - 또는 이클립스를 실행 후 초기 워크스페이스 open 창에서 만들어주셔도 됩니다. 
이미지 출처 : https://codingffler.tistory.com/9
(저는... 이클립스가 커스터마이징 된거라 기본 틀과는 좀 다릅니다 .... 그래서 이미지 따왔어요.)

2. 프로젝트 창이 켜지면 Import projects를 눌러줍니다. 
 방법1. 좌측에 보이는 Project Explorer에서 Import projects
 방법2. 좌측 상단에 보이는 File > Import 

3. Import 창 등장
 - Git > Projects from Git > Next 
 
 - Clone URI > Next

 * 여기 다음에 Git 에서 가져온 URI을 복붙해줘야 합니다. 저희는 백기선님의 강의 자료에 올라온 깃헙 주소에 들어가서 아래 그림과 같이(또는 백기선님의 강의자료에 나온 내용과 같이) Code를 클립하고 저기 URI를 복사해줍시다.

4. Git URI를 이클립스 임포트 창에 붙여넣기 
 - 3번을 Next 하고 난 다음의 창입니다. 
 - Location in URI : 아까 복사한 주소를 붙여넣습니다. 그러면 Host와 Repository path는 자동으로 채워집니다.
 - Authentication in User and Password : 인증 부분의 User와 Password 부분에는 자신의 깃허브 아이디와 패스워드를 입력해줍니다. 
 - 위의 과정 후 Next 

 - 해당 부분은 그냥 눈요기하시고 Next 합니다. 

**** 여기 중요

 - 잘 모르시는 분들이라면 헷갈리실 텐데요 Destination in Directory를 잘 지정해줘야 오류 안납니다. 
 - 기본 git 경로대신 저희가 임의로 설정한 이클립스 워크스페이스 폴더를 경로로 잡아줘야 합니다.
 - Browse 클릭후 아래 그림과 같이

 - 저희가 지정해 주었던 워크스페이스 폴더를 경로로 잡습니다. 
 - D:\springGitclone\spring-petclinic 저는 경로가 이렇게 되어 있네요 그 다음 Next 를 누르면 아래 그림이 뜰텐데


 - 클론 URI로 복사가 완료되었다는 의미이고 Next를 눌러줍니다. 
 - 아래와 같은 그림이 나옵니다. 


 - 여기서 프로젝트를 찾을 수 없다고 나오는데 그냥 Cancel 버튼으로 가볍게 무시해줍니다. 우리가 직접 찾아주면 되거든요. 

5. 프로젝트 폴더를 임포트 해당 워크스페이스에 인식 또는 임포트하기
 - 2번 과정을 다시 합니다.  아래 그림

 - 이번엔 General > Projects from Folder or Archive 클릭 > Next 
 - Directory 클릭 (아래 그림과 같이)


- 아래 그림과 같이 경로에 직접 접근합니다. 

 - 저희가 만들었던(생성했던) 워크스페이스 경로에 들어가게 되면 보시는 바와 같이 깃에서 가져온 프로젝트가 보일겁니다. 저 폴더를 들어가지말고 선택만 한다음 아래 '폴더선택' 버튼을 클릭합니다.

- 아래 그림과 같은

 - 저의 이클립스 워크스페이스 경로입니다 해당 디렉토리를 찾아서 잡으면 Finish를 눌러줍시다. 

6. 디렉터리 표시와 메이븐 자동 업데이트 그리고 디렉터리 구조 확인하기 

1. 인식된 프로젝트 디렉터리가 표시되는 부분입니다. 
2. Finish 클릭 직후 메이븐 업데이트 진행률이 보이는 곳입니다. (저는 다 완료가 되어서 안뜹니다... 중간에 캡쳐할라했는데 늦었음.)

 - 이제 구조를 확인해봐야죠? 



 - 오옹 메이븐이 잘 인식되어서 자동으로 업데이트가 되어 스프링 및 스프링부트 프로젝트로 인식되었습니다. 
 - 여기서 중요한 점은 백기선님은 JDK 11 버전을 사용하셔서 저희가 또 작업을 해주어야 합니다. 
(저는 기존에 다운 받았던 스프링 프레임워크가 인식되어서 이클립스에서 자동으로 인식해준게 아닐까도 합니다. 하지만 백기선님의 ./mvnw package 방법도 할것이니 계속 봐주세요. 여기까지 안된다면 이클립스 내의 마켓 플레이스에서 스프링을 직접 다운받는것을 추천드립니다. 구글링해보시면 방법 나와요.)

- 아래 그림과 같이 빨간 박스 부분을 클릭하고 오른쪽 마우스를 눌러 줍시다. 

 - JRE System Library 클릭 > 오른쪽 마우스 클릭 > Properties 클릭 후 아래 그림 봐요


 - 저희는 11 버전 쓸거니까 11로 바꿔줍니다. (빨강 부분의 드롭다운박스 클릭)
 - 아래그림


- Apply and Close 클릭


- 하시면 해당 프로젝트의 자바 버전이 11로 바뀌게 된 것을 확인 할 수 있습니다. 


여기까지가 깃에서 이클립스로 프로젝트 가져오기 였습니다. 
이제 Windows의 cmd 를 활용해서 mvnw package 를 할건데요 잘 봐주세요 
 - 현재까지 잘완료되었다면 패키지 부분을 안해도 이상없지만 하지 않는다면 프록시 부분에서 인식이되어야 할 것들이 안됩니다. 그래서 해당 작업을 꼭 해주어야 정상적으로 학습을 진행할 수 있습니다. 


 

 

mvcw package 와 jar 파일 실행시키는 부분

백기선님의 강의 영상에는 인텔리J안에 있는 터미널을 사용해서 했는데요 저는 이클립스에도 터미널이 존재한다는것을 모른채 cmd로 진행했습니다.......... (눈물)

 

그래서 cmd를 실행시켜줍니다.
 - 시작 창 또는 윈도우 검색 창 클릭 후 cmd 입력 (명령 프롬프트 실행)

- 저희는 여기에서 Git에서 가져온 프로젝트 폴더까지 접근을 해야 합니다. 왜냐면 ./mvnw package 명령어 대신 mvnw.cmd 파일을 실행시킬 것이기 때문이죠 

- 아래 그림과 같이 해당 디렉터리까지 잘 접근해 줍니다.

 - 저는 D드라이브에 따로 프로젝트를 관리해서 ' d: or D: '라는 명령어로 D드라이브에 접근했습니다.
 - D드라이브로 루트가 변경되었으면 cd 라는 폴더 이동 명령어를 통해 이클립스 워크스페이스 폴더로 접근해줍니다.  cd springGitclone  (cd '자신의 워크스페이스 폴더 이름')
- 그 다음 해당 워크스페이스 안의 프로젝트 폴더로 접근합니다. cd spring-petclinic (cd '깃에서 가져온 플젝폴더이름')
- 마지막 줄과 같이 이동이 잘 된것을 확인 후 mvnw.cmd 를 입력해 엔터해줍시다. (spring-petclinic 이라는 폴더 안에 있는 파일을 실행시킨겁니다.) 아래 그림을 봅시다.


- 이렇게 빌드 에러가 떴는데요 저는 영어를 잘 모르기에 (공부중임) 저 부분을 구글링 해서 해결법을 찾았습니다. 그리고 여러분들의 시간을 줄이기 위해 바로 답을 내놓겠습니다. 

- 이클립스로 돌아가서 프로젝트의 pom.xml을 더블클릭하고 스크롤을 내려보시면 <build>로 시작되는 부분이 있을 것입니다. 아래 그림과 같이 저 코드를 입력하고 저장해줍시다 (ctrl + s)
- 아래 코드 입력하기 꼭 <build> 태그 안에 있어야 합니다. (좀 아시는 분들이라면 어떤 말인지 알것..)
<defaultGoal>install</defaultGoal>       

- 코드 입력 후 저장을 누르면 이클립스 우측 하단 쪽에서 running이 이루어집니다. 다끝나게 되면 cmd(명령 프롬프트)창으로 돌아가 작업을 반복해줍시다.

1.
1
2.
야호!!

 - 오 잘돌아가는군요 


 - 이렇게 짜잔 하고 '빌드 성공' 이라는 영어가 뜨면 다 된겁니다. 
 - 이제 ./mvnw package 부분은 완료했고 이제 jar 실행 부분을 진행하겠습니다. 

??

 - 똑같이 쳤는데 안되네요 그냥 직접 접근해서 합시다. (아닐 수도 있음 아직 저의 지식이 부족) 
 - cd target 이라는 명령어를 쳐서 폴더에 접근해줍시다. 


- 저희는 target 폴더 안에 있는 jar 파일을 실행시키려고 하는데요 

 - cmd 로 접근한다음 실행시킬 jar 파일의 이름을 써줍시다. 
 - java -jar spring-petclinic-2.4.5.jar 입력 후 엔터

스슥

 

슉삭 응..?

- 원래 잘 실행되는건데 저는 기본 8080 포트를 사용하고 있어서 충돌이 일어났습니다. (오라클 땜시!)
- 기존 포트를 죽이거나 변경하는 방법이 있습니다. 저는 변경해서 하겠습니다. 
(포트 충돌없이 잘 되면 성공한겁니다. ! 그럼 '포트변경' 부분만 넘어가주세요. )

///////////////////// 포트 변경해서 jar 실행하기 
 - cmd 명령어를 수정해줍시다. 
 - java -jar spring-petclinic-2.4.5.jar --server.port='임의포트입력'

1


///////////////////////////////////////////////////////////////////////////////////////////////////////////////

 - 여기까지 아무 이상이 없으면 실행이 완료된겁니다. 이제 저 포트번호로 접속해봅시다.



 - localhost:'자신이 입력한 포트번호'  (저는 localhost:8111 )
 
 - 해서 이렇게 개와 고양이 페이지가 뜨면 완료입니다. 이제 백기선님의 강의를 보시면서 학습 진행해주시면 될거같아요 고생하셨습니다.