从PDF到OFD，国产化浪潮下多种文档格式导出的完美解决方案

前言

近年来，中国在信息技术领域持续追求自主创新和供应链安全，伴随信创上升为国家战略，一些行业也开始明确要求文件导出的格式必须为 OFD 格式。OFD 格式目前在政府、金融、税务、教育、医疗等需要文件开放、共享和长期保存的行业中广泛应用。这种趋势在未来几年内将进一步增强。

相较于 PDF，OFD 在以下方面展现了明显的优势，具体体现在：

• 开放性

PDF 是 Adobe 公司开发的专有格式，虽然也被广泛应用，但受制于 Adobe 公司的软件和许可。OFD 则是基于国际开放标准制定的开放式文档格式，任何人或组织都可以自由使用和开发相关软件。

• 功能特性

PDF 主要用于文档展示和打印，功能较为单一。OFD 在文档展示、打印、编辑等方面都有更强大的功能支持。

• 文件大小

PDF 文件通常会略大于 OFD 文件，因为 PDF 包含更多的元数据和功能，OFD 文件在保持良好的视觉效果的前提下,通常体积更小。

• 兼容性

PDF 虽然跨平台性强,但在不同软件和系统中的表现可能会有差异，OFD 则具有更好的跨平台一致性。

• 安全性

PDF 文件可能包含隐藏的功能和潜在的安全隐患，OFD 则更加透明，安全性更高。

如何将 PDF 转化为 OFD？

既然导出 OFD 格式如此重要，然而目前市面上的报表工具，前端导出时通常只支持 PDF 格式。那么在这种情况下，如何实现一键在前端将报表导出为 OFD 格式呢？今天，小编将以葡萄城的嵌入式 BI 工具------Wyn 商业智能作为例子，向大家介绍如何将 PDF 转换为 OFD 格式。

首先小编先带大家一起了解下OFD文件解析的底层原理：

OFD 文件底层结构：

OFD 文件采用XML作为其基本结构，这意味着文件内容是以文本形式存储的，便于编辑和搜索。OFD 文件主要由以下几个部分组成：

1. 文档头（Document Header）：包含文档的基本信息，如标题、作者、创建日期等。
2. 文档体（Document Body）：包含文档的实际内容，如文字、图片、表格等。
3. 资源文件（Resource Files）：包括文档中使用到的图片、字体、样式等资源。
4. 元数据（Metadata）：提供有关文档内容的额外信息，如关键词、摘要等。

PDF 转换为 OFD 的流程：

首先，通过使用 Wyn 报表工具，可以轻松设计出符合需求的报表样式。这些报表样式可以包含各种元素，例如表格、图表、图片、文本、超链接等等。设计完成后，可以直接在 Web 端进行预览，同时还支持将报表导出为PDF 格式。这样的设计流程和功能使得报表的创建和预览变得更加便捷和直观。

前端支持 PDF 导出只是第一步，为了实现从 PDF 转换为 OFD，还需要前端提供导出 PDF 的 API 接口，以便前端能够获取到 PDF 文件的流数据。幸运的是，Wyn 提供了丰富的 API 接口，使得前端可以通过接口直接实现PDF 的导出功能。这样的设计使得 PDF 转换为 OFD 变得更加便捷和可行。

PDF 转 OFD 的实现步骤

前端导出PDF文件的API接口：

http://localhost:51980/api/v2/reporting/export-templates/{exportTemplateId}

后端进行PDF文件解析的方法

1. 继承 PDFGraphicsStreamEngine 类，便于分析 PDF 数据图层和资源归类

public class OFDPageDrawer extends PDFGraphicsStreamEngine { } 

2. 重写构造方法，分析 PDF 每页的资源，并初始化 OFD 生成器

/** 构造器，调用super(page),这个操作的目的是将page资源准备好，并且添加对应的操作符， 当下一次调用processPage或者processPageContentStream时执行对应的操作符对应的操作 @param idx @param page @param ofdCreator @param scale @throws IOException */ protected OFDPageDrawer(int idx, PDPage page, OFDCreator ofdCreator, float scale) throws IOException { super(page); this.page = page; this.ofdCreator = ofdCreator; ctLayer = this.ofdCreator.createLayer(); this.scale = scale; } 

3. 重写 drawImage 方法收集整理 PDF 中分析出来的图片资源

