Java 实现 Excel 转化为 PDF
引言
在实际开发中，将 Excel 文件转化为 PDF 格式是一项常见需求。例如在需要共享数据报表时，PDF 格式具有更好的兼容性和安全性。GrapeCity Documents for Excel（GcExcel）为 Java 开发者提供了强大的工具，可轻松实现将 Excel 转化为 PDF 的功能。本文将详细介绍如何使用 GcExcel 在 Java 中完成这一转化过程。
正文
基本导出功能
GcExcel 提供了将工作簿导出为 PDF 文件的工具。可以为工作簿中的每个工作表设置分页，并将其导出到 PDF 文件中指定的页面。在执行导出操作时，还能应用样式、自定义字体、添加安全选项、配置文档属性以及调整行高或列宽。此外，带有图表、切片器和背景图片的 Excel 工作表也能成功导出为 PDF 文档。
GcExcel 允许使用 IWorkbook 接口的 save() 方法将工作簿中所有可见的电子表格保存到 PDF 中，工作簿中的每个工作表都会保存到 PDF 文件中的新页面。若只想将当前工作表（活动工作表）导出为 PDF 格式，则可使用 IWorksheet 接口的 save() 方法。
在处理图片方面，GcExcel 也非常高效。如果一张图片在电子表格中被多次使用，GcExcel 只会保留一份图片副本，以减小导出的 PDF 文件的大小。
以下是将电子表格导出为 PDF 文件的示例代码：
// Create a new workbook and add worksheets
Workbook workbook = new Workbook();
IWorksheet worksheet = workbook.getWorksheets().get(0);
IWorksheet worksheet1 = workbook.getWorksheets().add();// Set value and apply styles to the worksheet
worksheet1.getRange("A1").setValue("Sheet1");
worksheet1.getRange("A1").getFont().setName("Wide Latin");
worksheet1.getRange("A1").getFont().setColor(Color.GetRed());
worksheet1.getRange("A1").getInterior().setColor(Color.GetGreen());// Export Workbook to pdf file, the exported file has two pages.
workbook.save("ConvertWorkbookToPDF.pdf", SaveFileFormat.Pdf);// Just export a particular worksheet to pdf file
worksheet1.save("ConvertWorksheetToPDF.pdf", SaveFileFormat.Pdf);
定制导出选项
GcExcel 提供了 PdfSaveOptions 类来定制 PDF 文件的导出，这些选项如下：
| 类 | 选项 | 描述 |
|---|---|---|
| 导出选项 | PdfSaveOptions | 存储导出 PDF 时的各种选项 |
| BorderOptions | 导出 PDF 时存储边框选项 | |
| DocumentProperties | 表示 PDF 的文档属性 | |
| FileFormat | 表示工作簿的保存格式 | |
| FormFields | 指示是否用 PDF 表单域替换 Excel 表单控件，并非所有控件和属性都受支持 | |
| ImageQuality | 以百分比设置图像质量，此值必须介于 0（最低质量，最大压缩）和 100（最高质量，无压缩）之间，默认值为 75 | |
| OpenActionScript | 设置打开保存的 PDF 文件时要执行的 JavaScript | |
| PrintBackgroundPicture | 指示是否在页面上打印工作表的背景图像 | |
| PrintTransparentCell | 指示是否在页面上打印单元格背景色的透明度 | |
| SecurityOptions | 表示 PDF 的安全设置 | |
| ShrinkToFitSettings | 关于对自动换行文本执行缩小以适应的设置 | |
| ViewerPreferences | 包含指定当前文档应如何显示的信息的设置 | |
| IncludeAutoMergedCells | 指示是否包含自动合并的单元格，默认值为 false |
在 PDF 文档中设置 JavaScript
GcExcel 还支持通过 PdfSaveOptions 类的 setOpenActionScript 方法在 PDF 文档中设置 JavaScript。打开保存的 PDF 文档时，会执行 JavaScript。以下是示例代码：
Workbook workbook = new Workbook();
workbook.open("D:\\SampleTemplate.xlsx");
workbook.processTemplate();
PdfSaveOptions options = new PdfSaveOptions();
options.setOpenActionScript("var fld1 = this.getField(\"num\");" +"fld1.value = fld1.value;" +"this.dirty = false;");
workbook.save("SampleTemplate_java.pdf", options);
自定义导出 PDF 的其他设置
在执行导出操作时，可以配置字体、设置样式和指定页面设置选项，来自定义导出 PDF。有关详细信息，请参阅以下主题：
- 设置字体样式
- 导出数据透视表样式和格式
- 导出形状
- 导出边框
- 导出条件格式
- 导出填充样式
- 导出图片
- Export图表
- 导出迷你图
- 导出表格
- 导出文本
- 导出垂直文本
- 设置文本自动收缩与自动换行
- 导出切片器
- 设置安全选项
- 设置文档属性
- 调整行高和列宽
- 设置背景图片
- 分页控制
- 设置背景色透明度
- 跟踪导出进度
- 自定义边框样式
需要注意的是，GcExcel 不支持将图片设置（如线条格式、填充格式、亮度、对比度和水印颜色类型）导出到 PDF 文档中。并且与微软 Excel 相比，GcExcel 中 PatternType 枚举的 DiagonalCross 结果有所不同。
结论
通过 GcExcel 提供的功能和方法，Java 开发者能够方便地实现将 Excel 转化为 PDF 的需求。不仅可以进行基本的导出操作，还能通过 PdfSaveOptions 类对导出的 PDF 文件进行定制，包括设置文档属性、安全选项、图像质量等。同时，还支持在 PDF 文档中设置 JavaScript。不过，在使用过程中需要注意其存在的一些限制，如图片设置的导出不支持等。如果想深入了解更多详细信息，可以参考相关帮助文档 ^^。