你走你的阳光道，我走我的独木桥:整合ant ivy 和testng

    近期自己折腾自己，放着正统的maven + junit不用，却准备用ant + ivy 替代maven做依赖管理，用testng替代junit做单元测试。

    现在要做的工作，其实很简单，就是ant的脚本中，搞定相关的target: 编译，运行单元测试。

    需要的步骤大体如下：

1. ivy 做依赖解析，得到所有依赖的jar包，以便生成编译源码需要的classpath路径

这里很重要的一点，是需要区分开编译正常代码的classpath和编译测试代码的classpath，因为通常情况下testcase需要一些特殊的依赖如juni,testng之类的测试框架，easymock,jmock之类的mock工具。

2. 编译代码和测试案例

3. 运行testng 来执行testcase

    分别来看三者的实现。

1) ivy解析依赖

ant代码如下:

     < target  name ="ivy.resolve"  description ="--> resolve project dependencies by ivy" >
         < echo > resolve dependencies of project "${ant.project.name}" by ivy </ echo >
         < ivy:resolve  />

         < ivy:cachefileset  setid ="ivy.cachefileset.compile"  type ="jar,bundle"  conf ="compile"   />

         < ivy:cachefileset  setid ="ivy.cachefileset.test"  type ="jar,bundle"  conf ="test"   />
     </ target >

用到了ivy标准的resolve 任务，然后再用cachefileset来获取需要的文件列表，以备后面使用。注意type要写成"jar,bundle"，因此目前的依赖包虽然扩张名都是jar，但是它的ivy类型定义确有可能为bundle(都是OSGI惹得祸)。还有上面用了两次cachefileset任务，conf不同。

2) 编译代码和测试案例

< target  name ="compile.compile"  depends ="ivy.resolve"   >
         < echo > compile project ${ant.project.name}  </ echo >
         < compile_source_main  />
         < compile_source_test  />
     </ target >

     < macrodef  name ="compile_source_main" >
         < sequential >
             < echo > compile java classes in project ${ant.project.name}  </ echo >
             < echo > classpath is : ${project.classpath.compile.ivy.lib} </ echo >
             < delete  dir ="${dir.target.bin.main}"   />
             < mkdir  dir ="${dir.target.bin.main}"   />
             < javac  debug ="true"  srcdir ="${dir.src.main.java}"  destdir ="${dir.target.bin.main}"  target ="1.5"  includeAntRuntime ="false" >
                 < classpath >
                     < pathelement  location ="${dir.src.main.resources}"   />
                     < fileset  refid ="ivy.cachefileset.compile"   />
                 </ classpath >
             </ javac >
         </ sequential >
     </ macrodef >

     < macrodef  name ="compile_source_test" >
         < sequential >
             < echo > compile java testcase in project ${ant.project.name}  </ echo >
             < echo > classpath is : ${project.classpath.test.ivy.lib} </ echo >
             < delete  dir ="${dir.target.bin.test}"   />
             < mkdir  dir ="${dir.target.bin.test}"   />
             < javac   debug ="true"  srcdir ="${dir.src.test.java}"  destdir ="${dir.target.bin.test}"  target ="1.5"  includeAntRuntime ="false" >
                 < classpath >
                     < pathelement  location ="${dir.src.test.resources}"   />
                     < pathelement  location ="${dir.src.main.resources}"   />
                     < pathelement  location ="${dir.target.bin.main}"   />
                     < fileset  refid ="ivy.cachefileset.test"   />
                 </ classpath >
             </ javac >
         </ sequential >
     </ macrodef >

注意这里用到classpath时，是在上面得到的ivy cachefileset的基础上，增加其他路径才得到最终的classpath。曾经在这里折腾了不少时间，因为开始是用ivy的cacheclasspath任务直接拿到一个classpath，然后在这里发现单有这个classpath是不够的。可是又没有找到如何从一个classpath生成一个更多内容的classpath的方法(郁闷，ant里面的classpath似乎不支持这种classpath=***+***+classpath的算法，或者是我笨没有找到)。最后只好改用cachefileset来获取fileset，然后自己增加其他路径。典型如编译测试案例时，必须将前面编译好的class作为classpath的一部分增加。从这种角度讲，ivy的cacheclasspath任务是用处不大的，实用的是cachefileset任务。

