Java制作开发pdf文件可以使用JasperReport框架。最近项目中需要后端生成pdf文件，为了高效快捷开发，选用了jasperreport框架。期间踩了不少坑，以此博文做些记录总结，希望对你也有一些帮助。
不管使用何种报表制作框架，一般都要有三个大的步骤：
- 设计模板
- 填充参数
- 渲染导出
使用jasperreport当然也会遵循上面的流程
一、设计pdf报表模板
jasperreport设计报表模板的工具是Jaspersoft Studio(到官网下载即可)，如下图
进入工具制作自己需要的报表模板即可，制作pdf文件模板时需要对studio工具进行一些简单的设置(详见文章末尾说明)，否则预览的时候中文字体将无法显示。设计后的模板如下图示：
二、填充pdf模板参数
模板制作完成后，在工具中编译生成二进制jasper文件就可以在项目中使用了(不编译也行，编译后代码运行时就无需在编译，会提高运行速度)。将jasper文件放到项目resources目录下，如下图：
上图中同时也给出了jasperreport生成pdf文件时需要用到的字体设置(有汉字时必须设置中文字体)，声明字体有三部分：
1. jasperreports_extension.properties配置文件
配置文件内容如下：
net.sf.jasperreports.extension.registry.factory.fonts=net.sf.jasperreports.engine.fonts.SimpleFontExtensionsRegistryFactory
net.sf.jasperreports.extension.simple.font.families.default=fonts/fonts.xml
jasper框架会通过此配置文件去加载指定的字体xml文件
2. 字体族xml声明文件
字体xml文件内容如下：
<?xml version="1.0" encoding="UTF-8"?>
<fontFamilies>
<fontFamily name="my_songT">
<normal>
<ttf>fonts/STSong.TTF</ttf>
<svg>fonts/STSong.TTF</svg>
<eot>fonts/STSong.TTF</eot>
<woff>fonts/STSong.TTF</woff>
</normal>
<bold>fonts/STSong.TTF</bold>
<italic>fonts/STSong.TTF</italic>
<boldItalic>fonts/STSong.TTF</boldItalic>
<pdfEncoding>Identity-H</pdfEncoding>
<pdfEmbedded>true</pdfEmbedded>
<exportFonts/>
</fontFamily>
</fontFamilies>
注意：fontFamily name=“my_songT” name的值需要和你设计模板时用到的字体名字一样
3. ttf字体包
ttf字体包是一个字体库，我项目中用的是STSong.TTF，当时为了下载字体包也是一顿好找(很多都是恶心人的诱导下载)，不过还是有好心人分享到了GitHub上，需要的可以由此进入下载
至此生成pdf的准备工作已经ok。然后就是根据你自己的业务组装模板需要的数据，填充模板参数即可。参考如下：
public void exportReportOrder(Integer reportId, HttpServletResponse servletResponse) {
//查询自己需要的业务数据
ReportOrderDetailVO detailVO = this.getReportOrderDetail(reportId);
OutputStream outputStream;
try {
outputStream = servletResponse.getOutputStream();
String fileName = reportOrderConverter.getPdfFileName(detailVO);
//设置http的文件类型及编码方式
servletResponse.setContentType("application/pdf;charset=utf-8");
//设置下载的文件名称 名称含有中文的话需要用URLEncoder进行编码
servletResponse.setHeader("content-disposition", "attachment;filename=" + URLEncoder.encode(fileName, "utf-8"));
Map<String, String> reportTypeToNameMap = reportTypeEnumService.getCodeToNameMap();
ExportFraudReportOrderResponse response = reportOrderConverter.assembleFraudReportOrder(detailVO, reportTypeToNameMap);
//组装模板中需要的参数 用于填充模板中通过$P{xxx}声明的参数
Map<String, Object> params = reportOrderConverter.assembleReportParams(response);
List<FraudReportOrderEvidenceImage> imageList = reportOrderConverter.getImageResources(detailVO);
//设置JasperReport的数据源 我用的是Json类型的数据源(数据源中的数据用于填充模板中detail区域的通过$F{XXX}指定的参数)
JsonDataSource jsonDataSource = new JsonDataSource(new ByteArrayInputStream(JSON.toJSONString(imageList).getBytes(StandardCharsets.UTF_8)));
boolean hasImage = reportOrderConverter.hasImage(detailVO);
if (hasImage) {
fileGenerateService.generates(EnumFileMeta.PDF_4_FRAUD_REPORT, outputStream, params, jsonDataSource);
} else {
fileGenerateService.generates(EnumFileMeta.PDF_4_FRAUD_REPORT_WITHOUT_IMAGE, outputStream, params, jsonDataSource);
}
} catch (IOException io) {
log.error("获取http输出流失败", io);
throw new ServiceResponseException("获取http输出流失败");
} catch (Exception e) {
log.error("生成报告单失败", e);
throw new ServiceResponseException("生成报告单失败");
}
}
三、渲染导出pdf文件
前面两个步骤完成之后，最后一步就是使用JasperReport框架提供的API生成导出pdf文件就行了，API使用很简单，如下：
/** * * @param fileMeta 自己封装的枚举 可以忽略 * @param outputStream 报表要生成的目的地 项目需求是让用户从浏览器直接下载的 所以此处用的是HttpServletResponse的输出流 * @param params 填充报表模板中$P{xxx}的参数 * @param dataSource 填充报表模板中$F{xxx}的数据源 */
public void exportFile(EnumFileMeta fileMeta, OutputStream outputStream, Map<String, Object> params, JRDataSource dataSource) {
try {
//加载项目中resources目录下的报表模板 注意：通过Class加载资源 资源地址必须是绝对路径
InputStream reportTemplate = this.getClass().getResourceAsStream("/template/fraud_report.jasper");
//将参数和数据源填充到报表模板中
JasperPrint jasperPrint = JasperFillManager.fillReport(reportTemplate, params, dataSource);
//框架导出pdf的API 导出文件到输出流
JasperExportManager.exportReportToPdfStream(jasperPrint, outputStream);
return;
} catch (Exception e) {
log.error("pdf文件导出异常", e);
} finally {
try {
outputStream.flush();
outputStream.close();
} catch (IOException e) {
log.error("pdf文件导出 冲刷/关闭输出流异常 ", e);
}
}
throw new ServiceResponseException("pdf文件导出异常");
}
至此，通过JasperReport框架生成pdf文件就全部完成了。本例成品如下图：
踩坑小计
- itext包的版本要选对，建议使用2.1.7版本，否则会报错(jasperReport 的依赖只和 itext的 2.1.7 版本兼容，不兼容其他版本)
<dependency>
<groupId>net.sf.jasperreports</groupId>
<artifactId>jasperreports</artifactId>
<version>6.11.0</version>
<exclusions>
<exclusion>
<artifactId>itext</artifactId>
<groupId>com.lowagie</groupId>
</exclusion>
<exclusion>
<artifactId>commons-collections4</artifactId>
<groupId>org.apache.commons</groupId>
</exclusion>
</exclusions>
</dependency>
<dependency>
<groupId>com.lowagie</groupId>
<artifactId>itext</artifactId>
<version>2.1.7</version>
</dependency>
- 如果在maven pom文件中添加了对resources资源进行了过滤，那么必须声明对jasper文件和ttf文件不过滤，否则会报错：
- 如不声明jasper，那么在加载jasper模板文件时候会报invalid stream header: EFBFBDEF 的错误 ；
- 如不声明ttf，那么在导出pdf文件的时候会报字体找不到的错误：net.sf.jasperreports.engine.util.JRFontNotFoundException: Font “my_songT” is not available to the JVM. See the Javadoc for more details.
原因：如果项目中有二进制或其他敏感文件，请不要使用maven对其进行filter，否则会破坏源文件!!!
pom文件声明如下：
<resources>
<resource>
<directory>src/main/resources</directory>
<includes>
<include>**.*</include>
<include>**/**.*</include>
</includes>
<filtering>true</filtering>
<excludes>
<exclude>**/*.jasper</exclude>
<exclude>**/*.TTF</exclude>
</excludes>
</resource>
<resource>
<directory>src/main/resources</directory>
<includes>
<include>**/*.jasper</include>
</includes>
<filtering>false</filtering>
</resource>
<resource>
<directory>src/main/resources</directory>
<includes>
<include>**/*.TTF</include>
</includes>
<filtering>false</filtering>
</resource>
</resources>
JasperStudio工具配置pdf字体
添加字体，选择自己电脑本地的中文TTF字体包，起一个易用的名字，如下图
设置pdf导出器，如下图
设置模板的时候选择刚才设置的字体，然后就可以通过studio工具快速预览pdf报表了(注：其他模板无需专门配置字体)，如果不使用配置的中文字体，那么预览的时候汉字是无法显示的，如下图：
