'52.Apache Project &amp;.../Jakarta Ant' 카테고리의 글 목록

'52.Apache Project &.../Jakarta Ant'에 해당되는 글 3건

52.Apache Project &.../Jakarta Ant2009. 8. 25. 17:36

아파치 앤트용 외부 자료의 목록

출처 : http://www.apache-korea.org/ant/external.html
외부의 도구과 태스크

이 페이지는, 아파치 앤트용 외부 자료의 목록입니다: 태스크, IDE 통합 도구, 로거 입니다. 앤트에 포함되었으면 하는 것을 작성하였다면, 메일 목록 중 하나에다가 관련 정보를 보내주세요.

여기 나오는 것은, 모두 앤트 개발자들이 직접 지원하고 있는 것이 아닙니다. 무엇인가 문제가 발생할 경우에는, 연락처의 정보를 이용해 주세요.

태스크

AJC

AspectJ 는 자바의 형태를 지향하는 확장모델입니다. 이 태스크는 AspectJ 컴파일러 -- AJC 를 사용하여 소스 트리를 컴파일합니다.

적합한 버전: 앤트 1.3

URL: http://aspectj.org/dl

연락처: support@aspectj.org

라이센스: Apache Software 라이센스

Anakia

확실히, Anakia 는, JDOM, Velocity 와 앤트에 기반을 둔 XML 변환도구로, 앤트 태스크보다 더 좋습니다.

적합한 버전: 앤트 1.2 이상

URL: http://jakarta.apache.org/velocity/anakia.html

연락처: Velocity mailing lists

라이센스: Apache Software 라이센스

Anteater

Anteater 는 웹사이트와 웹서비스를 기능면에서 테스트(기능면에서 테스트하는 것이란; URL에 접속하여 올바른 반응이 돌아오는지 점검한다)하는 앤트 태스크의 집합입니다. HTTP params, response codes, XPath, regexp 과 Relax NG 표현들을 테스트할 수 있습니다. HTML 보고서(junitreport에 기반을 둔)와, 대량의 테스트 스크립트를 재빨리 처리하기 위한 계층적인 그룹 체계를 제공합니다.

적합한 버전: 앤트 1.5 이상

URL: http://aft.sourceforge.net

연락처: developer mailing list

라이센스: Apache Software 라이센스

Checkstyle

Checkstyle 은 일반적인 코딩을 덧붙여, 자바 코드를 작성하는 프로그래머를 도와주는 개발 도구입니다. 이것은, 자바 코드를 점검하는 과정을 자동화하고, 따분한(하지만 중요한) 태스크를 사람이 편하게 다룰 수 있도록 하는 것이 목적입니다.

Checkstyle 은 앤트 태스크나 커맨드 라인 유틸리티를 통해 사용할수 있습니다.

적합한 버전: 앤트 1.2부터 1.4.1까지

URL: http://checkstyle.sourceforge.net/

연락처: Oliver Burn

라이센스: 2.0 배포시에는 GNU Lesser General Public 라이센스. 이전의 배포판은 GNU General Public 라이센스입니다.

CleanImports

필요없는 import들을 제거합니다. import 부분의 체계를 다시 잡습니다. 분명치 않은 import 들은 표시를 해둡니다.

적합한 버전: 앤트 1.3

URL: http://www.euronet.nl/users/tomb/cleanImports/index.html

연락처: Tom Brus

라이센스: Apache Software 라이센스

Clover

Clover 는 앤트-기반의 코드 보호 도구입니다. 이것은, 앤트-기반의 프로젝트로 잘 사용되고 있습니다. 이것은, 메소드, 문장, 그리고 브렌치(branch)보호 분석기 를 제공하고, XML, HTML 이나 Swing GUI 를 통한 보고서 기능를 가지고 있습니다.

적합한 버전: 앤트 1.4.1 이상

URL: http://www.thecortex.net/clover

연락처: clover-support@cortexebusiness.com.au

라이센스: 상업용, 오픈 소스 프로젝트로는 무료(free) 라이센스가 가능합니다.

Configure

소스와 출력을 분리시켜, 반복되는 빌드기능(모든 패키지 등급에 대해서 앤트를 호출하고, 그 패키지에 있는 파일만 빌드하거나, 그 패키지 하위의 모든 것을 빌드합니다)을 제공합니다.

이 태스크는 임의의 하위디렉토리(CVS-디렉토리를 제외하고)에 빌드 파일을 생성합니다. 최상위에 build.xml 파일 하나만 위치시키고, 'setup' 이나 'rescan' 타겟을 호출합니다.

적합한 버전: 앤트 1.2 과 1.3

URL: http://www.dsdelft.nl/~lemval/ant/

연락처: M.J.P. van Leeuwen

라이센스: Apache Software 라이센스에서 유래된 라이센스

CVSGrab

방화벽 아래의 지역에서 cvs 로 의사소통을 할 때, 유용하게 사용할 수 있는 작은 CVS client 입니다. 이것은, 표준 http 을 통해 CVS 저장소에 접근하는 ViewCVS 웹 인터페이스를 사용하고, 그 곳에 존재하는 모든 파일을 내려받기합니다.

커맨트 라인이나 앤트 태스크로 작동합니다.

적합한 버전: 앤트 1.3 이상

URL: http://cvsgrab.sourceforge.net/

연락처: CVSGrab user mailing list

라이센스: LGPL

Doxygen task

Doxygen 문서 체계를 작동하기 위한 2가지의 앤트 태스크가 있습니다.

적합한 버전: 앤트 1.1 이상

URL: http://www.bgw.org/projects/java/ant/

연락처: Kyle R. Burton

라이센스: Apache Software Foundation 라이센스

그리고

적합한 버전: 앤트 1.5 이상

URL: http://ant-doxygen.sourceforge.net

연락처: Karthik A Kumar

라이센스: Apache Software Foundation 라이센스

GenJar

단순한 디렉토리의 내용보다 좀 더 의존관계가 있는 클래스에 기반을 둔, JAR파일을 빌드합니다.

적합한 버전: 앤트 1.4 알파 (2001/08/04 후에 빌드된) 이상

URL: http://genjar.sourceforge.net/

연락처: Jesse Stockall

라이센스: Apache Software Foundation 라이센스

Importscrubber

자바 소스 코드 파일에서 불필요한 import 문장을 제거합니다.

적합한 버전: 앤트 1.3

URL: http://importscrubber.sourceforge.net/

연락처: Tom Copeland

라이센스: LGPL

IsDirValidator

주어진 디렉토리 구조가, 태스크의 내부 요소를 거쳐 정의된 특정한 법칙에 따르는지 검사합니다.

적합한 버전: 앤트 1.4

URL: http://isvalidator.sourceforge.net/en/isDirValidator.htm

연락처: I?igo Serrano

라이센스: GNU General Public 라이센스

Jalopy

낡은 자바 소스 코드 형식을 위한 앤트 플러그-인 입니다.

적합한 버전: 앤트 1.4 (또는 이상)

URL: http://jalopy.sourceforge.net

연락처: http://jalopy.sf.net/contact.html

라이센스: 1.0 베타 6 배포시에는 BSD 라이센스. 이전의 배포판은 GNU General Public 라이센스입니다.

Javamake

자바 소스를 컴파일하고 클래스 파일의 의존관계를 관리하는 태스크입니다. 기능적으로는, 평범한 Javac 와 의존하는 태스크를 합쳐 놓은 기능과, 향상된 의존관계 체크기능을 가지고 있습니다.

적합한 버전: 앤트 1.4.1

URL: http://www.experimentalstuff.com/Technologies/JavaMake/index.html

연락처: Mikhail Dmitriev

라이센스: BSD와 유사한 라이센스

J2ME Ant Tasks

Java 2 Platform, Micro Edition (J2ME) 애플리케이션의 빌드를 도와주는 2가지의 다른 태스크 집합입니다.

이 집합은 CLDC 와 K Virtual Machine (KVM)을 지원합니다:

적합한 버전: 앤트 1.3

URL: http://www.dribin.org/dave/j2me_ant/

연락처: Dave Dribin

라이센스: Apache Software 라이센스

그리고 이 집합은 J2ME Wireless Toolkit 과 PalmOS의 MIDP에서 작동합니다:

적합한 버전: 앤트 1.3

URL: http://www.stampysoft.com/ant/

연락처: Josh Eckels

라이센스: MIT 라이센스

javarec

코볼(cobol) 복사 도서의 자바를 위한 VisualAge에게, 기록(record) 클래스들을 생성하는 앤트 태스크입니다.

