【图文】 使用ant编译和发布java项目

    开发JavaEE项目经常会碰到修改代码后，项目没有重新编译的问题。老大给指明了一个解决办法：用ant编译项目。

ant是apache基金会下的一个项目，是基于Java语言的构建工具。

    网上下载好ANT后，还需要配置相应的环境变量，跟java配置类似。系统变量中新建一个叫ANT_HOME的变量，值为ANT在本机的路径。我的在F盘，就这样设置：ANT_HOME(变量名) F:\\ANT;(变量值)。设置好后，打开DOS命令行，输入：ANT，出现相应提示就说明配置成功。如果说不是内部或外部命令，就在用户变量的PATH变量下，增加ANT的路径地址。

    配置好环境变量后，在java项目目录下创建一个叫：build.xml文件，这是ANT的默认构建文件。

    一个完整的build.xml包含以下标签：

1.<project>标签  2.<target>标签 3.<mkdir>标签 4<jar>标签 5．<javac标签>  6．<java>标签 7.<delete>标签 8.<copy>标签

还有property变量标签和path路径标签。

 

<property name="proj.home" value="." /> 
<property name="proj.build" value="${proj.home}/WebRoot/WEB-INF/classes" />

<property>标签的作用是在build.xml文件中声明一些常用的变量。比如上面第一个标签中，用proj.home表示变量点"."，变量的使用是通过:${变量名}表示值的。属性标签中可以嵌套属性标签，第二个标签的值便是："./WebRoot/WEB-INF/classes"

 

<path id="compile.classpath">
            <fileset dir="./WebRoot/WEB-INF/lib">  <!-- 编译java程序用到的第三方包所在的目录 -->
                <include name="**/*.jar" />
            </fileset>
 </path>

<path>标签保存的是某个文件夹的路径。以上面代码举例，fileset dir意思设置指定的文件夹，include表示从这个文件夹获取jar格式的文件。path标签通过id属性值使用。

 

 

< project name = "project" default = "all" basedir = "." >
< / project >

1.<project>标签是构建文件的根标签。它可以有多个内在属性，就如代码中所示，其各个属性的含义分别如下。

(1) default表示默认的运行目标，这个属性是必须的。

(2) basedir表示项目的基准目录。

(3) name表示项目名。

 

 

    <!-- 把这个工程目录下的WebRoot目录生成 war文件-->
    <target name="war_test" depends="compile">
        <echo>Building war file into:${proj.war}</echo>
        <mkdir dir="${proj.dist}" />
        <delete file="${proj.war}" /> 
        <jar destfile="${proj.war}" encoding="UTF-8">
            <fileset dir="${proj.srcdocroot}">
                <exclude name="**/lib/servlet-api.jar" />
                <exclude name="**/lib/jsp-api.jar" />
            </fileset>
        </jar> 
    </target>
 
    <target name="deploy" depends="war_test">
        <copy file="${proj.war}" tofile="${tomcat.deployhome}/erp.war"/>
    </target>

2.<target>标签

一个项目标签下可以有一个或多个target标签。Target的所有属性如下。

(1).name表示标明，这个属性是必须的。

(2).depends表示依赖的目标。

(3)if表示仅当属性设置时才执行。

(4)unless表示当属性没有设置时才执行。

    一个target标签可以依赖其他的target标签。

例如，有一个target用于编译程序，另一个target用于生成可执行文件。在生成可执行文件之前必须先编译该文件，因此可执行文件的target依赖于编译程序的target。在上面代码中，第一个target叫“war_test”，用来生成war文件。第二个terger作用是把生成war文件复制到Tomcat里，复制文件前需要事先存在该文件，所以第二个targer必须依赖第一个，depends属性即为第一个targer的name属性值。

 Ant的depends属性指定了target的执行顺序。Ant会依照depends属性中target出现顺序依次执行每个target。在执行之前，首先需要执行它所依赖的target。所以上面两个targer执行的顺序是war_test->deploy。

    一个target只能被执行一次，即使有多个target依赖于它。如果没有if或unless属性，target总会被执行。

 

<mkdir dir="${proj.classbindir}" />  <!-- 创建window文件夹，文件夹的名称为 dir属性值 -->

