给编程狂热者的ant task笔记

这篇文档是专门写给那些编程狂热者，在Ant里编程时要留意的重要Task。

    不知为何，老外的各种脚本都写得格外漂亮。从Appfuse里学到很多，在编写SpringSide2.0的构件安装脚本时又被迫自学了不少，这里作下总结。

    如果只说一样最重要的事情，就是ant-contrib的<if> 和 <for>节点，使Ant 拥有了完整的编程能力。

1. 变量

   Ant里的变量有个诡异的特性----一旦被赋值就不会改变，这个特性有时候帮助很大，有时候让人很苦恼，一定要注意。另一样要注意的是，Ant里的变量和其他语言的变量一样，有可效范围。

   1.由命令行赋值

      ant build.xml -Dtomcat.home=foo

   2.与用户交互输入--Input task

      <input message="请选择一个Target "
               validargs="compile,jar,test"
               addproperty="my.input"/>

3.从propertis文件读取并存盘 -- propertyfile task   

      <propertyfile file="my.properties">
              <entry key="springside.home" default="."/>
      </propertyfile>

      如果my.properties 不存在，生成my.properties文件，springside.home=.。有一个特别有用的地方：有些properties文件的属性每个开发者都不同，不想放入svn，但又想初始化数值，可以用该命令。

     <propertyfile file="my.properties">
              <entry key="springside.home" value="....."/>
      </propertyfile>

      重新写入配置文件。

2. 流程控制

     如果没有ant-contrib 贡献的<if> 和<for>节点，Ant的可编程性是极低极低的。

2.1 if task

ant原来可以在target级进行if判断(unless,if 属性)，但实在太不方便了。

2.2 Conditions

但Ant预先封装的一堆condition很是很方便的。这些condition完全从实际出发，包括文件是否存在，http://localhost:8080是否连通都可以作为条件，见Ant的参考手册。

2.3 For task

支持"a,b,c,d" 字符串数组的循环与文件目录，Fileset的循环。

2.4 Parallel task

Parallel非常有用，比如我想一边开tomcat，一边做别的，就需要使用它，否则就只有用spawn=true属性把tomcat放在后台运行。spawn有很多不好的地方，比如不能即时在console看到信息，停止ant运行不能把tomcat关掉等。

Parallel相当于一个容器，放在里面的每个task都会被并行执行。如果想把某几个task顺序执行，用相当于()的Sequential task 包起来。

2.5 Waitfor task

暂停ant执行直到条件符合，比如<waitfor><http url=http://localhost:8080/></waitfor>就会等待tomcat启动后才会继续往下执行。Macrodef task

3. 代码封装

ant 代码最基本的封装是

1. ant  task：调用其他脚本的任务，可设定dir 与是否继承本脚本的变量。

2. antcall task：调用本脚本内其他task，可设置参数。

3. import task ：就像其他语言的include一样，引入其他脚本内容到本脚本里。

1. AntFetch,  AntCallBack task

   ant-contrib贡献，对应于Ant 与 AntCall。原版只能向被调用函数传递变量，函数执行后没办法return 值。antcallback的语法如下
   <antcallback target="mytarget" return="myresult1,myresult2"/>

2. Macrodef task

   作为最小的封装单位，与以<target>封装再<antcall target="xxx">调用差不太远，细微之处自行体验了。个人比较喜欢用macrodef。

3. Java task 与 Exec task 直接执行Java类或程序

   注意执行目录的定义。另在Windows下如果要直接运行dos窗口中的命令，以下指令启动默认浏览器访问localhost：

   <exec executable="cmd.exe">
      <arg line="/c start http://localhost:8080>
   </exec>   "/

4. 扩展Ant的Task

   扩展ant task很简单，实现execute() 方法执行task，实现setter接口让ant框架执行属性注入。继承Task 获得一些ant的能力，比如查询某个变量的值。

   稍微有点麻烦的是多层嵌套属性的注入。详细请看http://ant.apache.org/manual/developlist.html

   SpringSide 2.0 里很简单的实现了一个XML File Merge的task，见XmlMergeTask.java。

   里面的一个教训是如果变量是文件或路径，需要把变量声明为java.io.File或者org.apache.tools.ant.types.Path，Ant才会在注入时为相对路径加上project.basedir。

   蛋蛋 说扩展Ant的最方便的方法还是在ANT里嵌套脚本。导入BSF库以后，你就可以用BSF支持的脚本语言了(见Script Task)。接下来有机会尝试一下。


5. 文件操作

  刚好springside里进行了比较多的文件操作，随便记一下。

  replace 与 copy 时加入filter, 都可以进行字符串替换.

  concat在文件末添加其他文件的内容。

  好困，很多东西没写详细，明天再补充。

  题外话，Ant 完整演示了如何编写XML式的代码，虽然对于开发人员来说XML编码非常麻烦，远远没有Ruby的rake以ruby代码本身来构建系统清晰，但对于IDE，特别是希望图形化编程的IDE来说，XML比普通代码要容易渲染得多，所以普元EOS的图形化编程也是序列成XML代码。再另外，Ant的task 和 普元的构件也有相似