linuxism

Maven 은 간단하게 말하자면 Project Management Framework 라고 할 수 있다...
POM(Project Management Object)이란 녀석을 이용하여 빌드에서부터 시작해서 의존성 관리 및 배포까지 모든 것을 관리할 수 있다..
Maven을 이용하면 Coherence, Reusability, Agility, Maintainability 등을 제공한다고 한다...
아직 잘 모르면서 그냥 쓰고 있기 때문에 저런 장점을 제공하는지는 잘 모르겠다... -_-;;
대체 Maven이 어떤 철학을 가지고 있길래 저런 것들을 제공하는지 한 번 알아보자...

1. Convention Over Configuration
    
관념이 설정보다 우선한다는 말인데 이게 대체 무슨 말인가...
Ruby on Rails 에서 유명하게 된 말이라고 하는데 간단하게 말하자면 디폴트로 뭔가 정해 놓고 그건 신경쓰지 말고 쓰자는 말이다..
물론 설정을 통해 자신이 원하는대로 변경할 수 있지만 신경 쓸 필요 없는 걸 구지 신경쓰지 말잔 말이다..
Maven 에서는 다음과 같은 3가지를 제공하면서 위의 철학을 실현하고 있다..

• tandard Directory Layout
  말 그대로 디렉토리 구조를 미리 정해 놓은 것이다. 소스파일, 설정파일, 빌드파일, 도큐먼트 등의 위치를 정해놓고 그대로 쓰자는 얘기다.
• Separation Of Concerns
  하나의 프로젝트에서는 하나의 결과물을 가지도록 하는 것이다. 이를 통해 재사용성을 증가시킬 수 있다. 이는 바로 다음에 살펴볼 빌드 로직을 재사용하는 것에서 쉽게 확인할 수 있다.
• Standard Naming Conventions
  디렉토리와 결과물의 이름 규칙도 정해져 있다. 예를 들어 commons-loggin-1.2.jar 란 파일이 있다고 하면 commons logging의 버전 1.2를 사용한다는 것을 쉽게 알 수 있다. 자바의 get/set 메소드도 하나의 예라고 할 수 있다.

2. Reuse of Build Logic

Maven에서는 빌드 로직을 플러그인이란 이름의 모듈로 만들어 놓았다. 이런 플러그인에는 컴파일, 테스트, 패키징, 문서화 등등 수 많은 플러그인들이 존재한다. 여기서 아주 중요한 사실은 Maven은 이와 같은 플러그인들의 실행 결과가 모여서 최종 결과를 낸다는 것이다. 이런 플러그인들을 Maven의 설정 파일인 POM(Project Object Model)에 설정하게 되면 Build Life Cycle에 따라 실행되고 최종 결과물을 출력하게 된다.

3. Declarative Execution

위에서 잠깐 알아보았듯이 Maven에서는 POM(Project Object Model)에 모든 설정을 하게 된다. 그러면 POM이 무엇이고 잠깐 살펴본 Build Life Cycle이 무엇인지 알아보도록 하자.

POM(Project Object Model)

Maven에서는 하나의 프로젝트에 하나의 POM을 가진다. POM은 XML 형태로 구성되어 있고 아래는 아주 간단한 예제이다.

위의 15줄에 불과한 POM을 사용하면 컴파일, 테스트 및 문서화까지도 가능하다. 어떻게 이런 일이 가능할까... 왜냐하면 Maven은 묵시적으로 Super POM을 사용하기 때문이다. 자바의 Object 클래스와 같은 역할을 한다고 보면 된다. 그렇다면 각각의 속성에 대해 간단하게 알아보도록 하자.