적합한 버전: 앤트 1.4

URL: http://glezen.org/javarec/

연락처: Paul Glezen

라이센스: Apache Software 라이센스

Jing Task

XML 파일을 RELAX NG 와 XML Schema로 둘로 나누어 구분합니다. 앤트의 Jing task 는, 여러 파일에서 여러 RELAX NG 패턴을 효과적으로 구분하는 것을 허락하고, 다른 XML 처리법을 가지고 RELAX NG 구분자를 통합시킵니다.

적합한 버전: 앤트 1.4 이상

URL: http://www.thaiopensource.com/relaxng/jing-ant.html

라이센스: BSD와 유사한

jMetra

jMetra 는, 프로젝트의 생명주기를 측정한 코드를 수집하고, 초과시간을 측정하는 프로젝트를 분석한 JavaDoc-형식의 문서 결과를 컴파일하는 도구입니다. jMetra 는 프로젝트의 빌드 처리를 계획을 통합하는 최고의 유틸리티입니다.

이것은, 커맨트라인이나 제공된 여러 앤트 태스크를 사용하여 작동합니다.

적합한 버전: 앤트 1.4 이상

URL: http://www.jmetra.com/

연락처: R Todd Newton

라이센스: 상업용, 오픈 소스 프로젝트나 개발용으로는 무료(free) 라이센스가 가능합니다

JNI

JNI 는, Java Native Interface (JNI)를 통해 자바와 C 를 통합하는 일을 쉽게 만드는, 무료 도구모음입니다. 이것은, 자바 "proxy" 클래스로 C "peer" 클래스에 접근하고, C "proxy" 클래스로 자바 "peer" 클래스나 인터페이스에 접근하도록 양쪽 모두를 생성하는 코드생성기를 포함하고 있습니다. 이것은 또한, JNI 데이터 형을 쉽게 작동할 수 있게 하는, "helper" 클래스와 같은 단순화된 JVM 인터페이스의 코어(core) 라이브러리도 포함하고 있습니다. 코드 생성기는, GUI 프로젝트 매니저의 보조로 생성할 수 있는 XML 프로젝트 파일로 운영됩니다. 코드 생성기는 앤트나 GUI 로 작동할 수 있습니다. 인쇄가능한 많은 PDF 사용자 가이드와 많은 수의 예제를 포함하고 있습니다.

적합한 버전: 앤트 1.4

URL: http://jnipp.sf.net/

연락처: Phillip E. Trewhella

라이센스: GNU LGPL

Macker

빌드-시간 을 체계적으로 테스트하는 도구로서, 깔끔한 layering / tiering / modularity 으로 설계되었습니다. Macker 는 컴파일된 클래스 파일들에 대하여, XML 규칙(rules) 파일에서 당신의 프로젝트를 지정한 패턴-기반의 접근 규칙의 집합에 관한, 클래스들의 의존관계를 검사합니다.

적합한 버전: 앤트 1.5 이상 (1.4 는 테스트되지 않았지만 작동할 것입니다.)

URL: http://innig.net/macker/

연락처: Paul Cantrell

라이센스: GNU GPL 2.0

PMD

PMD 는 사용되지 않는 변수, 필요없는 오브젝트 생성, 등을 자바 소스에서 검사합니다.

적합한 버전: 앤트 1.4 이상

URL: http://pmd.sf.net/

연락처: Tom Copeland

라이센스: Apache Software Foundation 라이센스

Styler

styler 태스크는, 지정한 앤트 빌드 파일을, 간단하게 유용한 XSLT 변형물(transformation)의 결합으로 만듭니다. 내장 앤트 태스크 스타일 같은 것들을, styler 는 하나의 XML 파일 집합의 변형물로 만들수 있습니다. 또한 다음과 같은 것들을 할수 있습니다:

parallel 과 pipeline 에서, 복수의 변형물을 취급합니다.

분할 / 결합 파일들을 변형물로 만들 수 있습니다.

XML 파일이 아닌 것들을 처리합니다, 특히 HTML (JTidy 에 기반함)

XSLT 변형물이 아닌 것을 적용합니다, 특히 "평범한 fragmentations"

새로운 파일 포맷과 변형물 기술을 취급하는, 사용자정의 XMLReader 나 XMLFilter 를 사용합니다.

적합한 버전: 앤트 1.4

URL: http://www.langdale.com.au/styler/

연락처: Arnold deVos

라이센스: LGPL

Tidy Imports (Tim)

Tim 은 import 선언문을 자동적으로 구성해 주는, 커맨드 라인이나 앤트를 거쳐 실행될 수 있는 유틸리티입니다. Tim 은, 사용되지 않는 import를 제거하고, import 를 늘리거나 합치고, 그것들을 미리-결정된(pre-determined) 그룹에 조직화 시킬 수 있습니다.

적합한 버전: 앤트 1.3 이상

URL: http://www.chive.com/tim.htm

연락처: support@chive.com

라이센스: 상업용

TiniAnt

TiniAnt 는, TINI를 위한 애플리케이션을 빌드하는 방법을 지원하는 앤트 태스크입니다.

적합한 버전: 앤트 1.2부터 1.4.1까지

URL: http://tiniant.sourceforge.net/

연락처: Sean Kelly

라이센스: BSD와 유사한 라이센스

Venus Application Publisher's (Vamp) Ant Task Suite

웹 서버를 한 번의 클릭으로 Java Web Start 를 가동시키고, 하나의 Java Archive installer로, 내장, 다중-쓰레드, 가벼운 웹서버에 대한 내용으로 서버를 업데이트 시키는 기능의, Web Archive 들을 당신의 애플리케이션에 표시하고 패키지할 수 있도록 지원합니다.

적합한 버전: 앤트 1.2 과 1.3

URL: http://www.geocities.com/vamp201/ant.html

연락처: Gerald Bauer

라이센스: GNU General Public 라이센스

WOProject

WOProject 는, 플랫폼과 IDE에 독립적인 WebObjects 5.1 과 함께 작동하는 도구 모음을 제공합니다. 이것의 주요 기능은, 개발자의 생산성을 증가시키고, 전통적인 Makefile-기반의 접근법(approach)와 비교하여 복잡한 프로젝트 구조를 좀 더 유연하게 만드는 것입니다.

적합한 버전: 앤트 1.4

URL: http://objectstyle.org/woproject/

연락처: Andrus Adamchik

라이센스: Apache 라이센스

XDoclet

XDoclet 은 Javadoc Doclet 엔진을 앤트에서 사용하기 위해서, Javadoc Doclet 엔진을 확장시킵니다. 이것은, 사용자정의 Javadoc @tags 를 작성하고, 그 tags에 기반하여 소스 코드나 다른 파일들을 생성합니다(xml틱한 배치(deployment ) 설명자같은 것들). 템플릿과 적합한 태스크들은, EJB 과 웹 애플리케이션 배치 설명자를 생성하는 것을 제공합니다.

적합한 버전: 앤트 1.4

URL: http://sourceforge.net/projects/xdoclet/

라이센스: BSD 라이센스

XmlTask

XmlTask 는, XSLT를 배울 필요없이 XML 문서를 수정하는 단순한 방법을 제공합니다. 경로는 단순하게 변경하길 원하는 노드(node)를 지정한 XML 노드를 참조하고, XML 삽입이나 제거, 또는 속성 변경을 허락하는 방법을 당신에게 알려줍니다. 강조합니다만, 이것은 일반적인 XML 변경을 수행하는 지극히 단순한 방법을 제공합니다.

적합한 버전: 앤트 1.4 이상

URL: http://www.oopsconsultancy.com/software/xmltask.html

연락처: xmltask@oopsconsultancy.com

라이센스: GNU General Public 라이센스

컴파일러 계승체(Implementations)

miniRMI <rmic> implementation

miniRMI 는, java.rmi 원본 패키지를 경량으로 대체하는, 특히 애플릿에 적합한 무료 공개소스 라이브러리입니다. 앤트 1.4+ <rmic> 어댑터에 포함되어 있습니다.

적합한 버전: 앤트 1.4 이상

URL: http://dione.zcu.cz/~toman40/miniRMI/

연락처: Petr Toman

라이센스: Gnu Lesser Public 라이센스

IDE 나 에디터와의 통합

AntFarm

jEdit 에디터에 앤트를 통합시키는 플러그인입니다.

적합한 버전: 앤트 1.3 때 나옴

URL: http://plugins.jedit.org/plugins/AntFarm

