随笔 - 115  文章 - 481  trackbacks - 0
<2006年8月>
303112345
6789101112
13141516171819
20212223242526
272829303112
3456789

常用链接

留言簿(19)

随笔档案(115)

文章档案(4)

新闻档案(1)

成员连接

搜索

  •  

最新评论

阅读排行榜

评论排行榜

  在软件系统中,由于存在着各种各样的字符编码问题,比如另我们非常头痛的中文问题。因此,现在趋向于使用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文件的部分内容:
<?xml version="1.0" encoding="UTF-8"?>
<project name="EasyJF" default="usage" basedir="." xmlns:artifact="urn:maven-artifact-ant">
 <property file="easyjfbuild.properties" />
 <!--目录定义-->
 <property name="main.src.dir" value="${basedir}/src/main" />
 <property name="test.src.dir" value="${basedir}/src/test" />
 <property name="lib.dir" value="${basedir}/lib" />
 <property name="env.lib.dir" value="${lib.dir}/build/" />
 <property name="doc.dir" value="${basedir}/doc" />
 <property name="build.dir" value="${basedir}/build" />
 <property name="release.dir" value="${basedir}/release" />
 <property name="web.dir" value="${basedir}/webapps" />
 <property name="ide.dir" value="${basedir}/misc/ide" />
 <!--项目属性-->
 <property name="project.provider.name" value="easyjf" />
 <property name="project.name" value="jweb" />
 <property name="project.author" value="http://www.easyjf.com/" />
 <property name="project.version" value="0.6" />
 <!--发布文件名-->
….
  这里的问题是如何建一个UTF-8格式的build.xml文件。
错误的习惯:
  在通常情况下,我们习惯于使用windows下的记事本等工具直接编码xml文件内容,并另存为UTF-8格式,如下图所示:
 
  这种方式建立的build.xml文件是不正确的,最让人烦恼的是具有非常的不稳定性。这个不稳定性表现在一些系统下能正确使用,而一些系统下会出现类似如下的错误:

  D:\EasyJF\wlhy\bin>build.bat
  Buildfile: ..\build.xml
  BUILD FAILED
  D:\EasyJF\wlhy\build.xml:1: 缺少文件根组件
  Total time: 0 seconds
  请按任意键继续. . .
 
  这个错误也是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建立的脚本才是正确、稳定的。
(注:本文作者,EasyJF开源团队 大峡,转载请保留作者声明!)
posted on 2006-08-21 11:44 简易java框架 阅读(1643) 评论(4)  编辑  收藏

FeedBack:
# re: “中文问题没商量”之Ant中的中文问题  2006-08-21 12:47 Robin's Java World
这样的问题还用得了长篇大论吗???  回复  更多评论
  
# re: “中文问题没商量”之Ant中的中文问题  2006-08-21 14:37 李李
即使是文本编辑器也很少见用记事本来写的,效率不高
推荐高效的方法,用UltraEdit,File/文件-->Convert/转换 这里你想怎么转都可以  回复  更多评论
  
# re: “中文问题没商量”之Ant中的中文问题  2006-08-21 21:07 建议找本xml的入门读物
倒......
在ant文件的xml注释里搞个中文说明也要来摆一摆........  回复  更多评论
  
# re: “中文问题没商量”之Ant中的中文问题  2009-01-06 11:33 去死吧大陸人
@建议找本xml的入门读物

回文的死大陸人 都愛自以為很厲害
人家po這篇關你屁事  回复  更多评论
  

只有注册用户登录后才能发表评论。


网站导航: