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”菜单进行统一设置,并设成报表的默认字体。