연락처: jEdit developers mailinglist

라이센스: Apache Software 라이센스

AntMan

JDeveloper IDE와 앤트를 통합시키는 AddIn 입니다.

적합한 버전: 앤트 1.4.1

URL: http://www.erudra.com/antman/index.html

연락처: Ashok Sridhar

라이센스: GNU General Public 라이센스

AntRunner

JBuilder IDE에 앤트를 통합시키는 공개도구입니다.

적합한 버전: 앤트 1.2 과 1.3

URL: http://www.dieter-bogdoll.de/java/AntRunner/

연락처: Dieter Bogdoll

라이센스: GNU General Public 라이센스

AntWork

Jext 에디터에 앤트를 통합시키는 플러그인입니다.

적합한 버전: 앤트 1.2 과 1.3

URL: ftp://jext.sourceforge.net/pub/jext/plugins/AntWork.zip

연락처: Klaus Hartlage

라이센스: GNU General Public 라이센스

Eclipse

Eclipse 는 앤트와 통합한 세계적인 도구 플랫폼입니다.

적합한 버전: 앤트 1.3 - 1.4.1

URL: http://www.eclipse.org

연락처: news://news.eclipse.org/eclipse.tools

라이센스: Common Public 라이센스 버전 1.0

IntelliJ IDEA 2.0

Java IDE 는 리팩토링(refactoring) 지원과 앤트 통합기능을 가지고 있습니다.

적합한 버전: Ant 1.3 때 나옴

URL: http://www.intellij.com/idea/

연락처: support@intellij.com

라이센스: 상업용

JDE(E) 2.2.8

Emac 을 위한 자바 개발 환경(JDEE)은 애플리케이션을 빌드하기 위한 세가지 내장 방법 중 하나로 아파치 앤트를 지원합니다.

적합한 버전: 앤트 1.2 이상

URL: http://jde.sunsite.dk/

연락처: JDEE Mailing list.

라이센스: GNU General Public 라이센스

NetBeans / Sun ONE Studio

NetBeans 나 Sun ONE Studio (이전에는 Forte for Java) IDE 에 앤트를 통합하는 모듈입니다.

적합한 버전: Ant 1.4.1 때 나옴

URL: http://ant.netbeans.org/

연락처: nbdev@netbeans.org

라이센스: Sun Public 라이센스

HP RadPak

RadPak 는 (무료) HP Bluestone HPAS J2EE 서버에서, 자바 웹과 EJB애플리케이션을 WAR나 EAR파일들처럼 패키지화하고 배치시키는 것을 주목적으로하는 GUI 도구입니다. 이 도구는 앤트 기반으로, 보통 앤트의 개발, 태스크 속성의 입력(entry)을 형식에 맞추기, 태스크가 실행되는 모습을 애니메이션화하여 보여주기 를, GUI 처럼 사용할 수 있습니다.

적합한 버전: 앤트 1.3 과 docs 때 나옴; 앤트가 설치된 ANT_HOME 아래에 부가적인 태스크들의 jar를 추가하세요.

URL: http://www.bluestone.com/products/hp-as/

라이센스: 특허가 있음, 그러나 내려받기는 무료

WebSphere Studio Application Developer

WSAD 는, Eclipse 도구 플랫폼상에서 빌드하는 능력으로 앤트와 통합하는 기능입니다.

적합한 버전: 앤트 1.4.1 때 나옴

기사: Ant Integration Part1

라이센스:

Posted by 1010

52.Apache Project &.../Jakarta Ant2008. 8. 19. 16:34

Jakarta Ant II탄 상세편

Jakarta Ant

-. 이번 강좌에서는 지난 시간에 이어 ant 사용에 필수적인 task들에 대해 알아보고

예제를 통해 한번더 알아보도록 하겠습니다.

만약 지난 강좌를 아직 보지 않았다면 다음 링크를 참조하세요

http://www.jakartaproject.com/article/jakarta/1114617006525

I. 집합 태그

1. <fileset>

①개요

-. fileset이란 말 그대로 파일의 집합을 말하며 특정 태스크에서 파일을 포함하여야 할때

손쉽게 특정 파일이나 집합을 지정해 주는데 사용된다

주로 클래스패스나, 압축, 파일 카피등의 task에서 사용되어진다

②예제

사용예제-1


<fileset dir="${server.src}" casesensitive="yes">
  <include name="**/*.java"/>
  <exclude name="**/*Test*"/>
</fileset>

<fileset dir="${server.src}" casesensitive="yes">
  <filename name="**/*.java"/>
  <filename name="**/*Test*" negate="true"/>
</fileset>

<fileset dir="${server.src}" casesensitive="yes">
  <filename name="**/*.java"/>
  <not>
    <filename name="**/*Test*"/>
  </not>
</fileset>

모든 디렉토리의 java파일을 포함시키면서 파일이름중 Test가 들어가는 파일은 제외하는 fileset을 나타낸다

위 세가지 fileset은 같은 의미이다

사용예제-2


<fileset dir="${server.src}" casesensitive="yes">
  <include name="**/*.java, **/*.properties"/>
</fileset>

<fileset dir="${server.src}" casesensitive="yes">
  <include name="**/*.java"/>
  <include name="**/*.properties"/>
</fileset>

","를 사용하여 나타낼 수도 있고 다로 분리하여 tag를 사용할 수도 있다

위 두 fileset은 같은 의미이다

③ 속성

속성	설명	필수여부
dir	파일집합의 최상위 디렉토리 (루트 디렉토리)	dir나 file둘중 하나는 필수
file	특정 하나의 파일을 지정할때 사용	dir나 file둘중 하나는 필수
defaultexcludes	default excludes 에 명시된 파일 및 디렉토리를 자동적으로 제외하는 속성이며 이기능을 사용하려면 생략한다. 혹은 yes/no 로 값을 준다	No
includes	컴마나 스페이스로 구분된 파일의 패턴을 포함하는 속성이며 모든 파일을 사용하려면 생략한다	No
includesfile	특정 각각의 파일을 포함할때 사용하는 속성	No
excludes	컴마나 스페이스로 구분된 파일의 패턴을 제외하는 속성이며 생략하면 default excludes를 제외하고 어떠한 파일도 제외하지 않는다	No
excludesfile	특정 각각의 파일을 제외할때 사용하는 속성	No
casesensitive	패턴의 대소문자를 구분할지 여부를 나타내는 속성으로 기본값은 true이다	No
followsymlinks	symbolic links를 허용할지 여부를 나타내며 기본값은 true이다	No

default excludes

excludes를 사용하지 않아도 기본적으로 제외되는 파일 및 디렉토리

   **/*~
   **/#*#
**/.#*
   **/%*%
   **/._*
   **/CVS
   **/CVS/**
   **/.cvsignore
   **/SCCS
   **/SCCS/**
   **/vssver.scc
   **/.svn
   **/.svn/**
   **/.DS_Store

자 이정도면 fileset은 이제 빠~삭해 지셨겠죠?

2. <dirset>

① 개요

-. fileset이 파일 집합을 나타냈다면 dirset task는 디렉토리의 집합을 나타낸다. 기본적인 속성은 fileset과 동일하다

차이점은 defaultexcludes가 없다

② 사용예제


<dirset dir="${build.dir}">
  <include name="apps/**/classes"/>
  <exclude name="apps/**/*Test*"/>
</dirset>

apps 이하 디렉토리중 classes 디렉토리를 포함하고 apps 이하 디렉토리중 디렉토리 이름중 Test가 들어가는 디렉토리는 제외한 dirset을 의미한다

③ 속성

속성	설명	필수여부
dir	파일집합의 최상위 디렉토리 (루트 디렉토리)	YES
includes	컴마나 스페이스로 구분된 디렉토리의 패턴을 포함하는 속성이며 모든 파일을 사용하려면 생략한다	No
includesfile	특정 각각의 디렉토리를 포함할때 사용하는 속성	No
excludes	컴마나 스페이스로 구분된 디렉토리의 패턴을 제외하는 속성이며 생략하면 어떠한 디렉토리도 제외하지 않는다	No
excludesfile	특정 각각의 디렉토리를 제외할때 사용하는 속성	No
casesensitive	패턴의 대소문자를 구분할지 여부를 나타내는 속성으로 기본값은 true이다	No
followsymlinks	symbolic links를 허용할지 여부를 나타내며 기본값은 true이다	No

3. <patternset>

① 개요