<project> - pom.xml 파일의 ROOT. 무조건 이 속성으로 시작해야 한다.
<modelVersion> - 현재 POM이 사용하고 있는 버전을 나타낸다. 이 버전은 자기 마음대로 정해주면 되는데 적당히 잘 해주도록 하자.
<groupId> - 프로젝트를 만든 조직이나 그룹의 유일한 식별자이다. 보통 자바 패키지 만드는 형식으로 지정해주면 된다. 물론 안 그렇게 해도 된다.
<artifactId> - 프로젝트에서 생성하는 결과물의 이름에 사용되는 속성이다. Maven에서는 <artifactId>-<version>.<extension> 같은 형식의 파일 이름으로 패키징 해준다. 위의 예제는 my-app-1.0-SNAPSHOT.jar 와 같은 형태로 만들어지게 된다.
<packaging> - 패키징 할 파일 형식을 지정한다. (JAR, WAR, EAR 등등) 뿐만 아니라 빌드 프로세스의 부분으로 사용하기 위한 특정 Life Cycle을 나타내기도 한다. 그냥 Build Life Cycle을 커스터마이징 할 때 사용된다고 알아두면 된다고 한다. -_-;;
<version> - 프로젝트의 버전을 표시한다. 위에 SNAPSHOT이라고 붙은 것은 개발 상태일 때 붙인다고 한다.
<name> - 프로젝트의 이름
<url> - 프로젝트 사이트
<description> - 프로젝트 설명

다른 자세한 내용은 http://maven.apache.org/maven-model/maven.html 여기에 가면 확인할 수 있다. 일단 이정도 까지만 살펴보고 나머지는 뒤에 나올 것 같으니 일단 넘어가도록 하자...

Build Life Cycle

그렇다면 계속 말이 나오던 Build Life Cycle에 대해서 알아보자. 
일반적으로 소프트웨어 프로젝트는 비, 컴파일, 테스트, 패키징, 인스톨과 같은 비슷한 전형적인 경로를 갖는다. 
Maven에서는 이러한 경로를 Build Life Cycle이라고 부른다. 
Maven의 Build Life Cycle은 하나 이상의 Action 또는 Goal 들을 수행하는 여러 개의 단계들로 구성되어 있다. 
예를 들어 complie 단계는 클래스들을 컴파일하는데 필요한 Goal들의 집합을 실행시키게 된다는 말이다. 또
한 Maven에서 상위 레벨의 단계를 실행시키고자 하면 하위 레벨의 단계를 먼저 실행시켜주게 된다. 또 다시 complie을 예로 든다면 Maven은 이 단계를 실행하기 위해 하위 레벨 단계인 validate, initialize, generate-sources, process-sources, generate-resources 를 실행한 후에 complie을 수행하게 된다. 
이처럼 Build Life Cycle은 많은 단계들로 구성되어 있고 또한 이를 확장할 수도 있다. 
아까 위에서 빌드 로직을 모듈화해서 플러그인으로 만들어 놓은 것들이 바로 Build Life Cycle의 하나의 단계이다.

4. Coherent Organization of Dependencies

이번에는 Maven에서 의존성 관리를 어떻게 해주는지 살펴보도록 하자. 아까 살펴본 POM 예제를 다시 살펴보도록 하자.

딱 보면 알 수 있듯이 junit 란 녀석에게 의존성을 갖는 것을 알 수 있다.
의존성이란 Repository 에 존재하는 특정 라이브러리 파일에 대한 참조를 말한다.
Maven에서는 이런 의존성을 해결하기 위해 어떤 라이브러리 파일을 어떤 Repository를 살펴봐야 하는지 정보가 필요하다.
이런 것들은 groupId, artifactId, version 속성을 사용해서 식별하게 된다.
라이브러리가 물리적으로 어디에 존재하는지 또한 파일을 다운로드 받을 필요도 없다.
그저 위에서 처럼 설정만 하면 junit (groupId) 에서 제공하는 junit (artifactId) 의 3.8.1 (version) 에 의존성이 있다고 명시만 하면 된다..
그렇게 하면 Maven에서 이용 가능한 모든 Remote Repository를 뒤져서 사용자의 Local Repository로 복사해준다.
Maven에는 방금 살펴본대로 2가지 Repository가 존재한다.
Remove Repository는 말 그대로 해당 라이브러리를 다운로드 받을 수 있는 곳을 말한다.
Local Repository는 Maven을 처음 설치하고 실행하게 되면 모든 의존성이 있는 라이브러리를 모아 놓는 곳이다.
기본적으로 사용자의 홈 디렉토리에 ~/.m2/repository 요런 식으로 생성되게 된다.
위의 의존성을 해결하게 되면 사용자 홈 디렉토리에 다음과 같은 형식으로 해당 라이브러리 파일이 저장되게 된다.

