iReport与JasperReport中文支持全面解决

 iReport与JasperReport中文支持全面解决

     在使用iReport与JasperReport作为报表产生工具时, 中文支持是经常遇到的问题,笔者最近做的一个J2EE Web项目采用这套工具开发报表,也遇到了类似问题,本文总结了在使用iReport与JasperReport开发报表时中文支持的有关内容,希望能对读者有所帮助.
1 运行环境
    1.1 JasperReport 1.2.8
    JasperReports是iReport的核心内容。它是一个强有力的开源报表产生工具，可以将内容输出到屏幕上、打印机或生成PDF, HTML, XLS, CSV和XML等文件。它完全用Java编写，并可在各种Java应用（包括J2EE或WEB应用）中用来产生动态报表内容。JasperReports组织根据在一个XML文件中定义的报表设计通过JDBC访问关系数据库中的数据.填充报表数据之前必须先将报表设计被编译成一个jasper文件。
下载地址: http://jasperreports.sourceforge.net/
    1.2 iReport 1.2 8
    iReport是一个制作Jasperreport XML文件的优秀可视化开发工具，通过它可以方便的设计报表模板。目前最高版本为iReport 1.3.0
下载地址: http://ireport.sourceforge.net
   1.3 iText 1.3.1
   iText是一个开放源码的Java类库，是用来生成PDF文件的。
下载地址: http://itext.sourceforge.net
   1.4 iTextAsian.jar
   如果要在生成的pdf文件显示中文等亚洲字符，还必须下载itext的亚洲字符包。
下载地址: http://itextdocs.lowagie.com/downloads/iTextAsian.jar
以上四个包必须加到应用程序的构建路径中或加到CLASSPATH，若是Web应用放入相应的WEB-INF/lib/中。
2 设置中文支持
    为了在报表中能够显示中文,加入以上四个包还不够(因为以上四个包仅对报表生成及中文显示提供了支持),必须设置报表上各显示对象的相关属性,各属性设置说明如下:
    Font        name:    宋体 (中文字体)
    PDF font name:   STSong-Light
    PDF  Encoding:  UniGB-UCS2-H(Chinese Siplified)
    PDF   Embeded: √
    如下图所示(显示对象的属性设置):
 
    注意:此三项的设置必须确保iTextAsian.jar亚洲语言包已经包含在项目中,否则出现编译错误.
    若读者觉得对每一个对象设置比较麻烦,可通过iReport的”Format””Fonts”菜单进行统一设置,并设成报表的默认字体。如下图所示:
 
３可能出现的问题
   经过以上的设置,报表中文的显示应该没什么问题了,笔者在报表的开发过程中遇到几个问题，现总结如下：
  3.1 问题描述
   在WinXp中运行iReport1.2.8，设计报表时将数据字段的字体设置成中文字体，调好格式后编译并运行,并使用JRViewer进行预览一切正常(中文显示正常),但使用PDF、Excel预览出现如下错误:
   Could not load the following font :
   pdfFontName   : STSong-Light
   pdfEncoding   : UniGB-UCS2-H
   isPdfEmbedded : true
   产生原因:成成PDF的亚洲语言包没有包含到项目中
   解决办法:将亚洲语言包iTextAsian.jar包含到项中,可能过iReport的”Options””Classpath”将iTextAsian.jar添加Classpath中或者直接将iTextAsian.jar复制到iReport安装目录下的lib中.若是Web项目则应该将iTextAsian.jar复制到此项目的WEB-INF/lib/中.
   3.2 问题描述
    在WinXp中运行iReport1.2.8，设计报表时将数据字段的字体设置成中文字体，调好格式后编译并运行,并使用JRViewer进行预览一切正常(中文显示正常),使用PDF、Excel预览时无任何错误,但中文无法显示(只显示空白).
    产生原因:报表显示对象的PDF字体属性设置不正确
    解决办法: 报表对象有关字体属性的设置如下:
    Font        name:         宋体 (中文字体)
    PDF font name:  STSong-Light
    PDF Encoding:   UniGB-UCS2-H(Chinese Siplified)
    PDF Embeded:  √
   即如下图所法
 
   3.３问题描述
    生成PDF、Excel文件时,中文显示一切正常,但生成Html文件时显示乱码
　产生原因：主要是网页编码问题
    解决方法
　在JSP页中生成Html时,设置 <%@ page contentType="text/html;charset=GB2312" %>　
　在Servlet中生成Html时,response.setContentType("text/html;charset=GB2312");
 　若用户对项目进行了统一编码设定及过滤,则需要另作考虑,但主要还是集中在编码问题上.例如:笔者最近做的项目是其于Struts的,对编码进行了统一和过滤处理,生成Html页面时无需指编码就可正确生成Html页面,并不会出乱码,若设置成charset=GB2312反而出现了乱码.总之,对编码的统一与处理还是比较嘛烦的事.
    另外, 我们通过查看iReport生成的jrxml()文件可以发现, iReport保存的汉字都是UTF-8编码。了解它的编码可以有助于我们统一编码方式。

　最后,非常感谢开源项目给我们带来的启发与益处!

2007.01.04晚写于昆明理工大学信自学院智能信息系统实验室 刘利军