Chapter01. Spring Boot - 프로젝트 관리 도구

<< 학습 목표 >>

1. Maven을 사용해 필요한 라이브러리를 추가할 수 있다.

---

우리가 프로젝트를 생성할 때 선택 했던 [ Maven ] 과 프로젝트 내 생성 되어 있는 파일 중 pom.xml에 대해서 최소한으로만 이해해보자

 

Maven은 빌드툴로 좀 더 쉽게 얘기하면 이 글의 제목처럼 프로젝트 관리 도구임

 

비유를 해보자

음식점에서 음식을 만드는 것도 중요하지만 음식을 만들기 위해 준비하는 과정과 음식을 만들고 손님에게 나가기 전 먹음직스럽게 꾸미는 것도 중요함

프로젝트(서비스)를 개발할 때도 개발도 중요하지만 개발하기 전 필요한 라이브러리들을 추가하고 사람들이 사용할 수 있게 배포하는 것도 중요함

 

음식을 만들기 위해 준비하는 과정 = 개발하기 전 필요한 라이브러리들을 추가

음식이 손님에게 나가기 전 꾸미는 과정 = 사람들이 사용할 수 있게 배포하는 과정

사실 음식을 꾸미는 과정과 배포하는 과정은 적절한 비유는 아니지만 실무자가 이 글을 본다면 알아서 넘겨보실 것이고 취업준비생인분이 이 글을 본다면 "아닌데, 엄연히 다른데"까지 생각하지 못하실테니 그냥 적절히 넘겨 보자 ^^;;;

 

개발하기 전 필요한 라이브러리가 있다면 직접 다운 받아 프로젝트의 lib 폴더에 넣고 build path에 추가해야했을 것

이는 개발자 입장에서 굉장히 번거로운데 특히 Servlet, JSP로 프로젝트 다운 프로젝트를 만들어봤다면 크게 공감할 것

이 번거로운 과정을 많이 생략할 수 있게 해주는 것이 Maven 임

 

프로젝트에 Maven을 적용한다면 필요한 라이브러리의 URL을 찾아서 pom.xml 에 넣어주면 끝!

그 URL 조차 Maven Repository 라는 사이트에 모여있어 찾아 헤맬 필요가 전~혀 없음!

---

Maven Repository 사이트를 구경도 할겸 시험삼아 pom.xml 에 라이브러리 URL을 하나 넣어보자

Maven Repository 사이트는 인터넷에서 Maven Repository 로 검색(1) 하면 됨

검색 결과의 첫 번째 페이지(2) 로 들어가자

검색 결과가 아래와 다르다면 직접 들어가도 됨 / https://mvnrepository.com/

 

Maven Repository 사이트는 앞으로 자주 방문하게 될테니 즐겨찾기에 등록 해두는 것도 좋음

 

이 사이트에는 개발에 필요한 거의 모든 라이브러리 URL이 있음

 

필요한 라이브러리는 검색을 하면 되는데 이번에는 시험삼아 [ Hikari CP ] 라이브러리를 검색하고 이 라이브러리의 URL을 pom.xml 에 등록하자

라이브러리 URL은 필요하면 등록하고 필요 없으면 삭제하면 되므로 "괜히 라이브러리 URL 잘못 등록해서 프로젝트 이상해지는거 아니야?" 라고 걱정할 필요는 없음

 

Hikari CP 검색(1) / 검색을 하고 나면 검색 결과(2)가 굉장히 많음

여기서 내가 원하는 라이브러리를 찾아서 들어가면 됨(3)

 

 원하는 라이브러리를 찾아 들어갔다면 해당 라이브러리의 버전별로 쭉~ 나열(1)되있음

 

이 버전 중 나에게 맞는 버전을 선택 하면 됨

나에게 맞는 버전이 어떤 버전인지 모르겠다면 Usages 가 가장 높은걸 선택하면 됨

Usages 는 간단하게 해당 버전의 인기도 라고 생각하면 됨

 

우리는 근래에 Usages 가 가장 높은 2.13.x (2) 를 선택하자

상세 페이지로 들어오면 해당 라이브러리의 공식 홈페이지(1)를 확인할 수 있음

또 라이브러리의 URL이 아니라 라이브러리 파일이 필요할 경우 다운로드(2) 받을 수도 있음

마지막으로 라이브러리의 URL도 알 수 있음

 

(3) 안에 텍스트를 클릭하면 라이브러리의 URL이 자동으로 복사됨

이제 복사한 텍스트를 Spring Boot로 만든 Spring Framework 프로젝트 -> pom.xml (1) 에 추가하자

 

pom.xml 파일을 열면 그 안에 태그가 굉장히 많은데 라이브러리의 URL을 추가할 때는 <dependencies> 태그(1)를 찾아 그 안에 복사한 라이브러리의 URL을 넣어주면 됨

여기서 조심해야할 점은 라이브러리 URL을 넣을 태그 명이 dependencies 인것처럼 해당 태그 안에 이미 여러 라이브러리 URL이 적혀있음

 

다른 라이브러리 URL과 겹치지 않게 닫는 dependencies 태그 ( </dependencies> 태그 ) 바로 위에 잘 추가하자

 

URL이 우리가 알고 있는 URL과는 조금 다르지만 우리가 추가한 URL을 통해 Maven이 해당 라이브러리를 내려 받고 프로젝트에서 사용할 수 있게 적용을 시켜줌

이렇게 Maven 빌드툴을 사용하면 라이브러리가 필요할 때 Maven Repository 에서 라이브러리를 검색해 URL만 pom.xml에 넣어주면 끝이므로 개발자의 수고를 많이 덜 수 있음

---

pom.xml 뿐만 아니라 XML 파일을 이클립스에서 사용할 때 컴파일 오류(빨간 밑 줄)이 그어지는 경우가 있는데 진짜 문제가 생겨서 컴파일 오류가 생길 수 있고 정상적인 XML인데 이클립스가 XML을 잘못 해석해 컴파일 오류가 생긴것 처럼 보일 수 있음

XML 파일 내 다음과 같이 컴파일 오류가 생기면 일단은 무시를 하고 프로그램에서 진짜 문제가 생겼다면 그때 문제가 생기지 않게 XML 파일을 확인해 수정하면 됨

 

여기까지 Maven 빌드툴을 사용해 라이브러리를 추가하는 방법을 배웠음

hikari-cp 라이브러리는 시험삼아 추가했으니 이제 지우자~!