Maven 설정

Spring Project에 필요한 Maven 설정을 할 수 있다.

Maven이란

Maven 로고

Maven이란 Apache Software 재단에서 진행중인 오픈 프로젝트로서, 소프트웨어 프로젝트 관리 자동화 도구이다. POM(Project Object Model) 형태로 프로젝트를 관리하며, pom.xml 파일에 설정 내용을 저장한다.

Maven Architecture

pom 설정

프로젝트 최초에 아무런 설정을 하지 않으면 Spring MVC Project는 자바 버전을 1.6으로 설정한다. 이러한 설정들을 변경하기 위해서는 우리가 직접 작업하는 것이 아니라 pom.xml에 있는 설정을 변경하고 maven에 빌드를 요청할 필요가 있다.

최초 생성 시 Java version

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/maven-v4_0_0.xsd">

</project>

project 영역 내부에 태그 형식으로 정보들을 선언하게 되며, 주요 설정 정보들은 다음과 같다.

프로젝트 정보 설정

pom.xml의 상단에는 프로젝트의 정보가 설정되어 있다. 프로젝트 생성 시 입력한 정보로 자동 생성되므로 별도로 작업할 내역은 없다.

<modelVersion>4.0.0</modelVersion>
<groupId>com.hakademy</groupId>
<artifactId>spring04</artifactId>
<name>spring04mavensetting</name>
<packaging>war</packaging>
<version>1.0.0-BUILD-SNAPSHOT</version>

속성	설명
modelVersion	POM(Project Object Model)의 버전
groupId	고유한 조직의 이름
artifactId	일반적으로 프로젝트가 알려진 이름(버전을 제외한 파일명)
name	애플리케이션 이름
packing	애플리케이션을 빌드하기 위한 유형
version	애플리케이션의 버전

저장소 설정

프로젝트에서 사용할 의존성 객체를 다운로드 받을 수 있도록 설정하는 영역 문서에 기본적으로 작성되어 있지 않기 때문에 필요한 경우 추가로 생성해야 한다. 기본 저장소로 http://repo.maven.apache.org/maven2을 사용하며, 필요하다면 여러개 선언하여 원하는 파일들을 가져올 수 있고 원한다면 폐쇄 환경에서의 저장소를 사용할 수도 있다.

<!-- 저장소를 등록하기 위한 영역 -->
<repositories>
    <!-- 저장소는 내부에 원하는 개수만큼 추가 가능하다 -->
    <repository>
        ...
    </repository>
</repositories>

속성 정보는 다음과 같다.

속성	설명
id	저장소의 식별 ID
name	저장소 이름
url	저장소의 주소

일반적으로 Oracle JDBC Driver(ojdbc.jar)의 경우 기본 저장소에서 받을 수 없으므로 다음과 같이 설정해둔다.

<repositories>
    <!-- oracle driver repository -->
    <repository>
        <id>oracle</id>
        <name>Oracle JDBC Driver Repository</name>
        <url>http://maven.jahia.org/maven2</url>
    </repository>
</repositories>

변수 설정

문서 내에서 버전 등을 정의할 때 직접 적는 것보다 변수화 시켜 사용하면 관리가 더 수월하다. pom.xml에서는 properties 영역을 통해 이러한 정보 저장을 지원한다.

<properties>
    <java-version>1.6</java-version>
    <org.springframework-version>3.1.1.RELEASE</org.springframework-version>
    <org.aspectj-version>1.6.10</org.aspectj-version>
    <org.slf4j-version>1.6.6</org.slf4j-version>
</properties>

위의 내용이 기본적으로 프로젝트 생성 시 pom.xml에 작성된 내용이며, 이 내용을 원하는 위치에 출력하고 싶을 경우 다음과 같이 작성한다.

${java-version}
${org.springframework-version}
${org.aspectj-version}
${org.slf4j-version}

필요하다면 원하는 정보를 원하는 이름으로 선언할 수 있다.

의존성 설정

실질적으로 프로젝트에서 사용할 의존성 객체들을 선언하는 영역이다. dependencies라는 영역을 통해 지원한다.

<dependencies>
    <dependency>
        ...
    </dependency>
</dependencies>

dependency는 여러 개 선언할 수 있다. 필요한 dependency를 어떤 방법으로 추가해야할지 모르는 경우 maven 중앙 저장소를 이용할 수 있다.

https://mvnrepository.com/

예를 들어 common-dbcp2라는 모듈의 의존성을 추가하려고 할 때 다음과 같이 작업한다.

1. 사이트 검색창에 common-dbcp2를 입력한다.

2. 검색 결과 중 원하는 것을 선택한다.

3. 원하는 버전을 선택한다.

4. Maven Dependency 코드를 복사한다.

5. pom.xml의 dependencies 영역에 붙여넣기한다.

사이트 검색창에 "common-dbcp2" 입력

검색 결과 선택

버전 선택. 안정적인 최신 버전을 선택한다.

코드 복사(클릭 시 자동으로 추가되며, 링크 제거를 원할 경우 체크 해제)

pom.xml에 코드 추가

플러그인 설정

maven에서 사용하는 주요 명령들을 플러그인 형태로 설정할 수 있는 영역. plugins 영역을 통해 지원한다.

<build>
    <plugins>
        <plugin>
            ...
        </plugin>
    </plugins>
</build>

기본적으로 설정된 플러그인은 다음과 같다.

• maven-eclipse-plugin : maven 프로젝트를 eclipse 프로젝트로 변환

• maven-compiler-plugin : maven 프로젝트를 빌드하기 위한 JDK 선택 플러그인

• exec-maven-plugin : maven 프로젝트 빌드 시 외부 프로그램을 사용하기 위한 플러그인

이 중 maven-compiler-plugin을 살펴보면 자바 버전이 설정되는 영역을 찾을 수 있다.

이 부분을 properties에서 선언해두었던 java-version으로 교체한다.

이제 properties의 자바 버전을 변경한 뒤 빌드를 진행하면 작성된 버전에 따라 다르게 적용되는 것을 확인할 수 있다.

Maven 프로젝트 업데이트

설정이 변경된 경우 자동으로 처리되는 것들도 있지만 수동으로 갱신해야 하는 항목들도 존재한다. 이럴 경우 maven update를 이용하여 처리한다.

1. 프로젝트를 우클릭하여 [Maven] → [Update Project] 를 선택하거나 Alt + F5를 누른다.

2. 원하는 프로젝트를 선택한 뒤 [ok]를 누른다.