/** 作用：将 PDF 图像对象转换为 OFD 格式进行绘制。此方法包括： * 将图像写入字节流并保存。 根据当前变换矩阵计算图像在页面上的位置和大小。 创建 OFD 图像对象并设置其相关属性，然后添加到当前层中。 * @param pdImage @throws IOException */ @Override public void drawImage(PDImage pdImage) throws IOException { ByteArrayOutputStream bosImage = new ByteArrayOutputStream(); String suffix = "png"; ImageIO.write(pdImage.getImage(), suffix, bosImage); String name = String.format("%s.%s", bcMD5(bosImage.toByteArray()), suffix); ofdCreator.putImage(name, bosImage.toByteArray(), suffix); // 根据当前变换矩阵计算图像在页面上的位置和大小，实际上就是将PDF中该图像的属性信息转换成OFD中的形式 Matrix ctmNew = this.getGraphicsState().getCurrentTransformationMatrix(); float imageXScale = ctmNew.getScalingFactorX(); float imageYScale = ctmNew.getScalingFactorY(); double x = ctmNew.getTranslateX() * scale; double y = (page.getCropBox().getHeight() - ctmNew.getTranslateY() - imageYScale) * scale; double w = imageXScale * scale; double h = imageYScale * scale; ImageObject imageObject = new ImageObject(ofdCreator.getNextRid()); imageObject.setBoundary(x, y, w, h); imageObject.setResourceID(new ST_RefID(ST_ID.getInstance(ofdCreator.getImageMap().get(name)))); imageObject.setCTM(ST_Array.getInstance(String.format("%.0f 0 0 %.0f 0 0", w, h))); setImageClip(imageObject, x, y, w, h); ctLayer.add(imageObject); } 

4. 通过继承 PDFGraphicsStreamEngine 类分析得到的文字内容重绘

public void addPageContent(int idx, CT_Layer ctLayer, float width, float height) { PageDir pageDirInv = new PageDir();// 资源归类 pageDirInv.setIndex(idx); org.ofdrw.core.basicStructure.pageObj.Page pageInv = new org.ofdrw.core.basicStructure.pageObj.Page(); CT_PageArea areaInv = new CT_PageArea();// ofd可视区域（PDF的裁剪区） areaInv.setPhysicalBox(0, 0, width, height); pageInv.setArea(areaInv); Content contentInv = new Content();// 内容 contentInv.addLayer(ctLayer); pageInv.setContent(contentInv); pageDirInv.setContent(pageInv); docDir.getPages().add(pageDirInv); } 

5. 将收集到的资源进行打包生成 OFD 文件

/** 打包OFD文件包二进制数据 * @param virtualFileMap @return @throws IOException */ public static void zip(Map<String, byte[]> virtualFileMap,OutputStream output) throws IOException { ZipArchiveOutputStream zaos = new ZipArchiveOutputStream(output); for (Map.Entry<String, byte[]> entry : virtualFileMap.entrySet()) { zaos.putArchiveEntry(new ZipArchiveEntry(entry.getKey())); zaos.write(entry.getValue()); zaos.closeArchiveEntry(); } zaos.finish(); } 

最终效果展示：

完整代码的链接：

GcExcelTestArea.rar

总结

在当今时代，对于国产化的支持，OFD（Office Open XML for Developers）变得越来越重要。本文首先介绍了OFD 文件的底层结构，并阐述了 OFD 相对于 PDF 的优势。接着，介绍如何通过葡萄城的嵌入式 BI 工具------Wyn 商业智能，进行报表设计和导出 PDF 。同时，还展示了如何使用 Wyn 商业智能的 API 接口将 PDF 转换为 OFD，除此之外，在企业级复杂系统中，除了 OFD 之外，Wyn还同时支持Word、Excel、图片、Text、JSON等多种格式的导出。

通过本文的介绍，我们可以清楚地看到，将 PDF 转换为 OFD 不再是一个困扰。借助 Wyn 强大的功能和丰富的 API 接口支持，能够轻松高效地实现文档格式转换。这一解决方案为用户提供了便捷、灵活的操作方式，满足了行业对 OFD 格式的要求。

扩展链接：

创意展示：打造数据大屏的炫酷天气预报插件

聊一聊数字孪生与3D可视化

探秘移动端BI：发展历程与应用前景解析