JAVA：OFD Reader & Writer 开源库技术解析

1、简述

OFD Reader & Writer 是一个由开源社区推动的 OFD 文件处理库，它旨在提供对 OFD 格式文件的读取和写入功能。这一开源项目为开发者提供了强大而灵活的工具，使得在应用程序中处理和生成 OFD 文件变得更加容易和高效
开源地址：https://toscode.mulanos.cn/ofdrw/ofdrw

  • OFD 文件读取
    OFD Reader & Writer 提供了高效的 OFD 文件读取功能，能够准确解析 OFD 文件的结构和内容，以便进行后续的处理和分析。

  • OFD 文件写入
    除了读取，OFD Reader & Writer 还支持 OFD 文件的生成和写入。开发者可以通过这个库创建、编辑并生成符合 OFD 标准的文件。

  • 高度模块化
    OFD Reader & Writer 设计为高度模块化，提供了丰富的 API 接口，使得开发者可以根据需要选择性地使用其中的功能，保持了库的轻量性和灵活性。

  • 开放扩展性
    这一库注重开放性，支持插件和扩展，使得开发者能够根据自身需求轻松扩展功能，满足不同场景的需求。

2、模块

根据《GB/T 33190-2016 电子文件存储与交换格式版式文档》标准实现版式文档OFD库，项目采用Maven模块管理，各模块如下：

  • ofdrw-core OFD核心API，参考《GB/T 33190-2016 电子文件存储与交换格式版式文档》实现的基础数据结构。
  • ofdrw-font 生成OFD字体相关。
  • ofdrw-layout OFD布局引擎库，用于文档构建和渲染。
  • ofdrw-pkg OFD文件的容器，用于文档的打包。
  • ofdrw-reader OFD文档解析器，用于OFD的反序列化以及签名签章。
  • ofdrw-sign OFD文档数字签章。
  • ofdrw-gm 用于支持签章模块需要的国密电子签章数据结构。
  • ofrw-crypto 用于实现《GM/T 0099-2020 开放版式文档密码应用技术规范》对OFD的密码相关功能。
  • ofdrw-gv OFDRW 所有模块所共用的全局变量。
  • ofdrw-converter OFD文档转换。
  • ofdrw-tool OFD文档工具，文档合并、裁剪、重组。
  • ofdrw-graphics2d 实现了AWT Graphics2D接口，生成OFD文档内容。
  • ofdrw-full 上述所有模块整合包，用于简化依赖引入

3、应用

这一库不仅具备对 OFD 文件的读取功能，还提供了强大的写入功能，为开发者提供全面的 OFD 文件处理解决方案。

3.1 引用

通过Maven项目引用相关依赖：

<dependency>
  <groupId>org.ofdrw</groupId>
  <artifactId>ofdrw-full</artifactId>
  <version>2.2.6</version>
</dependency>

备注：OFDRW 将持续保证API的向下兼容，您可以放心的升级OFDRW库至最新版本。

3.2 创建

public class HelloWorld {
    public static void main(String[] args) throws IOException {
        Path path = Paths.get("HelloWorld.ofd");
        try (OFDDoc ofdDoc = new OFDDoc(path)) {
            Paragraph p = new Paragraph("你好呀，OFD Reader&Writer！");
            ofdDoc.add(p);
        }
        System.out.println("生成文档位置: " + path.toAbsolutePath());
    }
}

在这里插入图片描述

3.3 解析

通过OFD文件路径，将当前文件解析，并且获取相关OFD文件信息：

public static OFDReader ofdParse(String ofdFilePath) throws Exception{
    Path input = Paths.get(ofdFilePath);
    return  new OFDReader(input);
}

3.4 根目录

获取解析完成的ofd根目录：

String sysAbsPath = ofdReader.getOFDDir().getSysAbsPath();

3.5 打包

在使用个过程中有时候需要修改ofd文件的内容，我们可以将他解压后，然后通过OFDRW提供的接口重新打包成OFD文件：

public static void jar(Path jarPath, Path targetFilePath) throws IOException {
   OFDDir ofdDir = new OFDDir(jarPath);
   ofdDir.jar(targetFilePath);
}

3.6 转换

在开发工程中很多文件重新去构造OFD会浪费大量的时间，我们可以轻松的从已有的PDF直接转成OFD:

public static void convertBy2D(String resourceFilePath, String targetFilePath) throws Exception{
    Path src = Paths.get(resourceFilePath);
    Path dst = Paths.get(targetFilePath);
    try (PDFConverter converter = new PDFConverter(dst)) {
        converter.convert(src);
    }
}

4、其他解决方案

4.1 HTML5

HTML5前端预览解决方案： DLTech21/ofd.js . https://github.com/DLTech21/ofd.js

  • jszip解压。
  • fast-xml-parser解析xml为json数据。
  • svg及canvas渲染实现。
  • 完全浏览器OFD页面渲染。
4.2 开源阅读器
  • 数科网维公司 . 数科OFD阅读器 . www.ofd.cn
  • Foxit . 福昕OFD . www.foxitsoftware.cn/ofd/

5、结语

OFD Reader & Writer 开源库作为一项致力于 OFD 文件处理的技术工具，通过其完整的 OFD 标准支持、高度模块化和开放扩展性等特点，为开发者提供了一种强大的 OFD 文件处理解决方案。如果你正在寻找一个全面的 OFD 文件读写库，OFD Reader & Writer 无疑是值得深入研究和应用的技术利器，为你的项目带来更高效的文件处理能力。