3) 运行testng

首先需要初始化testng，引入testng的任务。

     < target  name ="testng.init"  depends ="ivy.resolve" >
         < taskdef  resource ="testngtasks" >
             < classpath >
                 < fileset  refid ="ivy.cachefileset.test"   />
             </ classpath >
         </ taskdef >
     </ target >

在具体执行testng时，有两种选择：

1. 通过testng.xml指定具体的测试案例

应该说testng对此有非常强大而富有弹性的支持，通过testng.xml可以指定不同的package，class，可以指定exclude，可以分组，还有其他高级特性。

2. 运行所有案例

使用testng.xml文件的前提是项目有提供testng.xml文件，对于一些简单的项目，可能只是简单的希望执行所有testcase，因此就需要在运行检测testng.xml文件存在与否。

     < target  name ="testng.test"  depends ="testng.init" >
         < if >
             < resourceexists >
                 < file  file ="${dir.src.test.java}/testng.xml"   />
             </ resourceexists >
             < then >
                 < run_testng_with_xml  />
             </ then >
             < else >
                 < run_testng_without_xml  />
             </ else >
         </ if >
     </ target >

testng.xml存在时，通过xmlfileset来调用testng任务:

     < macrodef  name ="run_testng_with_xml" >
         < sequential >
             < echo > run testng to test project "${ant.project.name}". </ echo >
             < echo > found ${dir.src.test.java}/testng.xml, use it to run testng. </ echo >
             < delete  dir ="${dir.target.testng.testoutput}"   />
             < testng  outputDir ="${dir.target.testng.testoutput}"  haltOnfailure ="true" >
                 < xmlfileset  dir ="${dir.src.test.java}"  includes ="testng.xml"   />
                 < classpath >
                     < pathelement  location ="${dir.src.test.resources}"   />
                     < pathelement  location ="${dir.src.main.resources}"   />
                     < pathelement  location ="${dir.target.bin.test}"   />
                     < pathelement  location ="${dir.target.bin.main}"   />
                     < fileset  refid ="ivy.cachefileset.test"   />
                 </ classpath >
             </ testng >
         </ sequential >
     </ macrodef >

testng.xml不存在时，通过classfileset来指定需要执行的class:

     < macrodef  name ="run_testng_without_xml" >
         < sequential >
             < if >
                 < resourcecount  when ="greater"  count ="0" >
                     < fileset  dir ="${dir.target.bin.test}"  includes ="**/*.class"   />
                 </ resourcecount >
                 < then >
                     < echo > run testng to test project "${ant.project.name}". </ echo >
                     < echo > ${dir.src.test.java}/testng.xml not found, default to run all the testcase. </ echo >
                     < delete  dir ="${dir.target.testng.testoutput}"   />
                     < testng  outputDir ="${dir.target.testng.testoutput}"  haltOnfailure ="true" >
                         < classfileset  dir ="${dir.target.bin.test}"  includes ="**/*.class"   />
                         < classpath >
                             < pathelement  location ="${dir.src.test.resources}"   />
                             < pathelement  location ="${dir.src.main.resources}"   />
                             < pathelement  location ="${dir.target.bin.test}"   />
                             < pathelement  location ="${dir.target.bin.main}"   />
                             < fileset  refid ="ivy.cachefileset.test"   />
                         </ classpath >
                     </ testng >
                 </ then >
                 < else >
                     < echo > no testcase exist in "${dir.target.bin.test}", nothing to do for testng. </ echo >
                 </ else >
             </ if >
         </ sequential >
     </ macrodef >

注意这里有个检测，判断是否有测试案例存在，如果没有写测试案例，则跳过testng任务的执行，否则如果classfileset为空，testng即得不到testng.xml的输入，也得不到classfileset的输入，会直接报错的，因此需要避免因为没有测试案例导致test失败进而整个build都失败的情况。

OK，上述三板斧下去，基本ant + ivy + testng就可以完成整合，一起跑起来了。敲一个ant test下去，就可以依赖解析，编译，执行testcase的全套过程。过程比maven + junit复杂多了，主要是一切都要自己动手，不过完成之后的效果似乎还不错。上述的过程对于一般项目都是通用的，因此以后就可以偷懒了。