3.<mkdir>标签

该标签用于创建一个目录，它有一个属性dir用来指定所创建的目录名，${proj.classbindir}在property标签设置如下：

< property name = "proj.classbindir" value = "./WebRoot//WEB-INF/classes" / >

 

 

< jar destfile = "${proj.war}" encoding = "UTF-8" >
             < fileset dir = "${proj.srcdocroot}" >
             < / fileset >
< / jar >

4<jar>标签

该标签用来生成一个JAR文件，其属性如下。

(1) destfile表示JAR文件名。

(2) basedir表示被归档的文件名。

(3) includes表示被归档的文件模式。

(4) exchudes表示被排除的文件模式。

 

 

<javac destdir="${proj.classbindir}" debug="yes" verbose="no"
            encoding="UTF-8" source="1.5" failonerror="true" fork="true"
            memoryInitialSize="64m" memoryMaximumSize="256m" listfiles="true">
            <src path="${proj.src}/main/java" /> <!-- 编译源代码所在目录 E:\erp\src\main\java -->
            <include name="**/*.java" />
            <include name="**/*.xml" />
            <classpath refid="compile.classpath" />  <!-- 编译源代码所用到的第三方包所在的目录 -->
</javac>

5．<javac标签>

该标签用于编译一个或一组java文件，其属性如下。

(1).srcdir表示源程序的目录。

(2).destdir表示class文件的输出目录。

(3).include表示被编译的文件的模式。

(4).excludes表示被排除的文件的模式。

(5).classpath表示所使用的类路径。

(6).debug表示包含的调试信息。

(7).optimize表示是否使用优化。

(8).verbose 表示提供详细的输出信息。

(9).fileonerror表示当碰到错误就自动停止。  

 

 

6．<java>标签

该标签用来执行编译生成的.class文件，其属性如下。

(1).classname 表示将执行的类名。

(2).jar表示包含该类的JAR文件名。

(3).classpath所表示用到的类路径。

(4).fork表示在一个新的虚拟机中运行该类。

(5).failonerror表示当出现错误时自动停止。

(6).output 表示输出文件。

(7).append表示追加或者覆盖默认文件。

 

  < delete file = "${proj.war}" / >  

7.<delete>标签

该标签用于删除一个文件或一组文件，其属性如下。

(1)/file表示要删除的文件。

(2).dir表示要删除的目录。

(3).includeEmptyDirs 表示指定是否要删除空目录，默认值是删除。

(4).failonerror 表示指定当碰到错误是否停止，默认值是自动停止。

(5).verbose表示指定是否列出所删除的文件，默认值为不列出。

 

   < copy file = "${proj.war}" tofile = "${tomcat.deployhome}/erp.war" / >

8.<copy>标签

该标签用于文件或文件集的拷贝，其属性如下。

(1).file 表示源文件。

(2).tofile 表示目标文件。

(3).todir 表示目标目录。

(4).overwrite 表示指定是否覆盖目标文件，默认值是不覆盖。

(5).includeEmptyDirs 表示制定是否拷贝空目录，默认值为拷贝。

(6).failonerror 表示指定如目标没有发现是否自动停止，默认值是停止。

(7).verbose 表示制定是否显示详细信息，默认值不显示。

 

3.<mkdir>标签 4<jar>标签 5．<javac标签>  6．<java>标签 7.<delete>标签 8.<copy>标签只能写在target标签里面。

 

 

下面贴出一个简单的build.xml配置。

这个build.xml里target执行顺序是：根据第四个targerd的depends属性，找到它依赖的target，然后再找上个target依赖的target，最后找到最基础的那个target并执行它，这里也就是执行第一个target，它的作用是编译java项目里的java类、xml文件及其他相关配置文件放到项目的WebRoot/WEB-INF/classes的文件夹里去。然后执行第二个targer，把编译好的文件打包成一个war文件。第三步把war文件复制到tomcat的webapps目录下去。就这样，当我们启动服务器的时候，服务器得到的都是我们最新的编译后的代码。

 

详细:  http://baike.baidu.com/view/42824.htm#3

 

 

 

 

来自为知笔记(Wiz)