repository
└ groupId
    └ artifactId
        └ version
            ├ artifactId-version.jar
            ├ artifactId-version.jar.sha1
            ├ artifactId-version.pom
            └ artifactId-version.pom.sha1

만약 groupId가 org.apache.maven 이라면 자바의 패키지 생성과 같은 방식으로 org - apache- maven 디렉토리가 생성되고 그 아래에 나머지 구조대로 생성되게 된다.
Maven은 이처럼 의존성을 해결할 때 먼저 Local Repository에 /repository/groupId/artifactId/version/artifactId-version.jar 파일이 존재하는지 확인한다.
만약 존재하지 않는다면 Remote Repository에서 다운로드 받아 Local Repository의 해당 위치에 복사하게 된다.
Maven은 Remote Repository로 http://www.ibiblio.org/maven2 를 기본으로 사용한다.
또한 Maven은 여러 개의 Remote Repository를 가질 수 있는데 POM에 정의된 순서대로 찾아가게 된다.
이렇게 Local Repository를 사용하면 여러 개의 프로젝트에서 같은 파일을 사용해도 하나의 파일만 존재하면 된다.
또한 버전별로 관리할 수 있으므로 쓸데 없는 라이브러리를 프로젝트에 추가하지 않을 수 있게 된다.

휴.. 이렇게 대충 Maven이 어떤 것이고 어떤 구조를 가지고 있으며 무슨 생각으로 이렇게 만들었는지 살펴보았다...
다음번에는 실제로 Maven을 사용해보도록 하자!!

1. Maven 템플릿 생성
   
   웹 어플리케이션 기반으로 Maven 기본 archetype 중에서 maven-archetype-webapp을 사용하여 user 프로젝트를 생성한다.
   명령 프롬프트에서 D:\Project로 이동한 후 다음 명령어를 실행하여 uSopoong_SK 프로젝트를 위한 템플릿을 생성한다. 
   
   mvn archetype:generate -DgroupId=com.csquare -DartifactId=uSopoong_SK -DarchetypeArtifactId=maven-archetype-webapp
   
   위 명령어를 실행하면 D:\Project 디렉토리에 uSopoong 프로젝트가 생성된다. 
   
   
2. Maven 빌드
   
   명령 프롬프트에서 D:\Project\uSopoong_SK 디텍토리로 이동한 후 아래 명령을 실행한다.
   mvn eclipse:eclipse
   
   
3. Eclipse 프로젝트로 가져오기
   
   이클립스 워크스페이스에서 File → Import → General → Existing Projects into Workspace 메뉴를 실행하여 uSopoong_SK프로젝트를 가져오기 한다. 
   
4. 디렉토리 생성
   
   maven-archetype-webapp은 웹 자원만 관리할 수 있게 Archetype이 생성되어 있다. uSopoong_SK 프로젝트에 src/main/java, src/test/java 디렉토리를 생성한다.
   
   