-. 여러 파일이나 디렉토리를 미리 그룹핑해 놓고 이를 특정 아이디를 통해 사용하는 방식을 제공한다. 즉 워드의 매크로 같은 기능이라 보면 쉽게 이해가 갑니다

② 사용예제

<patternset id="non.test.sources">
  <include name="**/*.java"/>
  <exclude name="**/*Test*"/>
</patternset>
...
<fileset dir="${server.src}">
  <patternset refid="non.test.sources"/>
</fileset>
...
<fileset dir="${server.src}">
  <patternset refid="non.test.sources">
    <include name="**/*.java"/>
  </patternset>

</fileset>

예제를 보는바와 같이 patternset은 여러곳에서 동일한 패턴을 사용할때 이를 미리 정의해 놓고 지정한 id의 값을 refid를 통해 재사용 할 수 있다

paternset을 사용하면 코딩양을 줄일 수 있고 변동사항이 있으면 손쉽게 변동 할 수 있다는 점이다

③ 속성

속성	설명	필수여부
includes	컴마나 스페이스로 구분된 디렉토리의 패턴을 포함하는 속성이며 모든 파일을 사용하려면 생략한다	No
includesfile	특정 각각의 디렉토리를 포함할때 사용하는 속성	No
excludes	컴마나 스페이스로 구분된 디렉토리의 패턴을 제외하는 속성이며 생략하면 어떠한 디렉토리도 제외하지 않는다	No
excludesfile	특정 각각의 디렉토리를 제외할때 사용하는 속성	No

4. <path>

① 개요

-. 파일과 디렉토리를 함께 나타낼 수 있는 집합. 클래스패스에는 경로뿐만 아니라 *.jar 같은 파일이 같이 사용되듯이 이 path task는 주로 클래스패스로 자주 이용된다

fileset, dirset과 비슷하지만 파일과 디렉토리를 함께 나타낼 수 있다는 점에서 틀리다

path tag역시 patternset과 같이 지정된 id 값을 이용하여 여러 곳에서 재사용 할 수 있다.

② 사용예제

아래 예제는 ${basedir}/lib/struts.jar, ${base.dir}/lib/log4j.jar 그리고 ${base.dir}/classes 에 클래스패스를 잡는 예제이다.

<path id="base.path">
  <pathelement path="lib/struts.jar;lib/log4j.jar"/>
  <pathelement location="classes"/>
</path>
...
<classpath refid="base.path"/>
...

path에 대한 정의를 해놓고 base.path라는 아이디를 이용하여 여러 곳에서 사용할 수 있다

location 속성은 single 파일이나 탐색할 하나의 디렉토리만을 설정할수 있는 반면에,

path는 ";"나 ":"를 사용하여 여러 파일들이나 디렉토리를 설정할 수 있다

II. 파일 태그

1. <copy>

① 개요

-. 소스 파일을 타겟으로 파일을 복사하는데 사용한다

② 사용예제

파일 하나 복사

파일 하나를 디렉토리에 복사

디렉토리를 다른 디렉토리로 복사

파일 집합을 디렉토리에 복사

파일 집합을 디렉토리에 복사하며 파일명 끝에 .bak을 추가하여 복사

파일집합을 디렉토리에 복사하며 파일집합중 TITLE 이란 STRING을 Foo Bar로 대체하며 복사

③ 속성

속성	설명	필수여부
file	복사할 파일	fileset tag를 사용하지 않는다면 필수
preservelastmodified	소스와 타겟의 최종 수정날짜 파일을 유지하며 복사한다 기본값은 false	No
tofile	복사할 소스파일	fileset tag와 함께 소스 및 타겟을 지정할수있다
todir	복사할 소스 디렉토리	fileset tag와 함께 소스 및 타겟을 지정할수있다
overwrite	타겟의 파일이 최근의 파일이라도 덮어쓸지 여부를 나타내며 기본값은 false	No
filtering	복사하는동안 filter를 사용할것인지 여부를 나타내며 기본값은 false 단 이 값이 false일지라도 nested 하게 <filterset>을 사용할수 있다	No
flatten	소스 디렉토리의 구조를 무시하고 특정 디렉토리 한곳에 모든 파일을 복사할지 여부를 나타내며 기본값은 false	No
includeEmptyDirs	<fileset>을 지정하여 복사될 디렉토리중에 파일이 없는 비어있는 디렉토리까지 복사할지 여부를 나타내며 기본값을 true	No
failonerror	복사중 에러가 발생할때 false이면 warning 메세지 로그를, 그렇지 않으면 build시 중지한다 기본값은 true	No
verbose	복사되고 있는 파일의 로그 여부를 나타내며 기본값은 false	No
encoding	필터 복사중 사용할 encoding을 나타내며 기본값은 JVM 기본 encoding을 따른다 (ant 1.5 이후)	No
outputencoding	파일기록에 사용할 encoding을 나타낸다 (ant 1.6이후)	No
enablemultiplemappings	true면 주어진 소스 path에대해 모든 mapping 처리를 하며 false이면 첫번째 파일이나 디렉토리에 대해서만 mapping 처리를 한다 이 속성은 <mapper> subelement가 있을때만 관련있다 기본값은 false (ant 1.6이후)	No
granularity	최근 수정된 시간을 기준으로 파일을 비교 복사시 기준이 되는 시간으로부터 여유분 시간을 나타낸다 즉 소스 파일 서버와 타겟 파일 서버가 다른경우 두 머신간에 시간차이가 있을 수 있기 때문에 이를 사용한다 (ant 1.6.2 이후)

2. <delete>

① 개요

-. 하나의 파일, 하나의 디렉토리 혹은 fileset으로 지정한 특정한 파일들을 삭제할수 있다

② 사용예제

하나의 파일을 삭제
<delete file="/lib/ant.jar"/>

하나의 디렉토리를 삭제 (이하 디렉토리 및 파일 모두 삭제됨)
<delete dir="lib"/>

현재 디렉토리로 부터 모든 파일중 .bak 파일은 모두 삭제
<delete>
<fileset dir="." includes="**/*.bak"/>
</delete>

하나의 디렉토리를 삭제하며 빈 디렉토리라도 모두 삭제 (build 자신의 디렉토리도 삭제)
<delete includeEmptyDirs="true">
<fileset dir="build"/>
</delete>

build 이하 모든 파일을 삭제하며 빈 디렉토리라도 모두 삭제 (build 자신의 디렉토리는 삭제되지 않음)
<delete includeemptydirs="true">
<fileset dir="build" includes="**/*"/>
</delete>

③ 속성

속성	설명	필수사항
file	삭제할 파일 (상대경로나 절대경로나 상관없음)	<fileset>을 사용하지 않는다면 file혹은 dir둘중 하나는 사용하여야 한다
dir	삭제할 디렉토리	<fileset>을 사용하지 않는다면 file혹은 dir둘중 하나는 사용하여야 한다
verbose	각 삭제되는 파일의 이름을 보져줄 것인지 여부를 나타내며 기본값은 false	No
quiet	시스템이 사용하고 있어 삭제할수 없는 파일이거나 존재하지 않는 파일, 디렉토리등의 메세지를 나태낼지 여부를 나타내며 기본값은 false	No
failonerror	파일 삭제시 에러가 발생하면 build를 중단 하고 현재 사항을 레포팅해줄지 여부를 나타내며 기본값은 true	No
includeemptydirs	fileset을 사용할 때 빈 디렉토리empty directory)를 삭제할 것인지 여부를 나타내며 기본값은 false	No
includes	Deprecated. Use `<fileset>`.	No
includesfile	Deprecated. Use `<fileset>`.	No
excludes	Deprecated. Use `<fileset>`.	No
excludesfile	Deprecated. Use `<fileset>`.	No
defaultexcludes	Deprecated. Use `<fileset>`. 기본값은 true	No
deleteonexit	파일 삭제시 실패했을때 JVM이 종료될 때 이 파일을 지우도록 할것인지 여부를 나타내며 기본값은 false (ant 1.6.2 이후)	No

3. <mkdir>

① 설명

-. 디렉토리를 생성

② 사용예제

"${dist}" 디렉토리를 생성한다

"${dist}/lib" 디렉토리를 생성한다

③ 속성

속성	설명	필수여부
dir	생성할 디렉토리	Yes

4. <move>

① 설명

-. 파일 혹은 디렉토리를 타겟으로 이동시킵니다 디폴트로 타겟에 이미 파일이 존재하면 덮어씁니다.

② 사용예제

하나의 파일을 이동시킵니다 (rename과 동일)
<move file="file.orig" tofile="file.moved"/>

