Ant使用[待整理]

Ant真是太方便了，以前都没注意到它。功能很强大，能创建数据库，配置服务器，部署发布应用……只需要写好build.xml文件，剩下的就交给ant来 “安装”你的WEB应用了。

Appfuse的第一个ant命令是ant new，其任务是建立一个新命名的project，少不了会复制很多文件。build.xml中也有很多copy操作，为了搞清楚ant new到底干了些什么事，还是先把copy操作了解一下。看了会ant的DOCS，网上也找了些文章，发现copy这部分都是一带而过，讲得很浅，于是我就只有自己实验下，发现还有点收获。 ant版本为1.6.5。

1. 拷贝单个文件到指定目录下。
例：<copy todir="${basedir}/new" file="${basedir}/old/old1.txt1">
将${basedir}/old /old.txt文件拷贝到${basedir}/new下

2. 拷贝一批文件到指定目录下
例：<copy todir="${basedir}/new">
           <fileset dir="${basedir}/old">
              <include name="old1.txt" />
              <include name="old2.txt" />
              <exclude name="old8.txt" />
          </fileset>
       </copy>
      这里fileset定义的是原文件的组成形式，<include/>子属性表示包括，<exclude/>子属性表示排除，很简单，通过他们组合实现多文件的筛选，当然我这个例子用得很傻。比如
                <include name="appgen/**"/>
                <include name="ibatis/**"/>
                <exclude name="**/*.log"/>
      拷贝appget目录和ibatis目录下除了.log文件以外的其它所有文件和子目录。

      可以把<fileset/>简写成<fileset dir="${basedir}/old" includes="old1.txt,old2.txt" />，includes可以理解成include的复数形式，包含多个文件时用逗号隔开，excludes也一样。

3. 拷贝一个目录到指定目录下
例：<copy todir="${basedir}/new">
           <fileset dir="${basedir}/old">
             <include name="appgen" />
             <include name="appgen/" />
             <include name=appgen/**" />
             <include name="appgen/***" />
           </fileset>
       </copy>
      同样使用<fileset/>属性，name指定目录名，不过这里要分两种情况，用<include/>子属性和不用<include/>子属性.
      若使用<include/>， 又要分三种情况
          若是“appgen”，则只会拷贝名为appgen的空目录过去，它里面的文件和子目录则不会拷贝。
          若是“appgen/”，或“appgen/**”，则会把整个appgen目录拷贝过去，包括里面的文件和子目录。
          若是“appgen/*”，则只会把该目录和该目录下第一级子目录的所有东西拷贝过去，而不会拷贝第二级和第二级以下的。注：“appgen/*”这儿是一个*号，*号若大于两个，也跟一个*号是同样效果。比如“appgen/*”和“appgen/****”都只拷贝appgen目录下第一级子目录。

注：若appeng这个目录本身就是个空目录，无论怎么写，这个空目录都不会被拷贝。也就是说，copy操作不会产生创建空目录的作用，要想创建空目录，只有用mkdir。

      若不使用任何<include>属性，如
           <fileset dir="${basedir}/old">
           </fileset>
      则会拷贝${basedir}/old下的所有文件和子目录。

注：使用<exclude/>排除目录时，目录名必须写成 “appgen/”或“appgen/**”形式，否则不会生效。

      以上是三种拷贝到目录的种类，注意如果计算机中没有 todir指定的路径，ant将会自动创建这个路径。

4. 拷贝单个的文件：
〈copy tofile="old.txt" file="new.txt" /〉就这么简单就行了。
当然也可以写成
  <copy tofile="${basedir}/new/new.txt">
     <fileset dir="${basedir}/old" includes="old.txt" />
  </copy>
      这里includes就只能写一个文件，不能写上多个文件，因为不能将多个文件复制到一个文件中去，所以这样麻烦的写法是没有意义的。



      复制肯定还要涉及到同名覆盖的问题，ant在copy类的API中说明：Files are only copied if the source file is newer than the destination file，这里的newer是指文件的修改时间，即使你在修改时文件内容没有任何变化，只是导致修改时间变了，ant同样会覆盖同名文件，也就是说，ant不会检查文件内容。

      对于是复制目录的情况，由于目录没有修改时间，ant还是通过检查目录内文件的修改时间来决定是否覆盖的，若目录内某文件修改时间有变化，则会覆盖这个文件，而不是整个目录。







ant的jar打包的target
Java 代码

   1. <project name="client" default="compile" basedir="."> 
   2.     <property name="product" value="client"/> 
   3.     <property name="version" value="1.0"/> 
   4.     <property name="src.dir" value="${basedir}/src"/> 
   5.     <property name="build.dir" value="${basedir}/build"/> 
   6.     <property name="lib.dir" value="${basedir}/lib"/> 
   7.     <property name="jar.file" value="${product}.${version}.jar"/> 
   8.  
   9.     <path id="classpath"> 
  10.         <fileset dir="${lib.dir}"> 
  11.             <include name="**/*.jar"/> 
  12.         </fileset> 
  13.     </path> 
  14.  
  15.     <target name="clean"> 
  16.         <echo>clean build dir</echo> 
  17.         <delete dir="${build.dir}" quiet="true"/> 
  18.         <delete file="${lib.dir}/${jar.file}" quiet="true"/> 
  19.     </target> 
  20.  
  21.     <target name="init" depends="clean"> 
  22.         <mkdir dir="${build.dir}"/> 
  23.     </target> 
  24.  
  25.     <target name="compile" depends="init"> 
  26.         <echo>compile the source</echo> 
  27.         <javac srcdir="${src.dir}" destdir="${build.dir}"> 
  28.             <include name="**/*.java"/> 
  29.             <classpath refid="classpath"/> 
  30.         </javac> 
  31.     </target> 
  32.  
  33.     <target name="jar" depends="compile"> 
  34.         <jar destfile="${lib.dir}/${jar.file}"> 
  35.             <fileset dir="${build.dir}"> 
  36.                 <include name="**/*.class"/> 
  37.             </fileset> 
  38.             <manifest> 
  39.                 <attribute name="Main-Class" value="Demo"/> 
  40.                 <attribute name="Class-Path" value="axis.jar commons-discovery-0.2.jar commons-logging.jar jaxrpc.jar saaj.jar wsdl4j-1.5.1.jar"/> 
  41.             </manifest> 
  42.         </jar> 
  43.     </target> 
  44.  
  45.     <target name="run" depends="jar"> 
  46.         <java jar="${lib.dir}/${jar.file}" fork="yes"> 
  47.         </java> 
  48.     </target> 
  49. </project> 

