Maven 그놈이 알고싶다

나처럼 기본기가 부족한 사람들은 기본기를 다지는 시간을 방치하고

 

무작정 프로젝트를 시작하거나 현업에서 일을 시작하면

 

지금 당장은 아닐지라도 하루하루 시간이 지날수록

 

실력자가 되는 길은 더 멀어질 것 같다는 생각이든다.

 

지금의 실력에서 하나하나 모든 부분을 다 알고 넘어갈 수는 없지만

 

그래도 일단 한번이라도 시간을 더 내서 기본기를 다지는 시간이 필요하다.

 

그래서 이번에는 메이븐이 무엇인지 어느정도는 이해하고 갈 필요가 있다고 생각이든다.

 

 

 

메이븐 학습을 위해 간단하게 빌드란 무엇인지 알고 넘어가자 !

 

빌드란?

 

소스코드 파일을 컴퓨터에서 실행 할 수 있도록 독립된 소프트웨어 가공물로 변환하는 과정 또는 그에 대한 결과물이다.

 

조금 더 이해하기 쉽게 설명해보자.

 

우리가 작성한 소소코드(java), 프로젝트에서 쓰인 각각의 파일 및 자원 등(.xml, .jpg, .jar, .properties)을 톰캣같은

WAS가 인식할 수 있는 구조로 패키징 하는 과정 및 결과물이라고 할 수 있다.

 

 

빌드 도구(Build tool)?

빌드 도구란 프로젝트 생성, 테스트 빌드, 배포 등의 작업을 위한 전용 프로그램이다.

빠른 기간동안 계속해서 늘어나는 라이브러리 추가, 프로젝트를 진행하며 라이브러리의 버전 동기화의 어려움을 해소하고자 등장했다.

초기의 java빌드도구로 Ant를 많이 사용하였으나 최근 많은 빌드도구들이 생겨나서 Maven이 많이 쓰였고, 현재는 Gradle이 많이 쓰인다.

 

(Ant는 스크립트 작성이 많으며 라이브러리 의존관리가 되지 않아 불편하다.)

 

메이븐이란? (메이븐의 정의 그리고 예제)

 

메이븐의 정의 및 특징

 

Maven은 자바용 프로젝트 관리도구로 Apache Ant의 대안으로 만들어졌다.

 

Maven은 Ant와 마찬가지로 프로젝트의 전체적인 라이프 사이클을 관리하는 도구이며, 많은 편리함과 이점이 있어 널리 사용되고 있다.

 

Maven은 필요한 라이브러리를 특정 문서(pom.xml)에 정의해 놓으면 내가 사용할 라이브러리 뿐만 아니라 해당 라이브러리가 작동하는데

에 필요한 다른 라이브러리들까지 관리하여 네트워크를 통해서 자동으로 다운받아준다.

 

Maven은 중앙 저장소를 통한 자동 의존성 관리를 중앙 저장소(아파치재단에서 운영 관리)는 라이브러리를 공유하는 파일 서버라고 볼 수

있고, 메이븐은 자기 회사만의 중앙 저장소를 구축할수도 있다.

 

즉, 간단한 설정을 통한 배포 관리가 가능하다.

 

Ant vs Maven

 

1. Ant는 비교적 자유도가 높은 편

(Ant : 전처리/ 컴파일/ 패키징/ 테스팅/ 배포 가능)

 

2. Maven은 정해진 라이프사이클에 의해 작업을 수행하며, 전반적인 프로젝트 관리 기능까지 포함한다.

(Build Tool + Project Management)

 

 

Maven LifeCycle

1) LifeCycle

 

- 미리 정해진 빌드의 순서

 

메이븐은 프레임워크이기 때문에 동작 방식이 정해져있고, 미리 정의하고 있는 빌드 순서가 있다.

이를 라이프사이클(LifeCycle)이라고 한다.

 

