[tools] 메이븐(maven) 학습

March 14, 2022

🦥 maven 으로 자바 프로젝트 생성하기

아래 명령어는 온라인상태에서 진행, 오프라인에서도 방법이 있을것 같긴 하다.
maven 프로젝트 생성을 위한 플러그인이 다운로드되어야 하는듯 함.
mvn archetype:generate -DgroupId=com.sk.sample -DartifactId=sampleProject -DarchetypeArtifactId=maven-archetype-quickstart
console 상에서 명령어로 진행하는 대신, 이클립스에서 maven 프로젝트를 생성한다.

최초에는 아래와 같이 pom.xml 이 생성된다.

<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>com.sk</groupId>
  <artifactId>maven-basic</artifactId>
  <version>0.0.1-SNAPSHOT</version>
  <packaging>jar</packaging>

  <name>maven-basic</name>
  <url>http://maven.apache.org</url>

  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  </properties>

  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>3.8.1</version>
      <scope>test</scope>
    </dependency>
  </dependencies>
</project>

maven 의 기본 자바 버전은 1.5 이고, junit 도 옛날 버전으로 되어 있다.
일단 junit을 삭제하고, java버전을 8로 올린다.

pom.xml을 수정한 후에는 이클립스의 프로젝트코드를 maven -> update project,, 해줘야 한다.

maven 빌드해보기

cmd에서 pom.xml 이 있는 경로로 이동한다.
mvn clean package 명령어를 실행한다.
target 디렉토리가 생성되고, 하위에 jar 파일과 classes 하위에 class 파일이 생성된다.
아래 명령어를 실행하여 main 메소드를 실행해본다.
java -cp target/classes com.sk.basic.App 또는
java -cp target/maven-basic-0.0.1-SNAPSHOT.jar com.sk.basic.App
다음은 dependency 를 추가해보자.
pom.xml 에 아래와 같이 build 를 추가한다.

<build>
		<finalName>maven-sample</finalName>
		<sourceDirectory>src/main/java</sourceDirectory>

		<plugins>
			<plugin>
				<artifactId>maven-eclipse-plugin</artifactId>
				<version>2.9</version>
			</plugin>
			<plugin>
				<groupId>org.apache.maven.plugins</groupId>
				<artifactId>maven-dependency-plugin</artifactId>
				<version>2.4</version>
				<executions>
					<execution>
						<id>copy-dependencies</id>
						<phase>package</phase>
						<goals>
							<goal>copy-dependencies</goal>
						</goals>
					</execution>
				</executions>
			</plugin>
		</plugins>
	</build>

