Chani-Blog

Maven은 프로젝트 빌드 , 라이프 사이클 , 라이브러리 의존성 관리 등 프로젝트 전반을 위한 관리 도구이다. 최근에는 gradle도 프로젝트 관리 도구로 자주 사용되는데, gradle은 DSL 언어로 설정하고, maven은 gradle과 다르게 xml 언어로 프로젝트 구조를 관리한다. 그외의 차이점은 https://www.geeksforgeeks.org/difference-between-gradle-and-maven/ 에서 자세히 확인 할 수 있다.

Maven 프로젝트의 기본구조

- src
  - main
    - java
    - resources
    - webapp
  - test
    - java
    - resources

- target

src/main/java : Java 소스 파일 위치
src/main/resources : property 또는 xml 등 resource 파일이 위치하며 , classpath 에 포함된다.
src/main/webapp : 웹 application 관련 파일들이 위치한다. (WEB-INF , template 파일 )
src/test/java : 테스트 Java 소스 파일 위치
src/test/resources : 테스트 과정에서 사용되는 resource 파일이 위치하며 , 테스트에 사용되는 classpath에 포함된다.
target/classes : 컴파일 된 결과 (.class file)

Maven 기본 명령어

mvn package : 배포 가능한 jar file을 빌드해서 target 폴더 안에 생성한다.

pom.xml 파일

maven 프로젝트를 생성하면 자동으로 pom.xml 파일이 프로젝트 루트 폴더에 생성되는데, 이 파일에서 주로 다루고 있는 설정 정보는 다음과 같다.
- 프로젝트 정보 : 프로젝트 이름 , 라이센스 등
- 빌드 설정 : life cycle별 실행할 plugin등 빌드와 관련된 설정을 기술
- 빌드 환경
- POM 연관 정보 : 의존 외부 library
groupId는 주로 회사의 정보를 입력하며 , 패키지 형태로 계층을 표현한다. ex) com.회사명
artifactId : 프로젝트 결과물의 식별자
package : 생성할 패키지명을 입력하는 데 , default로는 groupId.artifcatId 와 동일한 패키지명을 생성하게 된다.
packaging : 패키징 타입 (.war 또는 .jar) 설정
dependencies : 해당 프로젝트가 의존하고 있는 외부 라이브러리 정보를 기입한다.

<?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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <groupId>net.madvirus</groupId>
  <artifactId>sample</artifactId>
  <version>1.0-SNAPSHOT</version>
  <packaging>jar</packaging>
  <name>sample</name>
  <url>http://www.example.com</url>

  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <maven.compiler.source>1.7</maven.compiler.source>
    <maven.compiler.target>1.7</maven.compiler.target>
  </properties>

  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.11</version>
      <scope>test</scope>
    </dependency>
  </dependencies>

  <build>
    <pluginManagement>
      <plugins>
        <plugin>
          <groupId>org.apache.maven.plugins</groupId>
          <artifactId>maven-compiler-plugin</artifactId>
          <configuration>
            <source>1.8</source>
            <target>1.8</target>
          </configuration>
        </plugin>
      </plugins>
    </pluginManagement>
  </build>
</project>

Dependency scope

pom.xml 파일에서 dependency 코드를 보면 <scope> 를 포함하는 경우가 있는데, <scope>는 의존하는 모듈이 언제 사용되는지 설명한다.
- compile : default값으로 컴파일할 떄 필요하다. 테스트 및 런타임에도 포함된다.
- runtime : compile할떄 필요하진 않지만, runtime에만 필요한 경우로, 배포 시 포함된다. ex) JDBC 드라이버
- provided : compile할떄는 필요하지만, 실제 runtime떄에는 WAS container에서 기본적으로 제공해서 배포시에는 제외된다. ex) Servlet , lombok
- test : 테스트 코드를 컴파일 할 때 필요로 한다. 배포 시에는 당연히 제외된다.

원격 repository와 로컬 repository

maven은 compile이나 packageing 등 작업을 수행할떄 필요한 plugin이나 depedency 에 기입된 라이브러리를 메이븐 중앙 repository (원격 repository)에서 다운받는다.

(중앙 repository : https://repo1.maven.org/maven2/)

원격 repository에서 다운받은 모듈은 local repository에 저장되는데 , [USER_HOME]/.m2/repository 폴더에 생성된다. 여기에는 해당 jar file 그리고 해당 jar file이 필요한 또 다른 의존관계에 있는 library를 기입하고 있는 pom.xml 파일을 포함하고 있다.

Maven lifeCycle

Maven은 크게 clean , build , site 3가지 lifeCycle을 제공한다. (https://maven.apache.org/guides/introduction/introduction-to-the-lifecycle.html)

lifeCycle의 특정단계를 수행하려면 mvn test , mvn clean과 같이 수행할 수 있다. 이떄 특정 단계를 수행하면 그 앞 단계의 모든 단계를 실행한다. 예를 들면 mvn test를 수행하면 validate 과정부터 prepare-package 과정까지 순서대로 실행한다.
plugin으로 직접 단계를 수행할수 있다. 이떄는 앞 단계가 전부 수행되는게 아니라 특정 plugin에서 특정 기능을 수행하는 형태로 돌아간다.

mvn surefire:test  // mvn plugin지정:수행할기능

Maven

Maven 프로젝트의 기본구조

Maven 기본 명령어

pom.xml 파일

Dependency scope

원격 repository와 로컬 repository

Maven lifeCycle

댓글

댓글