하나의 파일을 디렉토리로 이동시킵니다
<move file="file.orig" todir="dir/to/move/to"/>

디렉토리를 새로운 디렉토리로 이동시킵니다
<move todir="new/dir/to/move/to">
<fileset dir="src/dir"/>
</move>

위의 task와 동일하며 ant 1.6.3부터 지원합니다
<move file="src/dir" tofile="new/dir/to/move/to"/>

파일집합을 새로운 디렉토리로 이동시킵니다
<move todir="some/new/dir">
<fileset dir="my/src/dir">
<include name="**/*.jar"/>
<exclude name="**/ant.jar"/>
</fileset>
</move>

.bak을 제외한 모든 파일에 .bak을 추가시키며 이동시킵니다
<move todir="my/src/dir" includeemptydirs="false">
<fileset dir="my/src/dir">
<exclude name="**/*.bak"/>
</fileset>
<mapper type="glob" from="*" to="*.bak"/>
</move>

③ 속성

-. delete 속성과 동일합니다

III. java 태그

1. <javac>

① 설명

-. 자바소스를 컴파일 하는 tag입니다

기본적으로 타겟에 특정 .java에 대해 .class 파일이 없거나 오래된 .class 파일이면 컴파일 대상입니다

② 사용예제

<path id="compile.classpath">

<pathelement location="${catalina.home}/common/classes"/>
<fileset dir="${web.home}/WEB-INF/lib">
<include name="*.jar"/>
</fileset>
</path>

가장 일반직인 컴파일 태그 compile.classpath 는 앞의 path 태그에서 정의됨

<javac srcdir="${src}"

destdir="${build}">

<classpath refid="compile.classpath"/>

</javac>

include, exclude, debug등을 포함한 컴파일 태그

srcdir 대신 <scr> 태그를 이용한 컴파일 태그

③ 속성

width=20%>속성	설명	필수여부
srcdir	자바 소스가 위치한 디렉토리	Yes `<src>가 존재하면NO`
destdir	컴파일된 클래스파일이 위치할 디렉토리	No
includes	컴마나 스페이스로 구분된 파일집합의 패턴을 포함하여 컴파일하며 모든 파일을 사용하려면 생략한다	No
includesfile	각각 개개의 파일을 포함하여 컴파일	No
excludes	컴마나 스페이스로 구분된 파일의 패턴을 제외하하여 컴파일하며 생략하면 어떠한 디렉토리도 제외하지 않는다	No
excludesfile	각각 개개의 파일을 제외하여 컴파일	No
classpath	사용할 클래스 패스	No
sourcepath	사용할 소스패스이며 기본값은 srcdir 값이다	No
bootclasspath	bootstrap 클래스 패스	No
classpathref	참조를 통해 사용할 클래스 패스 (refid를 이용한 path 태그)	No
sourcepathref	참조를 통해 사용할 소스 패스	No
bootclasspathref	참조를 통해 사용할 bootstrap 패스	No
extdirs	사용할 extednsion이 위치한 경로 (${java_home}/lib/ext/를 말하는것 같음)	No
encoding	소스파일에 사용할 encoding (javac의 -encoding과 동일)	No
nowarn	컴파일시 -nowarn 옵션을 을 줄지 여부를 나타내며 기본값은 off 반대값은 on	No
debug	컴파일시 debug 모드로 컴파일 하며 기본값은 off	No
optimize	컴파일시 optimize 옵션을 사용한다 기본값은 off	No
deprecation	컴파일시 deprecation 옵션을 사용한다 기본값은 off	No
target	특정 VM 버젼으로 컴파일 할수 있도록 한다	No
verbose	컴파일시 그 내용을 화면에 출력한다 기본값은 no	No
depend	이를 지원하는 컴파일러는 dependecy-tracking를 가능하게 한다	No
includeAntRuntime	ant run time library를 포함하여 컴파일하며 기본값은 yes	No
includeJavaRuntime	VM이 실행될때의 run time library를 포함하여 컴파일하며 기본값은 no	No
fork	외부의 JDK를 사용하여 컴파일 하며 기본값은 no	No
executable	fork를 yes로 하였을경우 javac가 실행될 경로를 나타내며 기본값으로는 ant에서 현재 사용중인 java version의 컴파일러를 나타낸다	No
memoryInitialSize	VM내에서 초기 메모리 사이즈를 설정하며 기본값은 VM에 설정된 기본값을 사용한다	No
memoryMaximumSize	VM내에서 최대 메모리 사이즈를 설정	No
failonerror	컴파일시 에러가 발생하였을 경우 계속 진행할지 여부를 나타내며 기본값은 true	No
source	-source 옵션을 이용하여 컴파일 한다	No
compiler	사용할 컴파일러 설정 list	No
listfiles	컴파일 되는 소스파일들을 list할지 여부를 나타내며 기본값은 no	No
tempdir	ant가 사용하는 임시디렉토리 기본값은 java.io.tmpdir (ant 1.6이후)	No

2. <javadoc>

① 개요

-. 자바 소스 파일로 부터 javadoc API 문서를 생성한다

② 사용예제

간단한 사용예

<javadoc sourcepath="${src.home}"
destdir="${dist.home}/docs/api"
packagenames="*">
<classpath refid="compile.classpath"/>
</javadoc>

아래 3가지 사용예는 동일한 의미이다

<javadoc

   packagenames="com.dummy.test.*"
   sourcepath="src"
   excludepackagenames="com.dummy.test.doc-files.*"
   defaultexcludes="yes"
   destdir="docs/api"
   author="true"
   version="true"
   use="true"
   windowtitle="Test API">
<doctitle><![CDATA[<h1>Test</h1>]]></doctitle>
<bottom><![CDATA[<i>Copyright © 2000 Dummy Corp. All Rights Reserved.</i>]]></bottom>
<tag name="todo" scope="all" description="To do:"/>
<group title="Group 1 Packages" packages="com.dummy.test.a*"/>
<group title="Group 2 Packages" packages="com.dummy.test.b*:com.dummy.test.c*"/>
<link offline="true" href="http://java.sun.com/products/jdk/1.2/docs/api/" packagelistLoc="C:\tmp"/>
<link href="http://developer.java.sun.com/developer/products/xml/docs/api/"/>
</javadoc>

<javadoc
   destdir="docs/api"
   author="true"
   version="true"
   use="true"
   windowtitle="Test API">

<packageset dir="src" defaultexcludes="yes">
<include name="com/dummy/test/**"/>
<exclude name="com/dummy/test/doc-files/**"/>
</packageset>

<doctitle><![CDATA[<h1>Test</h1>]]></doctitle>
<bottom><![CDATA[<i>Copyright © 2000 Dummy Corp. All Rights Reserved.</i>]]></bottom>
<tag name="todo" scope="all" description="To do:"/>
<group title="Group 1 Packages" packages="com.dummy.test.a*"/>
<group title="Group 2 Packages" packages="com.dummy.test.b*:com.dummy.test.c*"/>
<link offline="true" href="http://java.sun.com/products/jdk/1.2/docs/api/" packagelistLoc="C:\tmp"/>
<link href="http://developer.java.sun.com/developer/products/xml/docs/api/"/>
</javadoc>

<javadoc
   destdir="docs/api"
   author="true"
   version="true"
   use="true"
   windowtitle="Test API">

<fileset dir="src" defaultexcludes="yes">
<include name="com/dummy/test/**"/>
<exclude name="com/dummy/test/doc-files/**"/>
</fileset>

<doctitle><![CDATA[<h1>Test</h1>]]></doctitle>
<bottom><![CDATA[<i>Copyright © 2000 Dummy Corp. All Rights Reserved.</i>]]></bottom>
<tag name="todo" scope="all" description="To do:"/>
<group title="Group 1 Packages" packages="com.dummy.test.a*"/>
<group title="Group 2 Packages" packages="com.dummy.test.b*:com.dummy.test.c*"/>
<link offline="true" href="http://java.sun.com/products/jdk/1.2/docs/api/" packagelistLoc="C:\tmp"/>
<link href="http://developer.java.sun.com/developer/products/xml/docs/api/"/>
</javadoc>

③ 속성