메이븐에서 jar 패키징시에는 의존 라이브러리들이 함께 패키징 되지 않는다. maven-dependency-plugin 플러그인을 통해 의존 라이브러리들을 특정 디렉토리에 복사시켜주는 기능을 해준다.
main-jar-plugin 은 현재경로에서의 lib 폴더의 파일들을 classpath로 추가시켜준다.
다시 mvn clean package 명령어를 실행한다. 그럼 dependency 폴더에 의존관계에 있는 라이브러리들이 생성된다.
의존성을 갖고 있는 라이브러리를 추가하여 다시 main 메서드를 실행한다.
java -cp target/maven-sample.jar;target/dependency/* com.sk.basic.App
java -cp target/classes;target/dependency/* com.sk.basic.App
리눅스에서는 경로구분값으로 ‘:’을 사용해야 한다.
java -cp target/classes:target/dependency/* com.sk.basic.App
java -classpath target/classes:target/dependency/* com.sk.basic.App
리눅스에서는 위 명령어를 sh 파일로 만들어 사용할 수도 있다.

Maven compile

maven-compiler-plugin은 컴파일시 사용하는 플러그인이다.
dependency 에 정의되지 않은 경우, cp 옵션을 통해, 빌드패스를 잡아주고 컴파일 할 수 있다.

<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>com.sk</groupId>
	<artifactId>maven-basic</artifactId>
	<version>0.0.1-SNAPSHOT</version>
	<packaging>jar</packaging>

	<name>maven-basic</name>
	<url>http://maven.apache.org</url>

	<dependencies>
		<dependency>
			<groupId>ch.qos.logback</groupId>
			<artifactId>logback-classic</artifactId>
			<version>1.1.2</version>
		</dependency>
	</dependencies>

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

	<build>
		<finalName>maven-sample</finalName>
		<sourceDirectory>src/main/java</sourceDirectory>

		<plugins>
			<plugin>
				<groupId>org.apache.maven.plugins</groupId>
				<artifactId>maven-compiler-plugin</artifactId>
				<version>3.1</version>
				<configuration>
					<compilerArgs>
						<arg>-cp</arg>
						<arg>lib/guava-18.0.jar;lib/jdom-1.0.jar</arg>
					</compilerArgs>
				</configuration>
			</plugin>
			<!-- <plugin>
				<groupId>org.apache.maven.plugins</groupId>
				<artifactId>maven-jar-plugin</artifactId>
				<version>2.6</version>
				<configuration>
					<archive>
						<manifest>
							<addClasspath>true</addClasspath>
							<packageName>com.sk.basic.App</packageName>
							<classpathPrefix>lib/</classpathPrefix>
						</manifest>
					</archive>
				</configuration>
			</plugin> -->
			<plugin>
				<artifactId>maven-eclipse-plugin</artifactId>
				<version>2.9</version>
			</plugin>
			<plugin>
				<groupId>org.apache.maven.plugins</groupId>
				<artifactId>maven-dependency-plugin</artifactId>
				<version>2.4</version>
				<executions>
					<execution>
						<id>copy-dependencies</id>
						<phase>package</phase>
						<goals>
							<goal>copy-dependencies</goal>
						</goals>
						<configuration>
							<outputDirectory>${project.build.directory}/lib</outputDirectory>
							<overWriteReleases>false</overWriteReleases>
							<overWriteSnapshots>false</overWriteSnapshots>
							<overWriteIfNewer>true</overWriteIfNewer>
						</configuration>
					</execution>
				</executions>
			</plugin>
		</plugins>
	</build>
</project>

만약, guava-18.0.jar, jdom-1.0.jar 는 lib 폴더에 있고, 나머지는 dependency 로 정의되어 있다면, 프로덕트코드는 target/classes에 생성되고, dependency에 정의된 logback은 lib 폴더에 생성된다. guava-18.0.jar, jdom-1.0.jar는 수작업으로 lib폴더에 넣어주고, 아래와 같이 명령어를 수행한다.
java -cp target/classes;target/lib/* com.sk.basic.App
하지만 이건 바람직한 방식이 아니다.

<plugin>
				<groupId>org.apache.maven.plugins</groupId>
				<artifactId>maven-compiler-plugin</artifactId>
				<version>3.1</version>
				<configuration>
					<skipMain>true</skipMain>
				</configuration>
</plugin>

굳이 컴파일 할필요가 없다면, maven-compiler-plugin에 skipMain 을 true 로 설정한다.

Maven 실행 jar 만들기

<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>com.sk</groupId>
	<artifactId>maven-basic</artifactId>
	<version>0.0.1-SNAPSHOT</version>
	<packaging>jar</packaging>

	<name>maven-basic</name>
<!-- 	<url>http://maven.apache.org</url> -->
	<dependencies>
		<!-- unit testing -->
		<dependency>
			<groupId>junit</groupId>
			<artifactId>junit</artifactId>
			<version>4.11</version>
			<scope>test</scope>
		</dependency>

		<dependency>
			<groupId>com.google.guava</groupId>
			<artifactId>guava</artifactId>
			<version>18.0</version>
		</dependency>

		<!-- logger -->
		<dependency>
			<groupId>ch.qos.logback</groupId>
			<artifactId>logback-classic</artifactId>
			<version>1.1.2</version>
		</dependency>
	</dependencies>

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

	<build>
		<finalName>maven-sample</finalName>
		<sourceDirectory>src/main/java</sourceDirectory>

		<plugins>
			<plugin>
				<groupId>org.apache.maven.plugins</groupId>
				<artifactId>maven-jar-plugin</artifactId>
				<version>2.6</version>
				<configuration>
					<archive>
						<manifest>
							<addClasspath>true</addClasspath>
							<mainClass>com.sk.basic.App</mainClass>
							<classpathPrefix>lib/</classpathPrefix>
						</manifest>
					</archive>
				</configuration>
			</plugin>
			<plugin>
				<artifactId>maven-eclipse-plugin</artifactId>
				<version>2.9</version>
			</plugin>
			<plugin>
				<groupId>org.apache.maven.plugins</groupId>
				<artifactId>maven-dependency-plugin</artifactId>
				<version>2.4</version>
				<executions>
					<execution>
						<id>copy-dependencies</id>
						<phase>package</phase>
						<goals>
							<goal>copy-dependencies</goal>
						</goals>
						<configuration>
							<outputDirectory>${project.build.directory}/lib</outputDirectory>
							<overWriteReleases>false</overWriteReleases>
							<overWriteSnapshots>false</overWriteSnapshots>
							<overWriteIfNewer>true</overWriteIfNewer>
						</configuration>
					</execution>
				</executions>
			</plugin>
		</plugins>
	</build>
</project>

java -jar target/maven-sample.jar 명령어로 main class 를 실행한다.
리눅스 서버에서도 동일하게 동작한다.

##스프링 부트 maven 빌드 해보기

<build>
		<plugins>
			<plugin>
				<groupId>org.springframework.boot</groupId>
				<artifactId>spring-boot-maven-plugin</artifactId>
				<configuration>
					<excludes>
						<exclude>
							<groupId>org.projectlombok</groupId>
							<artifactId>lombok</artifactId>
						</exclude>
					</excludes>
				</configuration>
			</plugin>
		</plugins>
	</build>

스프링부트에서는 spring-boot-maven-plugin 사용하는 것을 추천한다고 한다. 하지만, 저렇게 하면 하나의 jar에 다 묶에게 되어 파일사이즈가 커진다.
분리하고 싶으면 위에서 했던 방식대로 maven-jar-plugin 와 maven-dependency-plugin 를 사용한다.
만약 스프링부트를 백그라운드로 실행하고자 한다면, nohup java -jar xxx.jar &

[tools] 메이븐(maven) 학습

🦥 maven 으로 자바 프로젝트 생성하기

maven 빌드해보기

Maven compile

Maven 실행 jar 만들기

Leave a comment

You may also enjoy

[java] Generic Wildcard의 super 와 extends

[java] Inputstream and InputStreamReader

[java] 자동 형변환(AutoBoxing, UnBoxing)

[java] 중첩 클래스(nested class)