5. Ecplise WTP 로 구축하기
   
   pom.xml을 다음과 같이 설정하여 eclipse:eclipse Goal을 실행했을 때 WTP 기반 프로젝트가 생성되게 한다.
   <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.0http://maven.apache.org/maven-v4_0_0.xsd">
     <modelVersion>4.0.0</modelVersion>
     <groupId>com.csquare</groupId>
     <artifactId>uSopoong_SK</artifactId>
     <packaging>war</packaging>
     <version>1.0-SNAPSHOT</version>
     <name>uSopoong_SK Maven Webapp</name>
     <url>http://maven.apache.org</url>
     <dependencies>
       <dependency>
         <groupId>junit</groupId>
         <artifactId>junit</artifactId>
         <version>3.8.1</version>
         <scope>test</scope>
       </dependency>
     </dependencies>
     
     <properties>
      <webapp.context>/</webapp.context>
      <maven.compiler.source>1.5</maven.compiler.source>
      <maven.compiler.target>1.5</maven.compiler.target>
      <maven.compiler.encoding>utf-8</maven.compiler.encoding>
     </properties>
     
     <build>
       <finalName>uSopoong_SK</finalName>
       <plugins>
        <plugin>
         <artifactId>maven-compiler-plugin</artifactId>
         <configuration>
          <source>${maven.compiler.source}</source>
          <target>${maven.compiler.target}</target>
          <encoding>${maven.compiler.encoding}</encoding>       
         </configuration>
        </plugin>
        <plugin>
         <artifactId>maven-eclipse-plugin</artifactId>
         <version>2.4</version>
         <configuration>
          <wtpContextName>${webapp.context}</wtpContextName>
          <downloadSources>true</downloadSources>
          <downloadJavadocs>true</downloadJavadocs>
          <wtpversion>1.5</wtpversion>
         </configuration>
        </plugin>
       </plugins>
     </build>
       
   </project>
   
   
   pom.xml 파일에 위 설정을 추가한 후 명령 프롬프트에서
   mvn eclipse:clean eclipse:eclipse
   를 실행하여 프로젝트 메타데이터를 다시 생성한다.
   
   
   이클립스 워크스페이스에서 F5 키를 눌러 새로 고침을 하면 개발을 진행할 수 있다.

2. Maven 기반의 템플릿 프로젝트 생성

• Maven은 생성하는 프로젝트의 종류에 따라 기반이 되는 템플릿 프로젝트를 제공한다. Maven에서 지원하는 Archtype의 기능에는 소스 디렉토리, 테스트 소스 디렉토리, 웹 리소스 디렉토리 등의 기본 설정이 예약되어 있어 정해진 규칙에 따라 프로젝트의 뼈대를 자동으로 생성할 수 있다.
• jar 프로젝트 생성하는 방법
  mvn archetype:generate -DgroupId=com.hangyeol -DartifactId=myproject -DarchtypeArtifactId=maven-archetype-quickstart
  디렉토리 구조
  
  
  
  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.0http://maven.apache.org/maven-v4_0_0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.hangyeol</groupId>
    <artifactId>myproject</artifactId>
    <packaging>jar</packaging>
    <version>1.0-SNAPSHOT</version>
    <name>myproject</name>
    <url>http://maven.apache.org</url>
    <dependencies>
      <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>3.8.1</version>
        <scope>test</scope>
      </dependency>
    </dependencies>
  </project>
  
• war 프로젝트 생성하는방법
  mvn archetype:generate -DgroupId=com.hangyeol -DartifactId=myproject -DarchtypeArtifactId=maven-archetype-webapp
  
  디렉토리 구조
  
  
  
  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.0http://maven.apache.org/maven-v4_0_0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.hangyeol</groupId>
    <artifactId>mywebproject</artifactId>
    <packaging>war</packaging>
    <version>1.0-SNAPSHOT</version>
    <name>mywebproject Maven Webapp</name>
    <url>http://maven.apache.org</url>
    <dependencies>
      <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>3.8.1</version>
        <scope>test</scope>
      </dependency>
    </dependencies>
    <build>
      <finalName>mywebproject</finalName>
    </build>
  </project>
  

3. Maven 설정파일
POM(Project Obect Model)은 프로젝트 정보와 프로젝트를 빌드하는 설정 정보가 있는 XML파일이다.

• project
  pom.xml 파일의 최상위 엘리먼트이다.
• modelVersion
  POM 모델의 버전으로 가장 최근의 버전은 4.0.0이다.
• groupId
  프로젝트를 생성하는 조직의 고유 아이디를 결정한다. 일반적으로 도메인 이름을 사용한다.
• artifactId
  프로젝트를 식별하는 유익한 아이디를 의미한다. 예를 들어 com.hangyeol라는 groupId가 있는 조직에는 여러 개의 프로젝트가 존재할 수 있다.
• packaging
  프로젝트를 어떤 형태(jar, war, ear 등)로 패키징할지 결정한다.
• version
  프로젝트의 현재 버전이다. 개발이 완료된 버전의 경우 1.0, 2.0과 같이 사용하고, 개발 중인 프로젝트에서는 일반적으로 SNAPSHOT을 접미사로 사용한다. 
  ※ SNAPSHOT
  Maven 예약어로써, 개발 중인 프로젝트인 경우에는 라이브러리의 변경시 마다 새로 다운로드 하도록 지원한다.
• name
  프로젝트의 이름이다.
• url
  프로젝트 사이트가 있다면 사이트 URL을 등록한다.
• dependencies
  프로젝트와 의존 관계에 있는 라이브러리를 관리한다.

4. Maven의 디렉토리 구조와 라이프 사이클

• Maven의 라이프 사이클
• compile
  소스 코드를 컴파일한다.
• test
  JUnit, TestNG와 같은 단위 테스트 프레임워크로 단위 테스트를 한다.
• package
  단위 테스트가 성공하면 압축한다.(jar, war ...)
• install
  로컬 저장소에 압축한 파 일을 배포한다.
• deploy
  원격 저장소에 압축한 파일을 배포한다.
• clean
  빌드 결과물이 위치하는 target 디렉토리를 삭제한다.
• site
  프로젝트에 관한 웹 사이트를 생성한다.
• 소스 컴파일
  자원을 복사한 다음에 src/main/java 디렉토리의 자바 소스 코드를 target/classes 디렉토리로 컴파일한다.
  mvn compile
  
  ※ 자원 관리하는 방법
• src/main/resources 디렉토리에 있는 모든 자원
• pom.xml 파일에서 재정의
• 테스트 소스 코드 컴파일
  
  mvn test-compile
  
• 테스트
  컴파일한 테스트 클래스(target/test-classes)로 구현 클래스를 테스트 한 후 테스트 결과를 target/surefire-reports 디렉토리에 생성한다.
  
  mvn test
  
• 패키징
  compile, test-compile, test 순으로 실행된 다음 target 디렉토리 아래에 pom.xml에 정의한 형태로 artifactId-version.packaging 또는 finalName.packaging
  압축파일을 생성한다.
  mvn package
  
• 배포하기
  Maven 로컬 저장소에 압축한  jar, war 파일을 배포하는 한다.
  mvn install
  
  다른 개발자와 jar, war 파일을 공유하기 위해 로컬에 파일을 원격 저장소에 등록한다.
  
  mvn deploy
• 빌드 결과물 제거
  target 결과물을 모두 제거한다.
  target 결과물을 모두 제거한 후 test를 실행한다.
  target 결과물을 모두 제거한 후 install을 실행한다. 
  mvn clean
  mvn clean test
  mvn clean install
  

5. Maven으로 의존 관계 라이브러리 관계

• Ant에서 Maven으로 전환했을 때 가장 유용하게 사용하는 기능이 의존 관계에 있는 라이브러리를 관리하는 의존성 관리(Dependency Management)이다. Maven은 중앙 저장소엣 관리하는 수많은 라이브러리를 pom.xml 설정만으로 로컬 PC에 자동으로 다운로드하게 된다. 이는 라이브러리를 버전이 변경되더라도 pom.xml 설정 파일의 숮ㅇ만으로 변경된 라이브러리를 반영할 수 있다.
• AS-IS 의존 관계 라이브러리의 관리 방법
• Maven의 의존 관계 관리 기능
• 로컬 저장소 변경
• 의존 관계 랑이브러리의 적용 범위

6. 이클립스 플러그인 활용한 WTP 프로젝트 생성
7. Profile 기능 활용하기
개발 환경에 따라 달라지는 설정 정보를 관리하는 기능을 제공한다.

데이터베이스 설정 정보
로그인 설정 정보
프레임워크와 관련된 설정 정보
서버에 대한 설정 정보