development_-_MAVEN

Report
TSA System Development
MAVEN
MRACE corp.
[email protected]
Maven 이란?
Maven이 지원하는 작업은 다음과 같다.
• Builds
• Documentation
• Reporting
• Dependencies
• SCMs
• Releases
• Distribution
MAVEN 설치
http://maven.apache.org에서 Maven 최신
버전을 다운받는다.
 apache-maven-2.2.1-bin.zip을 받아서 압축
풀고 설치
 환경변수 설정
• M2_HOME = d:\apache-maven-2.2.1
• M2 = %M2_HOME%\bin
• Path = %M2%;%Path%
 정상설치 확인
• mvn -version

Maven 기반 프로젝트 생성

Template Java 프로젝트
D:\java> mvn archetype:create DgroupId=net.javajigi -DartifactId=mysample

Template Webapp 프로젝트
D:\java> archetype:create -DgroupId=net.javajigi
-DartifactId=mywebapp DarchetypeArtifactId=maven-archetypewebapp
Maven 프로젝트 설정

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/mavenv4_0_0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>net.javajigi</groupId>
<artifactId>mysample</artifactId>
<packaging>jar</packaging>
<version>1.0-SNAPSHOT</version>
<name>mysample</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>
pom.xml 파일








project : pom.xml 파일의 최상위 엘리먼트
modelVersion : POM model의 버전.
groupId : 프로젝트를 생성하는 조직의 고유 아이디를 결정한다. 일
반적으로 Full 도메인 이름을 사용하는 경우가 많다.
artifactId : 해당 프로젝트에 의하여 생성되는 artifact의 고유 아이디
를 결정한다. Maven을 이용하여 pom.xml을 빌드할 경우 다음과 같
은 규칙으로 artifact가 생성된다. artifactid-version.packaging. 위 예
의 경우 빌드할 경우 mysample-1.0-SNAPSHOT.jar 파일이 생성된다.
packaging : 해당 프로젝트를 어떤 형태로 packaging 할 것인지 결
정한다. jar, war, ear 등이 해당된다.
version : 프로젝트의 현재 버전. 추후 살펴보겠지만 프로젝트가 개
발 중일 때는 SNAPSHOT을 접미사로 사용한다. Maven의 버전 관리
기능은 라이브러리 관리를 편하게 한다.
name : 프로젝트 이름
url : 프로젝트 사이트가 있다면 사이트 URL을 등록하는 것이 가능
하다.
Maven의 디폴트 Goals
compile goal
• d:\myproject\>mvn compile
 test-compile Goal : src/main/java 디렉토리에
위치한 구현 코드만 컴파일
• d:\myproject\> mvn test-compile
 test Goal : 테스트 코드 이용한 구현 코드를 테
스트
• d:\myproject\> mvn test
 Package : 컴파일한 구현 코드를 jar, war로 압
축
• d:\myproject\> mvn package

Maven Repository에 등록
local Repository에 등록
• mvn install
 Remote Repository에 등록
• mvn deploy
 Goal의 의존관계
• compile, test-compile, test, package, install,

deploy 순이다
기존 공유 라이브러리의 문제점
지금까지 외부 라이브러리를 관리하는 방법은 다음과 같은
문제점을 가지고 있다.
•
•
•
•
•

라이브러리의 추가 및 버전 변경이 불편하다.
버전 관리 시스템(CVS, SVN)을 이용하여 공유할 파일 크기가 커진다.
현재 사용하고 있는 라이브러리의 버전을 파악하기 힘들다.
컴파일, 배포, 테스트할 때만 사용하는 라이브러리를 분리하기 힘들다.
WTP의 경우 자동 클래스 패스 기능이 너무 느리다.
하나의 애플리케이션을 개발할 때 외부 라이브러리의 의
존도가 어떻게 변화하고 있는지 살펴보면 다음과 같다.
Maven의 Dependency 관리 기능

pom.xml 파일의 dependencies 엘리먼트를 사용하여 외부 라
이브러리와의 의존관계를 설정한다.
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>3.8.1</version>
<scope>test</scope>
</dependency>
</dependencies>