속성	설명	사용범위	필수여부
sourcepath	자바 소스 위치	all	At least one of the three or nested `<sourcepath>`, `<fileset>` or `<packageset>`
sourcepathref	참조된 경로 아이디를 사용하여 소스위치를 지정 (path 의 refid를 사용)	all
sourcefiles	컴마로 구분하여 소스 파일을 지정	all
destdir	결과물(java docs) 디렉토리를 지정	all	Yes, unless a doclet has been specified.
maxmemory	javadoc VM에 할당할 최대 메모리 사이즈	all	No
packagenames	컴마로 구분된 패키지 파일 목록 ("*"로 끝나면 하위 패키지까지 모두 javadoc으로 처리한다)	all	No
packageList	처리할 패키지를 포함하고있는 파일명	all	No
classpath	사용할 클래스 패스	all	No
Bootclasspath	사용할 bootstrap 클래스 패스	all	No
classpathref	참조된 경로 아이디를 사용하여 클래스 패스를 지정 (path 의 refid)	all	No
bootclasspathref	참조된 경로 아이디를 사용하여 bootstrap classpath를 지정	all	No
Extdirs	설치된 extension 위치	all	No
Overview	HTML 문서로부터 overview 문서를 읽어온다	all	No
access	Access mode를 지정한다 `public`, `protected`, `package`, `private 중 하나의 값을 가지며 기본값은 protected이다`	all	No
Public	생성된 문서에 public 클래스와 멤버만 보여준다	all	No
Protected	생성된 문서에 protected/public 클래스와 멤버만 보여준다	all	No
Package	생성된 문서에 package/protected/public 클래스와 멤버만 보여준다	all	No
Private	생성된 문서에 모든 클래스와 멤버를 보여준다	all	No
Old	jdk 1.1 버젼으로 문서를 생성한다	1.2	No
Verbose	javadoc을 생성하는동안 메세지를 화면에 출력한다	all	No
Locale	사용할 Locale 을 지정한다 (en_US, en_US_WIN, ko_KR)	all	No
Encoding	소스파일 encoding 이름	all	No
Version	@version 단락을 포함한다	all	No
Use	클래스와 패키지 사용법에 대한 페이지를 생성한다	all	No
Author	@author 단락을 포함한다	all	No
Splitindex	Split index into one file per letter	all	No
Windowtitle	생성된 문서의 브라우져 타이트을 지정한다 (텍스트)	all	No
Doctitle	패키지 인덱스 페이지에 대한 타이틀을 지정한다 (html 코드)	all	No
Header	각페이지에대한 헤더부분을 지정한다 (html 코드)	all	No
Footer	각페이지에대한 푸터부분을 지정한다 (html 코드)	all	No
bottom	각페이지에대한 버텀부분을 지정한다 (html 코드)	all	No
link	주어진 URL로 javadoc 출력물에 link를 생성한다	all	No
linkoffline	Link to docs at `<url>` using package list at `<url2>` - separate the URLs by using a space character -- see also the nested `link` element.	all	No
group	특정 패키지들에 대한 overview 페이지를 생성한다	all	No
nodeprecated	@deprecated 정보를 포함하지 않는다	all	No
nodeprecatedlist	deprecated 목록을 생성하지 않는다	all	No
notree	클래스 하이라키를 생성하지 않는다	all	No
noindex	인덱스를 생성하지 않는다	all	No
nohelp	도움말 link를 생성하지 않는다	all	No
nonavbar	네비게이션 바를 생성하지 않는다	all	No
serialwarn	@serial tag 대한 warning을 생성한다	all	No
helpfile	help 파일로 사용될 HTML 파일을 지정한다	all	No
stylesheetfile	CSS 로 사용할 파일을 지정한다	all	No
charset	문서를 생성할때 사용될 charset을 지정한다	all	No
docencoding	결과 파일(문서)에 사용될 encoding을 지정한다	all	No
doclet	doclet을 시작하는 클래스 파일을 지정한다	all	No
docletpath	doclet 클래스 패스를 지정한다	all	No
docletpathref	참조 아이디값을 이용해 docletpath를 지정한다	all	No
additionalparam	javadoc 명령에서 추가적인 파라미터를 추가하도록 한다	all	No
failonerror	에러 발생시 build 중단할지 여부를 나타낸다	all	No
excludepackagenames	문서를 생성하지 않을 패키지를 컴마로 구분하여 지정한다ment.	all	No
defaultexcludes	기본적으로 제외되는 목록을 사용할 것인지 여부를 나타낸다	all	No
useexternalfile	명령줄을 간단히하기위해 임시파일에 기록된 소스파일명을 지정한다 기본값은 No	all	No
source	j2se 1.4 소스코드에 나타난 주장을 처리하도록 javadoc에서 설정한다	1.4+	No
linksource	소스파일에 hyperlinks 생성한다 기본값은 No (ant 1.6이후)	1.4+	No
breakiterator	새로운 breakiterator 알고리즘을 사용한다 기본값은 No (ant 1.6이후)	1.4+	No
noqualifier	-noqualifier 옵션을 설정한다 (ant 1.6이후)	1.4+	No
includenosourcepackages	"true"이면 자바소스가 아닌 패키지된 html을 가지고 문서 생성이 한다 (ant 1.6.3이후)	all	No (default is `false`)
executable	실행될 javadoc 위치를 지정한다 (ant 1.6이후)	all	No

3. <war>

① 개요

-. 웹 어플리케이션 배포 파일인 war 파일을 생성해 준다

② 사용예제

thirdparty/libs/jdbc1.jar
thirdparty/libs/jdbc2.jar
build/main/com/myco/myapp/Servlet.class
src/metadata/myapp.xml
src/html/myapp/index.html
src/jsp/myapp/front.jsp
src/graphics/images/gifs/small/logo.gif
src/graphics/images/gifs/large/logo.gif

위의 파일을 WAR로 구성해 보자

<war destfile="myapp.war" webxml="src/metadata/myapp.xml">
<fileset dir="src/html/myapp"/>
<fileset dir="src/jsp/myapp"/>
<lib dir="thirdparty/libs">
<exclude name="jdbc1.jar"/>
</lib>
<classes dir="build/main"/>
<zipfileset dir="src/graphics/images/gifs"
prefix="images"/>
</war>

WAR task 후 다음과 같이 구성된다

WEB-INF/web.xml
WEB-INF/lib/jdbc2.jar
WEB-INF/classes/com/myco/myapp/Servlet.class
META-INF/MANIFEST.MF
index.html
front.jsp
images/small/logo.gif
images/large/logo.gif

③ 속성

속성	설명	필수여부
destfile	생성될 WAR 파일 지정	둘중 하나는 필수
warfile	Deprecated	둘중 하나는 필수
webxml	사용할 deployment descriptor (WEB-INF/web.xml)를 지정	Yes
basedir	jar파일로 압축할 디렉토리를 지정한다	No
compress	data를 압축할지 여부를 나타내며 기본값은 true이다 keepcompression 속성을 false로 했을지라도 이는 적용된다	No
keepcompression	이미 존재하는 파일 묶음에 대해 compress을 계속 유지할 것인지 여부를 나타내며 기본값은 fale 이다 (ant 1.6이후)	No
encoding	압축될 파일명에 사용할 encoding을 지정한다 기본값은 UTF8	No
filesonly	Store only file entries 기본값은 false	No
includes	지정된 컴마나 스페이스로 구분된 파일 패턴을 WAR에 포함하며 생략하면 모든 파일을 WAR한다	No
includesfile	지정된 개개의 파일을 WAR에 포함한다	No
excludes	지정된 컴마나 스페이스로 구분된 파일 패턴을 WAR에서 제외시키며 생략하면 어떠한 파일로 제외하지 않는다	No
excludesfile	지정된 개개의 파일을 WAR에서 제외시킨다	No
defaultexcludes	기본적으로 제외시키는 기능을 사용할것인지 여부를 나타낸다	No
manifest	사용할 manifest 파일을 지정한다	No
update	이미 존재하는 파일이라면 업데이트할지 덮어쓸지를 결정하며 기본값은 false이다	No
duplicate	중복된 파일이 나타났을 때 "add"할지 "preserve"할지 혹은 "fail"할지를 지정하며 기본값은 "add"이다	No
roundup	파일 시간 비교시 파일 변경 시간을 다음 짝수 횟수의 초(seconds)에 반올림 할지 혹은 내림할지 여부를 나타낸다 기본값은 true (ant 1.6.2 이후)	No

from http://ant.apache.org/manual/index.html

=============================================

본문서는 자유롭게 배포/복사 할수 있지만

이문서의 저자에 대한 언급을 삭제하시면 안됩니다

저자 : GoodBug (unicorn@jakartaproject.com)

최초 : http://www.jakartaproject.com

=============================================

Posted by 1010

52.Apache Project &.../Jakarta Ant2008. 8. 19. 16:32

