作者:江南白衣
这篇文档是专门写给那些编程狂热者,在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一样,引入其他脚本内容到本脚本里。
ant-contrib贡献,对应于Ant 与 AntCall。原版只能向被调用函数传递变量,函数执行后没办法return 值。antcallback的语法如下
<antcallback target="mytarget" return="myresult1,myresult2"/>
作为最小的封装单位,与以<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 和 普元的构件也有相似。