ant 缺少文件根组件

最近用eclipse执行一build.xml，

发现ant1.6.2版本提示The copy type not support the nested chainedmapper element

google一下，提示版本过低，

http://www.open-xchange.com/forum/archive/index.php/t-544.html

换ant 1.7.0试下，

却提示缺少java.util.zip.zipException（apache-ant-1.7.0，可能跟build的具体的工程有关 ）．

接着再换了个ant 1.6.5 . 发现提示＂缺少文件根组件＂，

用eclipse自带的ant（1.6.5）也是这样的提示．

google一下，找到下面的文章．

其中发现了一个细节，在查看该build.xml文件的属性时，发现在Text file encoding下面比其它普通的多了一行介绍性文字．．普通的都只有两行．莫非真是格式的问题．

把一个其它项目的可以运行良好的build.xml文件复制过来，然后，用现有的build内容，替换掉复制过来文件里面的内容．　　然后再运行．即ok了。　问题原因可参考下面的文章．

／／－－－－－－－－－－－－－－－－－－－－－－－－－－－－

“中文问题没商量”之Ant中的中文问题

来源：javajia

在软件系统中，由于存在着各种各样的字符编码问题，比如另我们非常头痛的中文问题。因此，现在趋向于使用UTF-8编码作为软件中通过编码格式，从而可以避免大多数字符编码的问题。本文跟《80前》一文一样，以Spring项目无关，请“春迷”们自重、没事勿扰，文中不足之处欢迎大家批评指教。

　　在Java开发中，我们经常使用Ant来编译及打包项目。默认情况下Ant会去调用一个名为build.xml文件，文件中定义了相关的单元及任务等，可以根据用户命令执行相应的任务单元。
　　比如，在很多开源项目如Spring、webwork、EasyJWeb、EasyDBO等，其根目录下都有一个build.xml文件。
在国外的开源项目中，build.xml文件中的内容全部是英文字符，因此build.xml使用普通的ANSI或UTF-8或GBK都没问题，也不会遇到字符编码问题。而对于国产的开源项目EasyJWeb、EasyDBO来说，为了方便国内的用户，肯定在文件会包含一些中文说明。而默认情况下包括中文字符，格式为ANSI的build.xml文件是无法正确运行的，这应该跟本人所写的Dom4j的原因类似。
　　此时，我们需要把build.xml文件改成UTF-8格式，并指定xml文件的格式为utf-8。如下面是EasyJWeb开源项目中build.xml文件的部分内容：
< ?xmlversion="1.0"encoding="UTF-8"?>< projectname="EasyJF"default="usage"basedir="."xmlns:artifact="urn:maven-artifact-ant">
< propertyfile="easyjfbuild.properties"/>
< !--目录定义-->
< propertyname="main.src.dir"value="${basedir}/src/main"/>
< propertyname="test.src.dir"value="${basedir}/src/test"/>
< propertyname="lib.dir"value="${basedir}/lib"/>
< propertyname="env.lib.dir"value="${lib.dir}/build/"/>
< propertyname="doc.dir"value="${basedir}/doc"/>
< propertyname="build.dir"value="${basedir}/build"/>
< propertyname="release.dir"value="${basedir}/release"/>
< propertyname="web.dir"value="${basedir}/webapps"/>
< propertyname="ide.dir"value="${basedir}/misc/ide"/>
< !--项目属性-->
< propertyname="project.provider.name"value="easyjf"/>
< propertyname="project.name"value="jweb"/>
< propertyname="project.author"value="http://www.easyjf.com/"/>
< propertyname="project.version"value="0.6"/>
<!--发布文件名-->
….
　这里的问题是如何建一个UTF-8格式的build.xml文件。
错误的习惯：
　　在通常情况下，我们习惯于使用windows下的记事本等工具直接编码xml文件内容，并另存为UTF-8格式，如下图所示：

　　这种方式建立的build.xml文件是不正确的，最让人烦恼的是具有非常的不稳定性。这个不稳定性表现在一些系统下能正确使用，而一些系统下会出现类似如下的错误：

　　D:\EasyJF\wlhy\bin>build.bat
　　Buildfile:..\build.xml
　　BUILDFAILED
　　D:\EasyJF\wlhy\build.xml:1:缺少文件根组件
　　Totaltime:0seconds
　　请按任意键继续...

　　这个错误也是EasyJF团队中的williamRaym在写EasyJWeb的build脚本时发现的，而且后来又很多网友反映类似的错误，如当前EasyJF下的iula项目就存在这个问题：
http://www.easyjf.com/html/bbs/20060814/1208824819851986.htm
　　（也许是我的机器容错性好，不会报错，呵呵!）。
　　
正确的方法：
　　前面说了，用记事本建立UTF-8格式的xml文件是不正确的，经过我们多次实践，正确的方法之一是使用Eclipse来建这个xml文件，在建立工程的时候需要把整个工程的字符集设置成为UTF-8，然后直接建立一个build.xml文件，默认情况下该文件以UTF-8的格式保存。
　　这样建立起来的脚本文件，使用Ant的时候，不管build.xml中包含什么中文字符，都能正常运行。当然，应该还可以用其它的开发工具建立UTF-8格式的文件，还请大家来试验。另外也可以用JAVA自己写一个小程序来把ANSI格式的文件转成UTF-8文件，这样也没问题。

小结：
　　之所以很多开源项目的build过程中不会存在问题，是因为他的脚本文件中没有包含中文字符或其它字符。面在国产开源项目中，由于存在中文注释、说明等，所以在建立build.xml文件的时候需要作一些特殊的处理，使用UTF-8格式的文件。当然，本文还重点提出了两种建立UTF-8文件的方法，其中用记事本是不稳定的，错误的；而用专业Java开发工具或JDK建立的脚本才是正确、稳定的。