作者:江南白衣

   这篇文档是专门写给那些编程狂热者,在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. AntFetchAntCallBack task

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

2. Macrodef task

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

3. Java taskExec 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。

   蛋蛋 说扩展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 和 普元的构件也有相似。