<project name="client" default="compile" basedir=".">
    <property name="product" value="client"/>
    <property name="version" value="1.0"/>
    <property name="src.dir" value="${basedir}/src"/>
    <property name="build.dir" value="${basedir}/build"/>
    <property name="lib.dir" value="${basedir}/lib"/>
    <property name="jar.file" value="${product}.${version}.jar"/>

    <path id="classpath">
        <fileset dir="${lib.dir}">
            <include name="**/*.jar"/>
        </fileset>
    </path>

    <target name="clean">
        <echo>clean build dir</echo>
        <delete dir="${build.dir}" quiet="true"/>
        <delete file="${lib.dir}/${jar.file}" quiet="true"/>
    </target>

    <target name="init" depends="clean">
        <mkdir dir="${build.dir}"/>
    </target>

    <target name="compile" depends="init">
        <echo>compile the source</echo>
        <javac srcdir="${src.dir}" destdir="${build.dir}">
            <include name="**/*.java"/>
            <classpath refid="classpath"/>
        </javac>
    </target>

    <target name="jar" depends="compile">
        <jar destfile="${lib.dir}/${jar.file}">
            <fileset dir="${build.dir}">
                <include name="**/*.class"/>
            </fileset>
            <manifest>
                <attribute name="Main-Class" value="Demo"/>
                <attribute name="Class-Path" value="axis.jar commons-discovery-0.2.jar commons-logging.jar jaxrpc.jar saaj.jar wsdl4j-1.5.1.jar"/>
            </manifest>
        </jar>
    </target>

    <target name="run" depends="jar">
        <java jar="${lib.dir}/${jar.file}" fork="yes">
        </java>
    </target>
</project>


当用java -jar yourJarExe.jar来运行一个经过打包的应用程序的时候，会发现如何设置-classpath参数应用程序都找不到相应的第三方类，报ClassNotFound错误。实际上这是由于当使用-jar参数运行的时候，java VM会屏蔽所有的外部classpath,而只以本yourJarExe.jar的内部class作为类的寻找范围,因此当使用-jar执行可执行Jar包时,JVM将Jar包所在目录设置为codebase目录,所有的class搜索都在这个目录下开始.所以如果使用了其他第三方的jar包, 一个比较可以接受的可配置方案,就是利用jar包的Manifest扩展机制.
步骤如下:
1.将需要的第三方的jar包,复制在同可执行jar所在的目录或某个子目录下. 比如:jar 包在 /usrhome/yourJarExe.jar 那么你可以把所有jar包复制到/usrhome目录下或/usrhome/lib 等类似的子目录下.
2.修改Manifest 文件
在Manifest.mf文件里加入如下行
Class-Path:classes12.jar lib/thirdlib.jar
Class-Path 是可执行jar包运行依赖的关键词

如果要强行覆盖，<copy/>有个 overwrite属性，默认为false，改成true就行了