> 设为首页 加入收藏 关于我们
 
 
首页 新闻 技术 教程 框架 源码 服务中心  
 
 
  合作 MyRSS 博客 wiki 社区
 
信息搜索: 全部网站 easyjf.com
  当前位置:首页-其它
“中文问题没商量”之Ant中的中文问题
作者:大峡 来源:www.easyjf.com  发布时间:2006-08-19
 
  在软件系统中,由于存在着各种各样的字符编码问题,比如另我们非常头痛的中文问题。因此,现在趋向于使用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开源团队 大峡,转载请保留作者声明!)

评论】 【加入收藏】 【推荐给朋友】 【字体:  】 【关闭 
 
团队常用资源链接
《EasyJF办公室及联系方式》
《如何参与EasyJF开源工作》
EasyJF协同及版本控制-SVN
《EasyJF团队章程》
《EasyJF团队成员工作手册》
《EasyJF成员名单》
《EasyJF项目列表》
《EasyJF开源基金赞助名单》
 
 
EasyJWeb
EasyJWeb是基于
java技术,应用于
WEB应用程序快速
开发的MVC框架,
框架设计构思来源于国内众多项
目实践,框架旨在借鉴当前主要
流行的开源Web框架(Struts、
JSF、Tapestry 、Webwork),吸
取其优点及精华,利用
Velocity作为模板页面引擎,实
现页面及代码完全分离的MVC开发
取框架。
EasyJF开源CMS
EasyJF开源CMS
有常用CMS系统的
基本功能,另外还
有自动html文件生
成、AJAX级联菜单、积分系统、
权限管理等功能,支持UBB。该论
坛系统使用基于OO的方法设计,
采用多层B/S构架,数据库持久层
使用Hibernate,Web层使用
Struts框架,java代码与页面
完全分离,易扩展。
EasyJF开源博客系统
EasyJF开源博客系
统基本的博客的书
写、博客圈、流量
统计、排名、个人
像册、音乐、专题等功能。支持
自定义模板、静态html文件生成
、服务器集群、权限系统、积分
系统等。系统使用基于OO的方法
设计,采用多层B/S构架,数据库
持久层使用EasyDBO,Web层使用
EasyJWeb框架,java代码与页面
完全分离,易扩展。
EasyDBO
EasyDBO是一个非
常适合中小型软件
数据库开发的数据
持久层框架,系统
参考hibernate、JDO等,结合中
小项目软件的开发实际,实现简
单的对象-关系数据库映射。

友情连接
Java研究组织(JR)  与JAVA共舞  java视野   Java开源大全   BlogJava      Jdon解道 SpringSide   天乙论坛   CowNew开源团队  AgileJava开源   javathinker   CSDN Java频道  赛迪网Java频道  
中国Eclipse社区   Java家   Java中文站 FireFox中锁文网   java天下   ideagrace   解惑

Copyright (C) 2005 EasyJF.com, All Rights Reserved
版权所有 简易java框架网

渝ICP备06004507号 如有意见请与我们联系 Powered by EasyJFramework