JasperReport生成PDF中文不显示处理

JasperReport是一个纯Java写的开源免费报表工具库，很久没有玩JasperReport了，最近有点时间重新找来学习一下。现在报表的设计都换成TIBCO Jaspersoft Studio了，记得以前玩的时候是用IReport进行报表的设计。采用SpringBoot工程搭建了一个Demo，发现生成PDF的时候中文没显示，网上找了些资料，经过一些实验最终实现了中文的显示，下面记录一下处理方案。

JasperReport在用TIBCO Jaspersoft Studio进行报表设计的时候默认采用的字体是SansSerif，中文并不在其处理范围之内，把字体显示设置为华文宋体，如下图：

报表jrxml模板文件中可看到已经显示加了华文宋体。

<staticText>
    <reportElement x="20" y="7" width="68" height="32" uuid="c0240cf1-84c7-4197-b32e-dc59cbb77c66"/>
    <textElement textAlignment="Center" verticalAlignment="Middle">
        <font fontName="华文宋体" size="19"/>
    textElement>
    <text>text>
staticText>

报表模板文件中显示设置中文字体，生成PDF文件的时候中文其实还是不会显示，因为JasperRepeat的包中压根就没有华文宋体的字体库STSONG.TTF，需要在工程中放入该字体库，并配置JasperReport的字体模板fonts.xml，添加配置文件jasperreports_extension.properties指明字体处理工厂类和字体模板。

Windows操作系统中的字体文件可以在C:\Windows\Fonts目录下找到，华文宋体的字体文件STSONG.TTF就在该目录下面。

工程结构如下图：

fonts.xml

<fontFamilies>
    <fontFamily name="华文宋体">
        <normal>fonts/STSONG.TTFnormal>
        <bold>fonts/STSONG.TTFbold>
        <italic>fonts/STSONG.TTFitalic>
        <boldItalic>fonts/STSONG.TTFboldItalic>
        <pdfEncoding>Identity-HpdfEncoding>
        <pdfEmbedded>truepdfEmbedded>
        <exportFonts>
            <export key="net.sf.jasperreports.html">'华文宋体', Arial, Helvetica, sans-serifexport>
            <export key="net.sf.jasperreports.xhtml">'华文宋体', Arial, Helvetica, sans-serifexport>
        exportFonts>
    fontFamily>
fontFamilies>

jasperreports_extension.properties

net.sf.jasperreports.extension.registry.factory.simple.font.families=net.sf.jasperreports.engine.fonts.SimpleFontExtensionsRegistryFactory
net.sf.jasperreports.extension.simple.font.families.lobstertwo=fonts/fonts.xml

经过上述处理后，再生成PDF文件，中文已经可以正常显示了。

最终效果如下图：

---

工程地址：https://github.com/clj198606061111/spring-boot-jasperreports-demo

原文：http://www.itclj.com/blog/5a0b079d81c06e4103ef5129