JasperReport使用iText库来生成PDF，对于中文字体的支持的两种方式

JasperReport使用iText库来生成PDF，报表中包括两种字体设置：报表字体和PDF字体。报表字体用于其他形式的报表的字体设置，而PDF字体用于到处的PDF中的字体设置。PDF字体信息将传递给iText，由iText根据不同的字体设置，形成PDF。如果不进行特殊的设置，报表在导出PDF以后，其中的中文信息显示不出来。针对这个问题，提供两种解决方案。

iText对字体的支持，包括多种方式，详见：http://itextdocs.lowagie.com/tutorial/fonts/getting/index.html。对于中文字体的支持，我们介绍两种方式：

1.使用iTextAsian.jar

iTextAsian.jar是一个亚洲字体包，里面包含几种简单的亚洲字体，其中包含简体中文字体。使用iTextAsian.jar，其实 是采用了iText字体解决方案中的“Fonts from jar”方式，从jar包中提取字符集编码方式和字体。需要把iTextAsian.jar放到类路径下，在报表文件（jrxml）中，文本区域的字体设置如下：<font pdfFontName=”STSong-Light” isPdfEmbedded =”true” pdfEncoding =”UniGB-UCS2-H”/>。这样，就能够正常的显示中文信息。

这种方法虽然能够正常地显示中文信息，但是有一个缺点，就是只有一种字体。因为iText官方网站提供的iTextAsian.jar包中只包 含几种简单的亚洲字体，对于简体中文来说，只有宋体。因此，采用这种方法生成的PDF中，中文字体只能为宋体，无法显示其他字体。当然，可以通过扩展 iTextAsian.jar的方式解决这个问题，在这个包中增加其他的字体。但是我还没找到其他的扩展包，也许以后会有人实现其他字体。

2.使用 TTF Files (True Type Fonts)字体文件

TTF是系统的标准字体文件，最初由Mac OS定义，后来Microsoft Windows普遍采用这种格式来定义字体文件。这也是目前我们最常用的字体格式。可以通过制定具体的字体文件的方式来指定字体。如：<font fontName=”隶书” pdfFontName=”STCAIYUN.TTF” size=”18″ isBold=”true” isPdfEmbedded =”true” pdfEncoding =”Identity-H”/>

例子中使用的是“华文彩云”字体，STCAIYUN.TTF为字体文件。需要注意的一点，这里使用的是相对路径，在生成PDF的时候，程序会从类路径中查找这个字体文件，你可以选择把字体文件放到类路径中，或者使用绝对路径来引用这个字体文件（如：c:/windows/fonts /STCAIYUN.TTF）。不推荐采用后一种方法，因为开发环境和使用环境中，系统的路径可能不同，就会导致无法找到字体文件。一种更好的解决办法，把windows系统中fonts下的某些常用的字体打成一个jar包，然后把这个jar报放到类路径下即可。

注意，在使用这种方式的时候，pdfEncoding 属性要设为”Identity-H”或者”Identity-V”。

关于iReport

iReport是一个可视化的JarsperReport设计器，可以很方便的生成报表文件。针对上述两种解决方案，第一种方案可以直接在界面 中选择pdfFontName和pdfEncoding ，系统中已经集成了”STSong-Light” 和 “UniGB-UCS2-H”，下拉列表中可以直接选到。

第二种方式下，iReport的路径下有一个fonts目录，其中包括一些TTF字体文件。在图形界面中选择pdfFontName的时候，只 能选择目录中存在的字体文件。如果想使用其他的TTF字体，可以实现把相关的字体从windows系统的fonts目录下拷贝到iReport的 fonts路径中，这些字体就会出现在pdfFontName的下拉列表中了。

评论

2 楼 yose 2014-07-01  

    困扰了我多日的问题，终于解决了

1 楼 liliang0504 2010-02-26  

我用的iReport-nb-3.6.1，pdfFontName下面没有字体名称，直接输入STCAIYUN.TTF问题解决，太感谢了，困扰好久了的问题！