메이븐(Maven) 처음 사용해보기: 자바 프로젝트 생성, 기본 명령어

메이븐(Maven) 설치 후 첫 단계

이전 포스트(메이븐(Maven) 다운로드, 설치, 적용 까지 한번에 따라 하기) 에서 메이븐을 설치해 보았습니다. 설치를 해보았는데 이번엔 무엇을 해보면 좋을까? 란 생각이 들어 그 주제로 글을 작성하게 되었습니다.

메이븐은 이전 포스트에서 언급한 것과 같이 설치하게 되면 보편적으로 이클립스와 같은 IDE에 연결해서 사용했었지만 저도 처음으로 한번 cmd 를 사용해 메이븐을 다뤄 보며 기초를 다질 생각 입니다.

메이븐(Maven) 자바 프로젝트 생성

메이븐을 설치 했다면 cmd 를 열어 기본적인 명령어를 사용해 볼 수 있습니다. 메이븐 명령어는 mvn 을 입력 한 후 뒤에 내용을 입력하게 됩니다.

다음 명령어는 자바 프로젝트를 생성하는 메이븐 명령어 입니다. 명령어 입력 후 https://repo.maven.apache.org/maven2/ URL 을 시작으로 하는 곳에서 수많은 파일들을 다운로드 하고나서 최종적으로 BUILD SUCCESS 메시지가 출력 되며 프로젝트 생성이 완료 됩니다.

* 먼저 cd 명령어로 자신이 프로젝트를 생성하고 싶은 경로로 이동해 주세요.

명령어 실행이 완료 되면 Archetype in dir: 뒤에 생성된 프로젝트의 경로가 표시 됩니다.

mvn archetype:generate -DgroupId=com.example -DartifactId=my-app -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

명령어 상세설명

위의 자바 프로젝트 생성 명렁어를 상세하게 설명 해보겠습니다.

• mvn archetype:generate
  메이븐의 generate 명령을 호출합니다. archetype(아키타입) 은 메이븐 프로젝트의 템플릿으로 이 템플릿을 기반으로 한. 프로젝트 구조, 파일을 생성하라는 명령어 입니다. 정리하면 아키타입 구조를 지닌 프로젝트를 생성하라는 부분 입니다.
• -DgroupId=com.example
  자바의 패키지 구조를 설정하는 부분인데 실제 사용할 패키지 구조를 입력하면 됩니다. 테스트용 프로젝트 이므로 com.example 를 작성 하였습니다.
• -DartifactId=my-app
  DartifactId 은 생성될 프로젝트 이름을 정의하는 명령어고 이번 경우 my-app 이 프로젝트 이름이 됩니다.
• -DarchetypeArtifactId=maven-archetype-quickstart:
  이 부분은 사용할 아키타입의 ID 를 입력해 선택하는 것으로 메이븐의 가장 기본적인 자바 애플리케이션 구조인 maven-archetype-quickstart 을 선택 했습니다.
• -DinteractiveMode=false
  사용자의 상호작용을 비활성화 하는 명령어로 쉽게 말하자면 명령어 실행 도중 사용자가 여러 옵션(Y/N 여부 등)을 입력해야 되는 경우가 있는데 이런 부분을 비활성화 해 입력된 옵션을 활용하게 만듭니다.

메이븐(Maven) 기본 명령어

자바 프로젝트를 설치 했다면 기본적으로 사용해볼 법한 여러 명령어들이 있습니다. 다음은 간단하게 사용해볼 수 있는 명령어 목록 입니다.

* 먼저 명령어를 사용하기 전에 cd 명령어를 통해 방금 생성한 프로젝트로 이동 합니다. 저의 경우 my-app 디렉토리로 이동 했습니다.

• mvn compile – 프로젝트의 소스 코드를 컴파일합니다.
• mvn test – 프로젝트의 테스트를 실행합니다.
• mvn package – 컴파일된 코드를 JAR나 WAR 같은 배포 가능한 포맷으로 패키징합니다.
• mvn install – 패키징된 아티팩트를 로컬 저장소에 설치합니다. 다른 로컬 프로젝트가 의존할 수 있게 됩니다.
• mvn clean – 이전 빌드에서 생성된 target 디렉터리를 삭제합니다.
• mvn deploy – 패키징된 아티팩트를 원격 저장소에 배포합니다.
• mvn validate – 프로젝트가 올바른지, 모든 필요 정보가 있는지 확인합니다.
• mvn verify – 패키지가 올바르게 프로젝트의 통합 테스트를 통과하는지 검증합니다.

정상적인 프로젝트 라면 명령어 입력 시 다양한 결과가 출력 됩니다. 아래 결과는 mvn compile 결과로 이 명령어에 대해 상세하게 설명 하자면 pom.xml 에 작성된 내용에 맞춰 .m2 폴더에 의존성 들을 다운로드 하게 됩니다.

.m2 폴더

.m2 폴더는 pom.xml 에 정의 된 내용에 따라 필요한 의존성 파일들을 메이븐 중앙 저장소 등에서 다운로드하면 이 파일들이 위치한 로컬 저장소(내 PC 공간) 입니다.

기본적으론 사용자 계정명 밑에 .m2 폴더로 생성 되며 이는 메이븐의 설정을 변경하여 다른 경로를 지정 할 수 있습니다.