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 文件的示例代码:

java 复制代码
// 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。以下是示例代码:

java 复制代码
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。有关详细信息,请参阅以下主题:

需要注意的是,GcExcel 不支持将图片设置(如线条格式、填充格式、亮度、对比度和水印颜色类型)导出到 PDF 文档中。并且与微软 Excel 相比,GcExcel 中 PatternType 枚举的 DiagonalCross 结果有所不同。

结论

通过 GcExcel 提供的功能和方法,Java 开发者能够方便地实现将 Excel 转化为 PDF 的需求。不仅可以进行基本的导出操作,还能通过 PdfSaveOptions 类对导出的 PDF 文件进行定制,包括设置文档属性、安全选项、图像质量等。同时,还支持在 PDF 文档中设置 JavaScript。不过,在使用过程中需要注意其存在的一些限制,如图片设置的导出不支持等。如果想深入了解更多详细信息,可以参考相关帮助文档 ^^。

相关推荐
paopaokaka_luck5 分钟前
基于Spring Boot+Vue的吉他社团系统设计和实现(协同过滤算法)
java·vue.js·spring boot·后端·spring
Warren982 小时前
Java Stream流的使用
java·开发语言·windows·spring boot·后端·python·硬件工程
架构师沉默3 小时前
Java优雅使用Spring Boot+MQTT推送与订阅
java·开发语言·spring boot
tuokuac3 小时前
MyBatis 与 Spring Boot版本匹配问题
java·spring boot·mybatis
zhysunny4 小时前
05.原型模式:从影分身术到细胞分裂的编程艺术
java·原型模式
草履虫建模4 小时前
RuoYi-Vue 项目 Docker 容器化部署 + DockerHub 上传全流程
java·前端·javascript·vue.js·spring boot·docker·dockerhub
皮皮林5514 小时前
强烈建议你不要再使用Date类了!!!
java
做一位快乐的码农5 小时前
基于Spring Boot和Vue电脑维修平台整合系统的设计与实现
java·struts·spring·tomcat·电脑·maven
77qqqiqi5 小时前
mp核心功能
java·数据库·微服务·mybatisplus
junjunyi6 小时前
高效实现 LRU 缓存机制:双向链表与哈希表的结合
java·哈希表·双向链表