<dependencies> 엘리먼트가 의미하듯 엘리먼트 하위에 여러
개의 <dependency> 엘리먼트를 가질 수 있다.
"mvn compile" 명령을 실행하면 junit 3.8.1 버전의 jar 파일이
자동으로 Local Repository 디렉토리에 모든 Dependency 라
이브러리가 다운 받아진다. 위와 같이 pom.xml 파일을 설정
한다면 다음 위치에 jar 파일이 다운 받아진다.
Maven의 중앙 Repository


Maven 이 Dependency 라이브러리를 관리 가능한 것은Maven이 오
픈 소스 라이브러리에 대한 중앙 Repository를 유지하기 때문이다.
pom.xml 파일에 특별히 Repository를 설정할지 않을 경우 Maven의
중앙 Repository는 http://www.ibiblio.org/maven/ 이다.
http://mvnrepository.com/에서 Maven에서 사용 가능한 라이브러
리를 검색할수 있다.
좌측의 <dependency> 엘리먼트
를 추가하게 되면 spring 프레임워
크 라이브러가 Local Repository에
자동으로 다운되어 Maven이 빌드
할 때 사용되게 된다. 클래스패스
에 하는 추가적인 작업을 할 필요
도 없다. Maven은 pom.xml 설정
파일의 <dependency> 엘리먼트
정보를 이용하여 Local Repository
에서 해당 jar 파일을 찾게 되는 것
이다.
Maven의 Local Repository


Maven을 사용할 때 Local Repository의 경로는 디폴트로
USER_HOME/.m2/repository가 된다. Local Repository의 경로를 바
꾸고자 한다면 다음과 같은 방법으로 변경한다.
MAVEN_HOME/conf 디렉토리 하위에 settings.xml 파일을 열어보면
localRepository 엘리먼트가 주석처리 되어 있는 것을 확인할 수 있
다. 주석처리되어 있는 localRepository를 다음과 같이 변경해 주면
된다.
<localRepository>D:/Repositories/MavenRepository</localRepository>
Dependency 라이브러리의 Scope
Maven은 사용하고 있는 라이브러리의 성격에 따라 Scope를 지정하는 것이 가
능하다. 예를 들어 junit의 경우 단순히 테스트를 위해서만 사용되고 실제 배포
될 때는 필요없는 라이브러리이다.
• compile : scope를 설정할지 않았을 때의 디폴트 scope이다. 컴파일 시에도 사용되며, 배
•
•
•
•
포시에도 같이 배포되어야 하는 라이브러리이다.
provided : JDK가 컨테이너에 의하여 제공되는 라이브러리이다. 예를 들어 servlet.jar의 경
우 Servlet 컨테이너에 의하여 제공되기 때문에 이 scope를 사용한다.
runtime : 이 scope는 말 그대로 컴파일 시에는 사용되지 않지만 애플리케이션을 실행할
때 사용되는 라이브러리일 경우 설정한다.
test : 테스트를 위해서만 사용하는 라이브러리이다.
system : 이 scope는 provided와 비슷하다. 단지 우리가 직접 jar 파일을 제공해야 한다. 따
라서 이 scope의 jar 파일은 repository에서 관리되지 않을 수도 있다.
Maven Dependency 라이브러리를 관리하는 방법에 대하여 살펴보았다.
Maven을 사용하면서 가장 큰 도움을 얻을 수 있는 부분이며, 정말 유용한 기능
이다. 현재 Ant를 사용하고 있다면 Antlib을 사용해서 Maven의 Dependency
기능을 이용하는 것이 가능하다. 그러므로 외부 라이브러리 관리에 불편함을
겪고 있는 개발자라면 Maven의 Dependency 기능을 꼭 사용해보기 바란다.
m2eclipse 설치


Eclipse 3.2 이상, JDK 1.4 이상, Eclipse는 JRE가 아닌 JDK 상에서 실행
되는지 확인
Eclipse 플러그인인 Subclipse와 Mylyn을 설치
•
•
•
•