Jakarta Ant I탄 기본편

Jakarta Ant

I. Ant 야 놀자~

Ant 란 "Java 기반의 빌드 도구입니다" 라고들 많이 나와있습니다
근데 이게 대체 무순 뜻이란 말인가 ㅡ.ㅡ;

쉽게 예기해서 환경에 구애받지 않고 간단히 java 소스를 컴파일 하고 필요한 파일이 있다면
그 파일들을 복사나 삭제하며 또한 javadoc 이나 war 같은 배포용 파일까지 생성해 주며
필요하다면 서버에 까지 바로 적용할 수 있도록 도와주는 도구입니다.

또한 여러팀원들이 프로젝트를 진행할 때 새로운 팀원이 참가하더라도
Ant 설정파일을 공유함으로써 손쉽게 참여가 가능하다는 것입니다

아직 사용해 보지 않았다면 얼렁 익혀서 사용해봅시다 무~지 편하답니다

II. 설치해보자
다운로드
Ant

http://ant.apache.org/bindownload.cgi

Ant manual

http://ant.apache.org/manual/index.html

http://ant.apache-korea.org/manual/index.html

다운받은 파일의 압축을 풀고 환경변수 및 패스를 잡아줍니다
set ANT_HOME=c:\ant
set JAVA_HOME=c:\jdk1.4.2
set PATH=%PATH%;%ANT_HOME%\bin

III. 간단한 Ant 예제

Ant를 이용하여 web application을 구성할 때 다음의 구조를 유지하기를 권장합니다

① build : src, web, docs에서 결과적으로 만들어진 산출물 디렉토리
② dist : build를 배포하기 위한 배포 디렉토리
③ docs : 배포판에 배포할 정적인 문서를 관리할 디렉토리
④ src : /WEB-INF/classes 에 위치할 java 소스 디렉토리
⑤ web : HTML, JSP, 이미지등의 컨텐트 디렉토리 (WEB-INF의 서브디렉토리 포함)
⑥ build.properties : build.xml에서 사용할 properties
⑦ build.xml : ant 명령으로 실행될 설정파일

src에 하나이상의 java 소스를 테스트로 넣어 놓으세요

자 이렇게 디렉토리를 설정하고 build.xml 을 다음 step에 따라 따라 해 BOA요 ^^&

STEP 1. build.xml 의 기본구조

xml을 기본적인 내용을 안다면 이해하기 쉽습니다

<project name="My Project" default="compile" basedir=".">

<target name="clean">

여러 작업

</target>

<target name="prepare" depends="clean">

여러 작업

</target>

<target name="compile" depends="prepare">

여러 작업

</target>

</project>

하나의 build 파일은 하나의 project로 구성되며 이는 다시 여러 target으로 구성됩니다

target 이란 빌드 과정중 수행해야 할 task들을 모아놓은 job 단위 라고 보면 됩니다

compile target이라 한다면 compile에 관련된 작업들을 모아놓은 그룹이라 생각하면 쉽게 이해 될겁니다

STEP 2. 시~작 Ant 맛보기~
① build.xml에 다음을 입력한 후 저장 합니다

<project name="Unicorn Project" default="clear" basedir=".">
<description>Simple Test</description>

<property file="${basedir}/build.properties"/>

<echo message="${catalina.home}"/>

<target name="clear"/>

</project>

-. project

project는 하나 이상의 target을 정의 합니다 또한 하나의 target은 task의 집합입니다

ant를 실행할 시에 어느 타겟을 실행할 것인지 지정할 수가 있으며 (예: \ant clear)

지정하지 않았을 경우 디폴트로 설정된 값이 사용됩니다 이부분이 default="clear"입니다

-. property

전역변수 설정 혹은 그렇게 사용할 build.properties를 정의 합니다

build.properties에 catalina.home을 정의하였으며 여러 환경이 변하더라도 이 값만

변경해주면 build.xml을 수정없이 바로 실행 가능합니다

-. echo

message 내용을 출력 합니다

-. target

target 이란 task의 집합으로 실질적으로 실행될 코드들의 묶음입니다

여기서는 아무 task도 없습니다

② build.properties에 다음을 입력 후 저장합니다

catalina.home=C:\Tomcat 5.0

catalina.home 은 변수로 사용할 것이며 그 값은 C:\Tomcat 5.0입니다

③ 실행

해당 디렉토리로 이동하여 도스창에서 ant 라고 칩니다

c:\예제\ant

Buildfile : build.xml

[echo] c:\Tomcat 5.0

clear :

BUILD SUCCESSFUL

Total time : 0 seconds

STEP 3. 사전작업 하기~

이번 단계에서는 컴파일 하기전 전역변수 선언이나 컴파일 시 클래스 패스 설정을 해봅시다

① build.xml

<project name="Unicorn Project" default="prepare" basedir=".">
<description>Simple Test</description>

<property name="app.name" value="unicorn"/>
<property name="app.path" value="/${app.name}"/>
<property name="app.version" value="0.1-dev"/>

<property name="build.home" value="${basedir}/build"/>
<property name="dist.home" value="${basedir}/dist"/>
<property name="docs.home" value="${basedir}/docs"/>
<property name="src.home" value="${basedir}/src"/>
<property name="web.home" value="${basedir}/web"/>

<path id="compile.classpath">

<pathelement location="${catalina.home}/common/classes"/>
<fileset dir="${catalina.home}/common/endorsed">
<include name="*.jar"/>
</fileset>
<fileset dir="${catalina.home}/common/lib">
<include name="*.jar"/>
</fileset>
<pathelement location="${catalina.home}/shared/classes"/>
<fileset dir="${catalina.home}/shared/lib">
<include name="*.jar"/>
</fileset>
<fileset dir="${web.home}/WEB-INF/lib">
<include name="*.jar"/>
</fileset>
</path>

<target name="clean"
description="Delete old build and dist directories">
<delete dir="${build.home}"/>
<delete dir="${dist.home}"/>
</target>

<target name="prepare" depends="clean">

<mkdir dir="${build.home}"/>
<mkdir dir="${build.home}/WEB-INF"/>
<mkdir dir="${build.home}/WEB-INF/classes"/>
   <mkdir dir="${build.home}/WEB-INF/lib"/>

<copy todir="${build.home}">
   <fileset dir="${web.home}">
   <include name="**/*.jsp"/>
   <include name="**/*.css"/>
   <include name="**/*.html"/>
   <include name="**/*.js"/>
      <include name="**/*.jpg"/>
   <include name="**/*.gif"/>
   <include name="**/*.swf"/>
   <include name="**/*.xml"/>
   <include name="**/*.tld"/>
   <include name="**/*.jar"/>

</fileset>
</copy>

</target>

</project>

-. project

이번에는 default 값을 prepare로 하였습니다 고로 target은 prepare가 실행될 것입니다

-. property

역시나 build.properties를 정의하였고 여러 전역변수를 설정하였습니다

build.home 이란 변수에는 ${basedir}/build 값이 정의되었으며

build.home은 ${build.home}으로 사용할수 있습니다

궁금하면 <echo message="${build.home}"/> 등으로 출력해 봅시다~

-. path

${catalina.home} 은 build.properties에서 정의하였다는것을 기역하실겁니다

fileset은 파일들의 집합을 나타내는데 어떤 특정파일만 포함 할수 있거나 혹은 어느 특정파일만 제외할 수 있습니다

특정파일만 포함하는것은 include 태그이며 그 반대는 exclude 입니다

이부분은 ${web.home}/WEB-INF/lib 에서 *.jar 파일만 클래스패스로 잡겠다는 의미입니다

-. target

드디어 실질적으로 실행될 target 입니다.

project 속성의 default가 prepare이므로 prepare target으로 실행하기 위해 가보니 depend 속성으로 "clean"이 설정되어 있습니다

이것은 "clean" target을 먼저 실행 후 prepare를 실행하라는 말입니다

즉 prepare는 clean이 실행조건 입니다

clean target은 delete 태그를 이용하여 배포할 dist 디렉토리와 산출물 디렉토리인 build를 삭제하는 작업입니다
prepare target으로 다시 와보면 mkdir 는 당연히 디렉토리를 만들라는 뜻입니다

copy는 todir에 다음 web.home의 모든 fileset을 copy 하라는 의미입니다 여기서도 역시나 include, exclude가 사용될 수 있겠지요

<include name="**/*.jsp"/> 는 모든디렉토리의 *.jsp 를 카피하라는 의미입니다