Default(Build) : 일반적인 빌드 프로세스를 위한 모델
Clean : 빌드 시 생성되었던 파일들을 삭제하는 단계
Validate : 프로젝트가 올바른지 확인하고 필요한 모든 정보를 사용할 수 있는지 확인하는 단계
Compile : 프로젝트의 소스코드를 컴파일 하는 단계
Test : 유닛(단위) 테스트를 수행 하는 단계(테스트 실패시 빌드 실패로 처리, 스킵 가능)
Pacakge : 실제 컴파일된 소스 코드와 리소스들을 jar, war 등등의 파일 등의 배포를 위한 패키지로 만드는 단계
Verify : 통합 테스트 결과에 대한 검사를 실행하여 품질 기준을 충족하는지 확인하는 단계
Install : 패키지를 로컬 저장소에 설치하는 단계
Site : 프로젝트 문서와 사이트 작성, 생성하는 단계
Deploy : 만들어진 package를 원격 저장소에 release하는 단계

최종적으로 빌드 순서는 compile => test => package이다.

 

1. compile : src/main/java 디렉토리 아래의 모든 소스 코드가 컴파일 된다.

2. test : src/test/java, src/test/resources 테스트 자원 복사 및 테스트 소스 코드 컴파일 

## Junit : 단위 테스트 프레임워크, 테스트 단계를 거치기 위해 의존 설정을 해준다.

3. packaging : 컴파일과 테스트가 완료된 후, jar, war 같은 형태로 압축하는 작업

 

 

2) Phase(단계)

Build Lifecycle의 각각의 단계를 Phase라고 한다.

Phase는 의존관계를 가지고 있어 해당 Phase가 수행되려면 이전 단계의 Phase가 모두 수행되어야 한다.

즉, 모든 빌드단계는 이전 단계가 성공적으로 실행되었을 때 실행된다는 것이 Dependency이다.

 

3) Goal

 

- 특정 작업, 최소한의 실행 단위(task)

- 하나의 플러그인에서는 여러 작업을 수행할 수 있도록 지원하며, 플러그인에서 실행 할 수 있는 각각의 기능(명령)을 Goal이라고 한다.

(각각의 Phase에 연계된 Goal을 실행하는 과정을 Build라고 한다.)

- 플러그인의 goal을 실행하는 방법은 다음과 같다.

- mvn groupid:artifactid:version:goal(아래와 같이 생략 가능)

- mvn plugin:goal

 

Maven 설정파일

1) settings.xml

 

메이븐 빌드 툴과 관련한 설정파일

MAVEN_HOME/conf 디렉토리에 위치 (메이븐 설치 시 기본 제공)

settings.xml의 설정

** 메이븐을 빌드할 때 의존 관계에 있는 라이브러리, 플러그인을 중앙 저장소에서 개발자 PC로 다운로드 하는 위치(로컬저장소)의 기본설정 'USER_HOME/.m2/repository'인데 settings.xml에서 원하는 로컬 저장소의 경로를 지정하거나 변경할 수 있다.

 

2) POM(프로젝트 객체 모델(Project Object Model))

 

POM은 pom.xml파일을 말하며 pom.xml은 메이븐을 이용하는 프로젝트의 root에 존재하는 xml파일이다.

(하나의 자바 프로젝트에 빌드 툴을 maven으로 설정하면, 프로젝트 최상위 디렉토리에 "pom.xml"이라는 파일이 생성된다.)

 

- Maven의 기능을 이용하기 위해서 POM이 사용된다.

- 파일은 프로젝트마다 1개이며, pom.xml만 보면 프로젝트의 모든 설정, 의존성 등을 알 수 있다.

- 다른 파일이름으로 지정할 수도 있다. (mvn -f파일명.xml test) 하지만 pom.xml으로 사용하기를 권장한다.

 

개발을 혼자서 하는 것이 아니라 협업으로 진행하기 때문에 굳이 다른 파일이름을 사용하지 않고