Subclipse 1.2 : http://subclipse.tigris.org/update_1.2.x
Mylyn (Eclipse 3.3) : http://download.eclipse.org/tools/mylyn/update/e3.3
Mylyn (Eclipse 3.4) : http://download.eclipse.org/tools/mylyn/update/e3.4
Mylyn Extras (JIRA 지원) : http://download.eclipse.org/tools/mylyn/update/extras
Help -> Software Updates -> Find and Install -> Install/Update 다
이얼로그 상자 -> "Search for new features to install“ 선택사항 클릭
하고 Next를 클릭 -> Add Site.. -> update site URL 입력
• m2eclipse 플러그인 : http://m2eclipse.sonatype.org/update
Eclipse가 새로운 플러그인들을 설치한 후에, 재시작에 대한 허가를 요
청한다.
m2eclipse 설치후 경고 오류


"Maven Integration for Eclipse JDK Warning" 경고
이클립스는 JRE만 있어도 동작이 가능한데 Maven 코어
의 플러그인들이 JDK의 jars를 사용하므로 eclipse.ini에
서 -vm옵션으로 JDK를 설정하라고 하네요.
--launcher.XXMaxPermSize
256m
-vm
C:\Program Files\Java\jdk1.5.0_16\bin\javaw.exe
-vmargs
-Dosgi.requiredJavaVersion=1.5
-Xms40m
…
Maven 기반 Eclipse 프로젝트 활용

Eclipse 프로젝트로 변환
• Maven 기반으로 개발된 프로젝트를 Eclipse 프로젝트로 변환하는 작업은 간단하
•
다. 프로젝트 디렉토리로 이동한 다음 "mvn eclipse:eclipse" 명령어를 실행하면
Eclipse 기반 프로젝트로 변경된며 .project, .classpath 파일들이 자동적으로 생성
된다. .classpath 파일을 열어보면 pom.xml 파일에서 의존관계에 있는 모든 라이
브러리들이 자동적으로 추가되어 있는 것을 확인할 수 있다.
예를 들어 pom.xml 파일이 다음과 같이 설정되어 있다
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>3.8.1</version>
<scope>test</scope>
</dependency>
• .classpath는 다음과 같이 추가된다
<classpathentry kind="var"
path="M2_REPO/junit/junit/3.8.1/junit-3.8.1.jar"
sourcepath="M2_REPO/junit/junit/3.8.1/junit-3.8.1-sources.jar"/>
Maven 라이브러리 자바소스 분리 배포

라이브러리 배포할 때 자바 소스까지 분리해서 배포
• Eclipse 기반으로 애플리케이션을 개발할 때 F3나 디버깅을 많이 이용할 것이다.
이 기능들을 이용할 때 불편했던 점은 외부 라이브러리에 대한 소스 코드가 존재
하지 않아 소스 코드를 분석하는데 한계가 있었던 것이 사실이다. 그러나 Maven
을 이용할 경우 이 같은 단점을 보완할 수 있다. Maven을 이용하여 소스 코드를
배포하는 모든 라이브러리의 소스 코드는 자동적으로 Local Repository에 다운
받아져 위와 같이 설정이 가능하기 때문에 Eclipse에서 외부 라이브러리 소스코
드에 접근하기 용이해진다.

디폴트 pom.xml을 사용할 경우 자바 프로젝트가 생성된다. 만약 웹
애플리케이션을 생성하기 위하여 WTP 기반으로 애플리케이션을 개
발하고자 한다면 pom.xml에 다음과 같은 설정을 추가함으로서 해
결할 수 있다.
<plugins>
<plugin>
<artifactId>maven-eclipse-plugin</artifactId>
<version>2.4</version>
<configuration>
<downloadSources>true</downloadSources>
<downloadJavadocs>true</downloadJavadocs>
<wtpversion>1.5</wtpversion>
</configuration>
</plugin>
</plugins>
M2_REPO 설정하기