즉 web 디렉토리의 모든 실행 가능할 파일을 build로 옮기는 작업입니다

② 실행

c:\예제\ant

Buildfile : build.xml

clean :

[delete] : Deleting directory c:\예제\build

[delete] : Deleting directory c:\예제\dist

prepare :

[mkdir] Created dir : c:\예제\build\WEB-INF

[mkdir] Created dir : c:\예제\build\WEB-INF\classes

[mkdir] Created dir : c:\예제\build\WEB-INF\lib

[copy] Copying 2 files to Deleting directory c:\예제\build

BUILD SUCCESSFUL

Total time : 1 seconds

STEP 4. 컴파일 하기

이제 컴파일할 모든 준비가 되었습니다

STEP2의 소스에 다음 target을 추가하고 project의 default 값을 compile로 수정한 후 실행해 봅시다

<javac srcdir="${src.home}"
destdir="${build.home}/WEB-INF/classes">
<classpath refid="compile.classpath"/>
</javac>

<copy todir="${build.home}/WEB-INF/classes">
<fileset dir="${src.home}" excludes="**/*.java"/>
</copy>

</target>

-. target

depends가 prepare이므로 실행 순서는 clean, prepare, compile 입니다

javac 태스크는 srcdir 인 소스디렉토리에 있는 자바소스를 desdir 쪽으로 컴파일 합니다

classpath는 위에서 이미 설정한 compile.classpath를 사용합니다

그 후 properties등 같은 기타 resource 들을 /WEB-INF/classes에 복사합니다

② 실행

c:\예제\ant

Buildfile : build.xml

clean :

[delete] : Deleting directory c:\예제\build

[delete] : Deleting directory c:\예제\dist

prepare :

[mkdir] Created dir : c:\예제\build\WEB-INF

[mkdir] Created dir : c:\예제\build\WEB-INF\classes

[mkdir] Created dir : c:\예제\build\WEB-INF\lib

[copy] Copying 2 files to Deleting directory c:\예제\build

compile :

[javac] Compileing 1 source file to c:\예제\build\WEB-INF\classes

[copy] Copying 1 file to c:\예제\build\WEB-INF\classes

BUILD SUCCESSFUL

Total time : 1 seconds

STEP 5. Javadoc 을 이용해 API를 만들어 보고 배포파일도 생성해 보자

이제 컴파일도 했으니 javadoc도 만들어 보고 war 같은 배포파일도 생성해 봅시다

STEP 3.까지의 build.xml에 아래 target을 더 추가하고 project의 default 값에 dist로 설정합니다

① build.xml

</target>

<jar jarfile="${dist.home}/${app.name}-${app.version}.war"
basedir="${build.home}"/>

</target>

-. target

target의 실행순서는 clean, prpare, compile, javadoc, dist가 될겁니다

javadoc target의 javadoc 태스트를 보면 java 소스가 있는 소스디렉토리와

API를 생성할 타겟 디렉토리를 정해주면 알아서 API를 생성해 줍니다

만들어진 API는 배포버젼의 dist디렉토리로 해주면 더 좋겠지요

dist target은 배포파일인 war를 만듭니다

필요한 문서가 있으면 docs 디렉토리를 만들어 로 복사도 하도록 합시다

jar 태스크는 위의 방식과 같이 사용합니다

② 실행

c:\예제\ant

Buildfile : build.xml

clean :

[delete] : Deleting directory c:\예제\build

[delete] : Deleting directory c:\예제\dist

prepare :

[mkdir] Created dir : c:\예제\build\WEB-INF

[mkdir] Created dir : c:\예제\build\WEB-INF\classes

[mkdir] Created dir : c:\예제\build\WEB-INF\lib

[copy] Copying 2 files to Deleting directory c:\예제\build

compile :

[javac] Compileing 1 source file to c:\예제\build\WEB-INF\classes

[copy] Copying 1 file to c:\예제\build\WEB-INF\classes

javadoc :

[mkdir] Created dir : c:\예제\dist\docs\api

[javadoc] Generating Javadoc

[javadoc] Javadoc execution

[javadoc] Loading source files for package com.jakartaproject.db...

[javadoc] Constructing Javadoc information...

[javadoc] Standard Doclet version 1.4.1

[javadoc] Building tree for all the packages and classes...

[javadoc] Building index for all the packaes and classes...

[javadoc] Building index for all classes...

dist :

[jar] Building jar :Created dir : c:\예제\dist\unicorn-0.1-dev.war

BUILD SUCCESSFUL

Total time : 3 seconds

VI. Ant 실행

① C:\예제\ant -help

ant [options] [target [target2 [target3] ...]]

Options :
-help    이 메세지의 표시
-projecthelp 프로젝트 도움 정보의 출력
-version    버전 정보의 출력과 종료
-diagnostics diagnose 나 report 문제에 도움이 되는 정보의 출력.
-quiet, -q    한층 더 메세지를 적게
-verbose, -v 한층 더 메세지를 많게
-debug 디버그 정보의 출력
-emacs adornments 없이 로그 정보의 생성(produce)
-logfile <file> 로그를 지정 파일에 출력
-l <file>    ''
-logger <classname>    로그 생성을 실행하기 위한 클래스
-listener <classname> 프로젝트 청취자(listener) 역할의 class의 인스턴스를 추가
-buildfile <file>    지정된 빌드 파일의 사용
-file    <file>    ''
-f <file>    ''
-D<property>=<value> 지정된 프로퍼티의 값의 사용
-propertyfile <name>    모든 프로퍼티를 파일로부터 로드 (-D프로퍼티보다 전에)
-inputhandler <class> 입력 요청(requests)를 취급하는 클래스
-find <file> 파일시스템의 루트로 향해 빌드파일을 검색하고 그것을 사용

② C:\예제\ant

현재 디렉토리에 있는 build.xml 파일을 이용해, 디폴트 타겟으로 Ant 를 실행합니다.

③ C:\예제\ant compile

현재 디렉토리에 있는 build.xml이 실행되며 파라미터로 compile을 지정하면 project의 default 값을 무시하고 compile target을 실행합니다 물론 depends 가 있다면 먼저 실행합니다

④ C:\예제\ant -buildfile test.xml

현재 디렉토리에 있는 test.xml 파일을 이용해, 디폴트 타겟으로 Ant 를 실행합니다.

⑤ C:\예제\ant -buildfile test.xml dist

현재 디렉토리에 있는 test.xml 파일을 이용해, dist 라는 이름의 타겟으로 Ant 를 실행합니다.

⑥ C:\예제\ant -buildfile test.xml -Dbuild=build/classes dist

현재 디렉토리에 있는 test.xml 파일을 이용해, dist 라는 이름의 타겟으로, build 프로퍼티에 build/classes 값을 설정해 Ant 를 실행합니다.

VII. 기본 프로퍼티

Ant는 다음과 같은 프로퍼티를 기본으로 제공합니다

① basedir : 기본 디렉토리 경로를 나타내며 project 태그의 basedir에 명시되어 있습니다

② ant.file : 빌드 파일의 절대 경로입니다

③ ant.version : Ant 버젼을 나타냅니다

④ ant.project.name : project 태그의 name에 명시되어있습니다

⑤ ant.java.version : 자바 버젼을 나타냅니다

⑥ 자바 시스템 프로퍼티를 사용 가능 합니다

예) ${os.name} 참고 http://java.sun.com/j2se/1.4.2/docs/api/java/lang/System.html#getProperties()

<echo message="${ant.file}"/> 으로 한번 출력해 보면 이해가 쉽습니다

다음 시간에는 각 타스크의 종류와 상세 설정에 관해 알아봅시다

=============================================

본문서는 자유롭게 배포/복사 할수 있지만

이문서의 저자에 대한 언급을 삭제하시면 안됩니다

저자 : GoodBug (unicorn@jakartaproject.com)

최초 : http://www.jakartaproject.com

=============================================

Posted by 1010

«이전 1 다음»

일	월	화	수	목	금	토
1	2	3	4	5	6	7
8	9	10	11	12	13	14
15	16	17	18	19	20	21
22	23	24	25	26	27	28
29	30	31

개발자(開發者) a developer

'52.Apache Project &.../Jakarta Ant'에 해당되는 글 3건

아파치 앤트용 외부 자료의 목록

Jakarta Ant II탄 상세편

Jakarta Ant I탄 기본편

카테고리

공지사항

태그목록

최근에 올라온 글

최근에 달린 댓글

최근에 받은 트랙백

글 보관함

달력

링크

티스토리툴바