기본적으로 맞춰져있는 pom.xml로 사용하는것이 좋겠다는 개인적인 생각이 있다.

 

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion> <!--POM model의 버전-->
    <parent> <!--프로젝트의 계층 정보-->
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.2.4.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.god</groupId> <!--프로젝트를 생성하는 조직의 고유 아이디를 결정한다. 일반적으로 도메인 이름을 거꾸로 적는다.-->
    <artifactId>coding</artifactId> <!--프로젝트 빌드시 파일 대표이름 이다. groupId 내에서 유일해야 한다.Maven을 이용하여 빌드시 다음과 같은 규칙으로 파일이 생성 된다.
      artifactid-version.packaging. 위 예의 경우 빌드할 경우 bo-0.0.1-SNAPSHOT.war 파일이 생성된다.-->
    <version>0.0.1-SNAPSHOT</version> <!--프로젝트의 현재 버전, 프로젝트 개발 중일 때는 SNAPSHOT을 접미사로 사용-->
    <packaging>war</packaging> <!--패키징 유형(jar, war, ear 등)-->
    <name>bo</name> <!--프로젝트, 프로젝트 이름-->
    <description>Demo project for Spring Boot</description> <!--프로젝트에 대한 간략한 설명-->
    <url>http://soundofcoding.tistory.com</url> <!--프로젝트에 대한 참고 Reference 사이트-->

    <properties>
        <!-- 버전관리시 용이 하다. ex) 하당 자바 버전을 선언 하고 dependencies에서 다음과 같이 활용 가능 하다.
        <version>${java.version}</version> -->
        <java.version>1.8</java.version>
    </properties>

    <dependencies> <!--dependencies태그 안에는 프로젝트와 의존 관계에 있는 라이브러리들을 관리 한다.-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-tomcat</artifactId>
            <scope>provided</scope>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
            <exclusions>
                <exclusion>
                    <groupId>org.junit.vintage</groupId>
                    <artifactId>junit-vintage-engine</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
    </dependencies>

    <build> <!--빌드에 사용할 플러그인 목록-->
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

 

< 엘리먼트 >
modelVersion : POM model의 버전
parent : 프로젝트의 계층 정보
groupId : 프로젝트를 생성하는 조직의 고유 아이디를 결정한다. 일반적으로 도메인 이름을 거꾸로 적는다.
artifactId : 프로젝트 빌드시 파일 대표이름이다. groupId 내에서 유일해야 한다.

Maven을 이용하여 빌드시 다음과 같은 규칙으로 파일이 생성 된다.

artifactid-version.packaging. 위 예의 경우 빌드할 경우 coding-0.0.1-SNAPSHOT.war 파일이 생성된다.
version : 프로젝트의 현재 버전, 프로젝트 개발 중일 때는 SNAPSHOT을 접미사로 사용.
packaging : 패키징 유형(jar, war, ear 등)
name : 프로젝트, 프로젝트 이름
description : 프로젝트에 대한 간략한 설명
url : 프로젝트에 대한 참고 Reference 사이트
properties : 버전관리시 용이 하다. ex) 해당 자바 버전을 선언 하고 dependencies에서 다음과 같이 활용 가능 하다.
<version>${java.version}</version>
dependencies : dependencies 태그 안에는 프로젝트와 의존 관계에 있는 라이브러리들을 관리 한다.
build : 빌드에 사용할 플러그인 목록

 

Maven이 아닌 Gradle로 구성된 프로젝트가 최근에는 더 많이 있다고 알고있다.

 

복잡도가 높거나 멀티 프로젝트의 경우 Gradle환경에서 진행하는 경우가 있으니

 

다음에는 Gradle관련한 정보를 공부하고 기록해야겠다.

 

*해당 포스팅은 갓대희님의 블로그에서 해당 내용을 발췌하여 직접 타이핑하며 옮겨적으면서 적용해보면서 정리하였음을 밝힙니다.*