JasperReport 导出PDF时使用其他字体

Java开元项目JasperReport用于形成报表，报表可以导出多种格式：PDF、HTML、RTF、XLS等。在WebWork中直接集成了JasperReport的结果类型，可以用来解决Web应用的报表打印问题。本文主要讨论到处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的下拉列表中了。

 

报表中的图片信息：

  iReport设计表示，增加图片信息的时候，以文件的绝对路径方式取得图片i，这种方式不好。建议把图片放在报表存放的目录下，用相对路径来访问图片。当然，也可以通过类路径方式访问图片信息，但是图片不像字体，它是跟单个报表相关联的，所以放在报表的目录下比较合适。但如果在WebWork下使用，还需要在类路径下存放图片文件。