我的java历程

Ant的使用

Ant的使用

 

       Ant,以我自身的理解,它的作用类似与Linux下的makefile,可以对软件项目进行编译、生成文档、单元测试、打包、部署等;但又不同与makefile,因为makefile是基于shell的构建工具,但Ant是基于Java的构建工具,且使用Java语言可以很容易的对它进行扩展,Ant是基于XML的书写格式。

 

一、安装Ant

1、  先将Ant解压到一个目录,假如解压到D:\ant

2、  设置环境变量

set ANT_HOME=d:\ant

set PATH=%PATH%;%ANT_HOME%\bin

 

二、使用Ant

Ant的构建文件是用XML格式书写的,每个build文件包含一个project和至少一个默认的target。

<?xml version="1.0" encoding="UTF-8"?>

<project name="jartest" default="jar" basedir=".">

       <target name="jar" depends="war">

              <jar jarfile="${basedir}/Operation.jar">

                     <fileset dir="bin">

                            <include name="**/*.class" />

                     </fileset>

                     <!--

                     <fileset dir="src">

                            <include name="jndi.properties"/>

                     </fileset>

                     -->

              </jar>

       </target>

       <target name="war">

              <war warfile="OperationTest.war" webxml="web/WEB-INF/web.xml">

                     <fileset dir="web">

                            <include name="**/*.jsp"/>

                     </fileset>

              </war>

       </target>

</project>

 

1、  Project

Project有三个属性name,default,basedir

Name:Project的名字

Default:build文件运行时默认的target

Basedir:进行项目构建的根目录,如果没有设置此项,则默认与build文件同目录

 

2、  Target

一个Target可以依赖于其它多个Target,

            <target name="A"/>

            <target name="B" depends="A"/>

想要执行B必需先执行A

Target的属性:name,depends,if,unless,description

Name:Target的名字

Depends:执行当前Target时需要依赖的Target

If:这个属性的名字必需设置,当前的Target才能执行

<target name="A" if="file"/>

Unless:这个属性的名字必需不能设置,当前的Target才能执行

<target name="A" unless="file"/>

Description:对当前Target的一段描述

 

3、  Tasks

具体需求执行的任务,这个就有很多了,如:WAR, EAR, JAVAC, JAVA, JAR, COPY, COPYDIR, COPYFILE, MKDIR, MOVE, DELETE, ECHO, EXEC, UNZIP, ZIP, TAR, UNJAR, UNTAR, UNWAR, SCP, FTP, TELNET, 等等,以下是各Task的属性介绍:

 

(1)  Javac:编译Java源文件

         Srcdir:Java文件的目录

         Destdir:Class文件的保存目录

         Includes:需要包含哪些文件

         Excludes:不包含哪些文件

         Classpath:编译时需要引用的classpath

         Debug:编译时是否包含debug信息

  <javac destdir="${build}" classpath="xyz.jar" debug="on">

    <src path="${src}"/>

                            <src path="${src2}"/>

                            <include name="mypackage/p1/**"/>

                            <include name="mypackage/p2/**"/>

                            <exclude name="mypackage/p1/testpackage/**"/>

                             </javac>

 

(2)  Java:运行class文件

  Classname:需要执行的class文件名

  Jar:需要执行的jar文件,必须包含程序入口类,有Main方法的类

  Args:执行class需要的参数

  Classpath:需要使用的classpath

                     <java jar="dist/test.jar" fork="true" failonerror="true" maxmemory="128m">

                        <arg value="-h"/>

                        <classpath>

                       <pathelement location="dist/test.jar"/>

                       <pathelement path="${java.class.path}"/>

                        </classpath>

               </java>

 

(3)  Jar:将多个class文件打成一个jar包

Destfile:需要创建的jar文件名

Basedir:文件的来源

         Includes:需要包含哪些文件

         Excludes:不包含哪些文件

                    <jar destfile="${dist}/lib/app.jar"

                      basedir="${build}/classes"

                      includes="mypackage/test/**"

                      excludes="**/Test.class"

                    />

 

(4)  War:将文件打包成War文件

Destfile:需要创建的war文件名

Webxml:web.xml文件的路径及文件名

Basedir:文件的来源

         Includes:需要包含哪些文件

         Excludes:不包含哪些文件

                     <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>

 

(5)  Ear:将文件打包成Ear文件

Destfile:需要创建的ear文件名

appxml:META-INF/application.xml文件的路径及文件名

Basedir:文件的来源

         Includes:需要包含哪些文件

         Excludes:不包含哪些文件

                     <ear destfile="${build.dir}/myapp.ear" appxml="${src.dir}/metadata/application.xml">

                                 <fileset dir="${build.dir}" includes="*.jar,*.war"/>

               </ear>

 

(6)  Mkdir:创建一个目录

<mkdir dir="${dist}"/>

 

(7)  Delete:删除一个文件,或文件夹及其包含的文件

File:需要删除的文件名

Dir:需要删除的目录

<delete file="/lib/ant.jar"/>

<delete dir="lib"/>

                  <delete>

                      <fileset dir="." includes="**/*.bak"/>

                  </delete>

 

4、  Properties

一个Project可以设置多个Property,可以在build文件内使用,也可以通过Ant命令使用

(1) 在build文件内

          <property name="build" location="build"/>

          <delete dir="${build}"/>

(2) 通过Ant命令,使用选项为:-Dproperty=value

          <property name="build" location="build"/>

          执行Ant命令:ant –Dbuild=aa 则location的值就变为aa了

              设置Property的六种方式

(1) 通过name,value的属性设置

         <property name="foo.dist" value="dist"/>

(2) 通过name,refid的属性设置

(3) 通过file,url,resource属性设置,foo.properties是键值对的属性文件

         <property file="foo.properties"/>

         <property resource="foo.properties"/>

         <property url="http://www.mysite.com/bla/props/foo.properties"/>

(4) 通过environment属性设置,获得环境变量

         <property environment="env"/>

        <echo message="ANT_HOME is set to = ${env.ANT_HOME}"/>

 

三、运行Ant

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

Options:

  -help, -h              print this message

  -projecthelp, -p       print project help information

  -version               print the version information and exit

  -diagnostics           print information that might be helpful to

                         diagnose or report problems.

  -quiet, -q             be extra quiet

  -verbose, -v           be extra verbose

  -debug, -d             print debugging information

  -emacs, -e             produce logging information without adornments

  -lib <path>            specifies a path to search for jars and classes

  -logfile <file>        use given file for log

    -l     <file>                ''

  -logger <classname>    the class which is to perform logging

  -listener <classname>  add an instance of class as a project listener

  -noinput               do not allow interactive input

  -buildfile <file>      use given buildfile

    -file    <file>              ''

    -f       <file>              ''

  -D<property>=<value>   use value for given property

  -keep-going, -k        execute all targets that do not depend

                         on failed target(s)

  -propertyfile <name>   load all properties from file with -D

                         properties taking precedence

  -inputhandler <class>  the class which will handle input requests

  -find <file>           (s)earch for buildfile towards the root of

    -s  <file>           the filesystem and use it

  -nice  number          A niceness value for the main thread:

                         1 (lowest) to 10 (highest); 5 is the default

  -nouserlib             Run ant without using the jar files from ${user.home}/.ant/lib

  -noclasspath           Run ant without using CLASSPATH

 

如:ant -buildfile test.xml -Dbuild=build/classes dist

 

posted on 2007-04-10 12:32 landril 阅读(3240) 评论(0)  编辑  收藏 所属分类: Ant


只有注册用户登录后才能发表评论。


网站导航: