OA之Ant打包build.xml解析

1.project 根结点
   基本属性：name、default、basedir。
   name:    项目名称(可选)

   default: 默认开始执行的target。(必需)

   basedir: 用于计算所有其他路径的基路径。可以被basedir property覆盖。当覆盖时，该属性被忽略。如果属性和basedir property都没有设定，就使用build.xml的父目录。一般basedir=".",设置为build.xml所在的目录。(可选)

 

2.target

Attribute属性	Description属性值内容	Required
name	target的名字	Y
depends	需要依赖的其他target	N
description	关于target功能的简短描述	N
if	为了执行本target而被设置的属性的名字	N
unless	为了执行本target而不被设置的属性的名字	N

2.1 依赖关系depands

       <target name="A"/>

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

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

       <target name="D" depends="C,B,A"/>

       当执行target D,则先执行A,再B,然后C,最后D。

        一个target只能被执行一次，即使有多个target依赖于它。

2.2 if,unless
       if属性表示该属性内容的变量如果已经被设置了，则可以执行本target;
       unless属性则表示该属性内容的变量如果还没有被设置，则可以执行本target。
       伪代码:
       //if="ready"                    //unless="ready"
       if(ready == "ok"){              if(ready == null){
          execute target;                     execute target; 
       }else {                                  }else {
          skip;                                        skip;
       }                                            }

        如果没有if或unless属性，target总会被执行。

2.3 description属性
       可选的description属性可用来提供关于target的一行描述，可由-projecthelp命令行选项输出

3. task

   常用的task:

    3.1 创建目录mkdir

       创建一个目录，如果其父目录不存在，也会被同时创建。

       <mkdir dir="build/classes"/>

       

       <target name="init">

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

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

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

       </target>

 

   3.2 删除目录delete

       <delete includeEmptyDirs="true">

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

       </delete>

 

       <target name="clean" description="clean up" >

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

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

       </target>

 

    3.3 copy文件或目录

       <copy file="file" tofile="file.bak"/>

 

       <copy file="config.xml" todir="${dist.classes.dir}"/>

 

       <copy todir="${targetdir}">

            <fileset dir="${sourcedir}"/>

       </copy>

 

       <target name="copy-resources" depends="clean">

            <copy todir="${targetdir}">

                <fileset dir="${sourcedir}">

                    <exclude name="**/**/*.java" />

                </fileset>

            </copy>

       </target>

 

    3.4 move文件或目录

       <move file="file" tofile="file.bak"/>

 

       <move todir="${targetdir}">

            <fileset dir="${sourcedir}"/>

       </move>

 

       <move todir="${targetdir}">

            <fileset dir="${sourcedir}">

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

            </fileset>

       </move>

 

    3.5 compile

       <path id="libraries">

            <fileset dir="${libdir}">

                 <include name="*.jar" />

            </fileset>

       </path>

       <target name="compile" depends="copy-resources">

            <javac srcdir="${sourcedir}"

                   destdir="${targetdir}"

                   classpathref="libraries" />

            <jar destfile="${jardir}/my.jar" basedir="${targetdir}"/>

       </target>

 

    3.6 jar

       <jar destfile="${jardir}/my.jar" basedir="${targetdir}"/>

 

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

            <fileset dir="${build}/classes"

        excludes="**/Test.class"

         />

         　 <fileset dir="${src}/resources"/>

       </jar>

4. 变量property

   <property name="sourcedir" value="${basedir}/src" />
   <property name="build"     location="build" />

   除了可以使用自定义的变量，还可以使用java系统属性, 例如${os.name}对应操作系统的名字，以及Ant内置属性：  

   basedir                     <project>的basedir属性
   ant.file                      buildfile的绝对路径
   ant.version               Ant的版本
   ant.project.name     当前执行的project的名字；由<project>的name属性设定
   ant.java.version      Ant检测到的JVM的版本

5. build.xml example

<? xml  version ="1.0"  encoding ="UTF-8"  ?> 
< project  default ="junitTest"  name ="myProject"  basedir ="." > 
<!-- 设置全局属性 -->  
         < property  name ="sourcedir"  value ="${basedir}/src"  /> 
         < property  name ="targetdir"  value ="${basedir}/WEB-INF/classes"  /> 
         < property  name ="libdir"  value ="${basedir}/WEB-INF/lib"  /> 
         
         < path  id ="libraries" > 
                 < fileset  dir ="${libdir}" > 
                         < include  name ="*.jar"  /> 
                 </ fileset > 
         </ path > 
         
         
         < target  name ="junitTest"  depends ="compile" > 
                 < java  classname ="junit.textui.TestRunner"  > 
                         < classpath > 
                                 < path  refid ="libraries"  /> 
                                 < path  location ="${targetdir}"  /> 
                         </ classpath > 
                         < arg  value ="can.junit.HibernateDemoTest"  /> 
                 </ java > 
         </ target > 
<!-- 编译java代码从 ${src} 到 ${build} -->
         < target  name ="compile"  depends ="copy-resources" > 
                 < javac  srcdir ="${sourcedir}" 
                         destdir ="${targetdir}" 
                         classpathref ="libraries"  /> 
         </ target > 
          <-- copy文件或目录-->     
         < target  name ="copy-resources"  depends ="clean" > 
                 < copy  todir ="${targetdir}" > 
                         < fileset  dir ="${sourcedir}" > 
                                 < exclude  name ="**/**/*.java"  /> 
                         </ fileset > 
                 </ copy > 
         </ target > 
         <--删除目录delete-->
         < target  name ="clean"  > 
                 < delete  dir ="${targetdir}"  /> 
                 < mkdir     dir ="${targetdir}"  /> 
         </ target > 
</ project >

文章参考与：http://www.blogjava.net/1504/archive/2009/04/15/265851.html