Maven을 이용하여 생성한 프로젝트를 import 하면 빌드 에러가 발
생할 것이다. 그 이유는 앞의 .classpath에서 확인할 수 있듯이
M2_REPO가 classpath variable에 추가되어 있지 않기 때문이다.
Window || Preferences || Java || Build Path || Classpath Variables로
이동한 다음 M2_REPO를 추가할 수 있다.
사내 Maven Repository의 구축

사내 Maven Repository 구축의 필요성
사외 Maven Repository
사내 Maven Repository
사내 Maven Repository의 구축



Artifactory 활용(오픈소스)
• http://www.jfrog.org/download.php 에서 Artifactory 최신버전 다운로드
• JDK 5.x 이상을 설치
• Tomcat 5.5 이상을 설치
Artifactory는 웹 애플리케이션으로 구현되어 있다. 다운 받은
Artifactory 최신 버전을 풀어보면 webapps 디렉토리 아래에
artifactory.war 파일을 찾을 수 있다.
이 artifactory.war 파일을 TOMCAT_HOME/webapps 디렉토리 아래에
복사한다. TOMCAT_HOME/bin 디렉토리 아래에 catalina.bat 파일을
열어 JAVA_OPTS에 다음 항목을 추가한다.
• JAVA_OPTS = -Dartifactory.home=D:\Devs\Tools\artifactory1.2.2


TOMCAT 에 추가하지 않고 시스템 환경 변수에 추가해도 된다.
artifactory.home에 설정해야 하는 디렉토리는 Artifactory 최신 버전
의 압축을 푼 디렉토리이다. Artifactory는 Artifactory 설치 디렉토리
하위의 data 디렉토리를 이용하기 때문에 위 항목을 반드시 추가해야
한다.
Artifactory 설치는 위 과정만 거치면 간단하게 설치할 수 있다.
Artifactory 사용하기

라이브러리를 분리해서 관리하기 위해 Artifactory를 다음과 같이 설정하는
것이 가능하다.
<ARTIFACTORY_INSTALLATION_FOLDER>/etc/artifactory.config.xml 파일을
만든 후 다음과 같이 설정할 수 있다.
<?xml version="1.0" encoding="UTF-8"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://artifactory.jfrog.org/xsd/1.0.0"
xsi:schemaLocation="http://artifactory.jfrog.org/xsd/1.0.0” http://www.jfrog.org/xsd/artifactory-v1_0_0.xsd">
<!-- Backup every 12 hours -->
<!--<backupCronExp>0 0 /12 * * ?</backupCronExp>-->
<localRepositories>
<localRepository>
<key>private-internal-repository</key>
<description>Private internal repository</description>
<handleReleases>true</handleReleases>
<handleSnapshots>true</handleSnapshots>
</localRepository>
<localRepository>
<key>3rd-party</key>
<description>3rd party jars added manually</description>
<handleReleases>true</handleReleases>
<handleSnapshots>false</handleSnapshots>
</localRepository>
</localRepositories>
<remoteRepositories>
<remoteRepository>
<key>ibiblio</key>
<handleReleases>true</handleReleases>
<handleSnapshots>false</handleSnapshots>
<excludesPattern>org/artifactory/**,org/jfrog/**</excludesPattern>
<url>http://repo1.maven.org/maven2</url>
</remoteRepository>
</remoteRepositories>
</config>
Artifactory 사용하기



앞의 설정은 라이브러리를 3가지 용도로 나뉘어 관리하겠다는 것이다. 중앙 Maven
Repository의 Mirror 역할을 하게 될 Repository(ibiblio), 3rd party 라이브러리를 관리
하기 위한 Repository(3rd-party), 사내에서 개발되는 라이브러리를 관리하기 위한
Repository(private-internal-repository)로 나누고 있다. 물론 사내 정책에 따라 더 많은
Repository를 관리하는 것 또한 가능하다.
위와 같이 설정한 다음 Tomcat을 시작한 다음 Artifactory에 접근할 수 있다.
http://localhost:8080/artifactory로 접근하면 Artifactory 로그인 화면에 접근할 수 있다.
host파일에 서버명을 설정하여 사용할 수 있다.
repository. javajigi.net 127.0.0.1

Artifactory의 디폴트 사용자는 UserName : admin, Password : password
Artifactory 사용하기



Maven 빌드툴이 새로 설치한 Artifactory를 사용할 수 있도록 설정하는 것이다. 사내
Maven Repository를 사용하도록 설정하는 방법은 다음과 같다.
USER_HOME/.m2/settings.xml 파일을 다음과 같이 설정한다. 디폴트의 경우
C:\Documents and Settings\유저\.m2\settings.xml 파일을 다음과 같이 설정했다.
Artifactory의 디폴트 사용자는 UserName : admin, Password : password
<settings 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/settings-1.0.0.xsd">
<profiles>
<profile>
<id>dev</id>
<properties>
<tomcat6x.home>D:/Devs/Servers/Tomcat-6.0.14</tomcat6x.home>
</properties>
<repositories>
<repository>
<id>central</id>
<url>http://repository.javajigi.net:8080/artifactory/repo</url>
<snapshots><enabled>false</enabled></snapshots>
</repository>
<repository>
<id>snapshots</id>
<url>http://repository.javajigi.net:8080/artifactory/repo</url>
<releases><enabled>false</enabled><releases>
</repository>
</repositories>
<pluginRepositories>
<pluginRepository>
<id>central</id>
<url>http://repository.javajigi.net:8080/artifactory/repo</url>
<snapshots><enabled>false</enabled><snapshots>
</pluginRepository>
<pluginRepository>
<id>snapshots</id>
<url>http://repository.javajigi.net:8080/artifactory/repo</url>
<releases><enabled>false</enabled><releases>
</pluginRepository>
</pluginRepositories>
</profile>
</profiles>
</settings>
Artifactory 사용하기

위와 같이 설정한 다음 Maven 빌드툴을 실행해보자. Maven 중앙 Repository에서 다운
되는 모든 라이브러리가 Artifactory Repository에 다음과 같이 저장된다.
Artifactory에 라이브러리 배포하기



개발하고 있는 라이브러리를 사내 Maven Repository에 배포하여 관리할 필요가 있다.
프로젝트간의 Dependency를 관리하기 위하여 개발 라이브러리를 사내 Maven
Repository에 배포하고 사용할 수 있도록 개발 환경을 설정하는 것이 중요하다.
Artifactory에 라이브러리를 배포하는 방법은 Artifactory 관리툴을 이용하는 방법과
Maven 빌드툴을 이용하는 방법이 있다.
Artifactory 관리툴을 이용하는 방법은 간단하다. Artifactory 관리툴의 Deploy an
artifact를 이용하여 새로운 라이브러리를 배포할 수 있다. 배포할 라이브러리를 업로드
하면 다음과 같이 라이브러리에 대한 정보를 입력하는 것이 가능하다.
Artifactory에 라이브러리 배포하기


앞의 방법은 3rd party 라이브러리를 관리할 때 유용하게 사용할 수 있는 방법이다. 개
발하고 있는 라이브러리를 매번 이 방식으로 배포하기에는 적합하지 않다. 개발을 진행
하는 중에는 상당히 자주 배포할 필요가 있기 때문에 개발 환경에 바로 배포할 수 있어
야 한다. Maven 빌드툴은 deploy goal을 통하여 사내 Repository에 배포하는 것이 가
능하도록 지원한다.
로컬에 설치한 Artifactory에 개발 라이브러리를 배포하기 위해서 먼저
USER_HOME/.m2/settings.xml 파일에 다음과 같이 Artifactory 인증에 필요한 정보를
추가해야 한다.
<settings 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/settings-1.0.0.xsd">
<servers>
<server>
<id>organisation-internal</id>
<username>admin</username>
<password>password</password>
</server>
</servers>
<profiles>
....
</profiles>
</settings>

Artifactory에 로그인할 때 사용했던 username과 password를 이용하여 인증이 가능하
도록 설정한다.
Artifactory에 라이브러리 배포하기

다음은 개발 프로젝트의 pom.xml 파일에 다음과 같이 배포할 서버를 지정해야 한다.
<distributionManagement>
<repository>
<id>organisation-internal</id>
<name>MyCompany Repository</name>
<url>http://repository.javajigi.net:8080/artifactory/private-internal-repository</url>
</repository>
</distributionManagement>


위와 같이 설정한 다음 "mvn deploy"를 실행하면 로컬에 설치한 Artifactory에 개발 라
이브러리를 배포하는 것이 가능하다.
개발 라이브러리를 배포하면 다음과 같이 private-internal-repository에 배포되게 된다.
사내 Maven Repository의 구축 참조
Tomcat - Zero configuration
•
•
http://wiki.jfrog.org/confluence/display/RTF/Deploying+the+WAR+File
artifactory를 다운 받아 artifactory.war 를 tomcat의 webapps 폴더에 넣는다.
The $ARTIFCTORY_HOME Folder
•
•
•
zero configuration에서 아주 중요한 곳으로, artifactory 설정 등을 저장하는 폴더.
artifactory가 tomcat에서 처음 실행되면 $ARTIFACTORY_HOME 변수에 저장한다.
$ARTIFACTORY_HOME=${user.home}/.artifactory
$ARTIFACTORY_HOME 을 변경하려면
•
•
tomcat의 시작 인자에 -Dartifactory.home=$ARTIFACTORY_HOME 에 지정하거나,
$ARTIFACTORY_HOME 환경 변수를 설정한다.
특정 ARTIFACTORY_HOME에 수동 설치
•
•
•

$ARTIFACTORY_HOME 으로 지정한 폴더에 artifactory를 푼다.
이 곳에 $ARTIFACTORY_HOME/etc/artifactory.config.xml 가 존재하는 것으로 $ARTIFACTORY_HOME으로 인정
한다.
tomcat의 vm인자에 -Dartifactory.home=$ARTIFACTORY_HOME 에 지정. 혹은 tomcat 5.5 이후는
$TOMCAT_HOME/bin/setenv.sh의 JAVA_OPTS에 $ARTIFACTORY_HOME 을 지정하며 이전 버전은
$TOMCAT_HOME/bin/catalina.sh 에 지정
HTTPd 에 연동하기
•
•
Tomcat JK connector를 이용
JKMount /artifactory/* worker1
ajp connector 이용
#ProxyPreserveHost on
# Use with Tomcat with the AJP connector
#ProxyPass /artifactory/ ajp://localhost:8009/artifactory/
#ProxyPassReverse /artifactory/ ajp://localhost:8009/artifactory/
사내 Maven Repository의 구축 참조
Changing the Default Database
•
•
artifactory는 기본 derby database를 내장하여 production-level의 저장소를 위한 데이터를 관리할 수 있다.
http://wiki.jfrog.org/confluence/display/RTF/Changing+the+Default+Database
Once-and-Only-Once Identical Content Storage
•
•
•
동일한 파일( 사이즈, 이름, 체크섬)은 오로지 한 번만 저장되고 동일한 파일 저장 요구가 나타나면 메타데이터
에 링크한다.
$ARTIFACTORY_HOME/etc/artifactory.system.properties file:
artifactory.jcr.configDir=repo/[selected-storage-type]
위 경로는 $ARTIFACTORY_HOME/etc 아래 상대경로 혹은 절대경로로 repo.xml file 이 있는 디렉토리이
다.(which is a Jackrabbit configuration file)
Artifactory on MySQL
•
•
http://wiki.jfrog.org/confluence/display/RTF/Running+Artifactory+on+MySQL
$ARTIFACTORY_HOME/etc/artifactory.system.properties:
artifactory.jcr.configDir=repo/mysql
Note: this path is relative to $ARTIFACTORY_HOME/etc
$ARTIFACTORY_HOME/etc/repo/mysql/repo.xml - DB 연결 정보 수정.
특정 ARTIFACTORY_HOME에 수동 설치
•
•
•
$ARTIFACTORY_HOME 으로 지정한 폴더에 artifactory를 푼다.
이 곳에 $ARTIFACTORY_HOME/etc/artifactory.config.xml 가 존재하는 것으로 $ARTIFACTORY_HOME으로 인정
한다.
tomcat의 vm인자에 -Dartifactory.home=$ARTIFACTORY_HOME 에 지정. 혹은 tomcat 5.5 이후는
Appfuse 프로젝트 활용

Appfuse 프로젝트 소개
•

Appfuse가 지원하는 프레임워크
•
•
•
•


Appfuse는 다양한 프레임워크의 조합으로 프로젝트를 진행할 때 템플릿을 생성하기 위한 오픈 소스 프로젝트
이다. Appfuse를 이용하면 진행하는 프로젝트의 프레임워크 조합에 따라 샘플 프로젝트를 생성할 수 있다. 이
샘플 프로젝트를 기반으로 개발 환경을 구축하는 것이 가능하다.
JSF Basic
Spring MVC Basic
Struts 2 Basic
Tapestry Basic
위 예는 프리젠테이션 레이어를 담당하는 프레임워크들이다.
그외 Hibernate, IBatis등 다양한 프레임워크의 조합의 템플릿 프로젝트를 생성하는 것
이 가능하다.
Appfuse 프로젝트 생성
Appfuse는 각 프레임워크의 조합에 따라 각각 다른 archetype을 제공하며 Appfuse에
서 제공하는 archetype은 http://appfuse.org/display/APF/AppFuse+QuickStart 에서 확
인할 수 있다. 이번 예제에서는 Spring MVC Basic을 이용하도록 하겠다.
먼저 DOS Prompt에서 Appfuse 프로젝트를 생성하고자 하는 디렉토리로 이동한 다음
Spring MVC Basic archetype을 생성한다.


mvn archetype:create -DarchetypeGroupId=org.appfuse.archetypes -DarchetypeArtifactId=appfuse-basic-spring \
-DremoteRepositories=http://static.appfuse.org/releases -DarchetypeVersion=2.0 -DgroupId=net.javajigi.app \
-DartifactId=myappfuse

위와 같이 실행하면 Appfuse 디렉토리 하위에 myappfuse라는
디렉토리가 생기면서 템플릿 프로젝트가 생성된다. Maven 디
폴트 디렉토리 구조로 다음과 같이 생성된다.
Appfuse 프로젝트 생성
Maven archetype을 통하여 생성된 myappfuse 디렉토리 하위를 보면 pom.xml 파일이
생성되어 있는 것을 확인할 수 있다. Appfuse 예제를 테스트하기 위하여 데이터베이스
설정을 해야 한다. pom.xml 파일을 열어 자신의 데이터베이스 설정과 맞도록 수정해준
다. Mysql 데이터베이스를 사용하여 예제를 진행했다.

<dbunit.dataTypeFactoryName>
org.dbunit.dataset.datatype.DefaultDataTypeFactory
</dbunit.dataTypeFactoryName>
<dbunit.operation.type>CLEAN_INSERT</dbunit.operation.type>
<hibernate.dialect>org.hibernate.dialect.MySQLInnoDBDialect</hibernate.dialect>
<jdbc.groupId>mysql</jdbc.groupId>
<jdbc.artifactId>mysql-connector-java</jdbc.artifactId>
<jdbc.version>5.0.5</jdbc.version>
<jdbc.driverClassName>com.mysql.jdbc.Driver</jdbc.driverClassName>
<jdbc.url>
<![CDATA[jdbc:mysql://localhost/myappfuse?createDatabaseIfNotExist=true&amp;useUnicode=true&amp;characterEncoding
=utf-8]]>
</jdbc.url>
<jdbc.username>root</jdbc.username>
<jdbc.password>password</jdbc.password>


위 와 같이 데이터베이스 설정을 변경한 다음 myappfuse 디렉토리로 이동한 다음
mvn install eclipse:eclipse 명령을 실행하여 Eclipse 프로젝트를 생성한다. Eclipse 프
로젝트를 생성한 다음 Eclipse에서 import한다. mvn install eclipse:eclipse 명령을 실
행하면 관련 라이브러리를 다운받는데 많은 시간이 소요된다.
mvn install eclipse:eclipse를 실행하면 Maven 기반의 프로젝트를 Eclipse 프로젝트로
변환할 뿐만 아니라 빌드까지 진행하게 된다. 생성한 myappfuse 프로젝트는 WTP 기
반의 프로젝트로 생성된다.
Appfuse 프로젝트 테스트
생성한 myappfuse 프로젝트를 Eclipse에서 import한다.

appfuse를 WTP와 연동하기 위해서는 추가적인 설정이
필요하다. 기본적으로 Maven 기반의 프로젝트를 Eclipse
로 변경할 경우 특별한 추가 설정이 필요없다. 그러나
appfuse는 Common 프로젝트와 이 프로젝트와 의존관
계에 있는 프로젝트로 분리되어 있기 때문에 추가적인
설정이 필요하다.
생성한 myappfuse 프로젝트의 pom.xml 파일을 열어보
면 다음과 같이 war 파일과 의존관계를 가지는 것을 알
수 있다.


<dependency>
<groupId>org.appfuse</groupId>
<artifactId>appfuse-${web.framework}</artifactId>
<version>${appfuse.version}</version>
<type>war</type>
</dependency>

Maven의 경우 war 파일과 의존관계에 있을 경우 빌드
시 war 파일을 다운받아 빌드 디렉토리에 압축을 풀어
같이 배포할 수 있도록 지원한다. appfuse 프로젝트를
생성하면 webapp 디렉토리는 다음 그림과 같다.
Appfuse 프로젝트 테스트



그러나 Maven을 이용하여 빌드를 하면 target 디렉토리가
다음과 같이 구성되는 것을 확인할 수 있다.
디폴트 Eclipse 플러그인은 src/main/webapp를 디폴트 웹
리소스 디렉토리로 인식한다. 그러나 빌드 후 Common war
파일이 target 디렉토리에 배포되기 때문에 WTP 설정 파일
을 다음과 같이 변경해야 된다.
.settings 디렉토리 아래의
org.eclipse.wst.common.component 파일을 연다.
<wb-resource deploy-path="/" source-path="src/main/webapp"/>
삭제
<wb-resource deploy-path="/" source-path="target/myappfuse1.0-SNAPSHOT"/> 추가
<wb-resource deploy-path="/WEB-INF/classes" sourcepath="src/main/resources"/> 삭제
Appfuse 프로젝트 테스트
다음은 myappfuse 프로젝트를 Tomcat 서버에 배포하여 테스트를 진행하는 과정을 보자.
Preferences -> Java -> Installed JREs로 이동하여 JDK를 추가한다. 디폴트는 JRE가 설정
되어 있을 것이다. JRE가 아니라 JDK를 추가한다.
Appfuse 프로젝트 테스트
JDK를 설정한 다음 Tomcat 서버를 추가해야 한다.
Preferences -> Server -> Installed Runtimes: Apache -> Tomcat 5.5 server를 선택하여
로컬에 설치한 Tomcat 5.5를 추가한다. Tomcat 5.5를 추가할 때 앞에서 추가한 JDK
5.0을 사용하도록 한다.
Window -> Show View -> Other -> Server -> Servers로 이동한 다음 새로운 서버를 추
가한다. 오른쪽 클릭 New -> Server
Appfuse 프로젝트 테스트
앞의 myappfuse 프로젝트를 WTP 기반 프로젝트로 설정되어 있기 때문에 서버를 추가할
때 배포하도록 설정하는 것이 가능하다. 추가한 서버를 시작한다.
서버를 시작한 다음 http://localhost:8080/myappfuse로 접근하면 다음과 같은 로그인 화
면을 볼 수 있다면 appfuse에 대한 설정이 성공한 것이다.
admin/admin으로 로그인하면 Appfuse의 기능을 확인할 수 있다.

similar documents