SpringBoot集成LibreOffice+jodconverter做文件预览(office转pdf)

简介

LibreOffice 是一款开放源代码的自由免费全能办公软件，可运行于 Microsoft Windows, GNU/Linux 以及 macOS 等操作系统上。它包含了 Writer, Calc, Impress, Draw, Math 以及 Base 等组件，可分别用于文本文档、电子表格、幻灯片演示文稿、绘图文档、数学公式编辑、数据库管理等工作。

LibreOffice 采用对企业和个人用户均免费的 MPL 2.0 授权协议。您可以自由分发该软件，无需支付授权费用（但您仍然可以付费获得经认证的专业支持）。它的源代码完全公开，任何人都可以参与软件的开发和维护。

jodconverter概述

JODConverter是 Java OpenDocument 转换器，可在不同办公格式之间转换文档。它利用Apache OpenOffice或LibreOffice，它们为当今可用的 OpenDocument 和 Microsoft Office 格式提供可以说是最好的免费导入/导出过滤器。

JODConverter自动执行 OpenOffice/LibreOffice 支持的所有转换。支持的转换包括（但不限于。您的 OOo 安装支持的所有转换都由 JODConverter 支持）：

文件类型 输入格式 输出格式
文本 DOC、DOCX、ODT、OTT、RTF、文本等。 DOC、DOCX、HTML、JPG、ODT、OTT、FODT、PDF、PNG、RTF、TXT 等。
电子表格 CSV、ODS、OTS、TSV、XLS、XLSX 等。 CSV、HTML、JPG、ODS、OTS、FODS、PDF、PNG、TSV、XLS、XLSX 等。
介绍 ODP、OTP、PPT、PPTX等 GIF、HTML、JPG、ODP、OTP、FODP、PDF、PNG、PPT、PPTX、BMP 等。
画画 ODG、OTG 等 GIF、JPG、ODG、OTG、FODG、PDF、PNG、SVG、TIF、VSD、BMP 等。
其他 HTML DOC、DOCX、HTML、JPG、ODT、OTT、FODT、PDF、PNG、RTF、TXT 等。
JODConverter可以以多种不同的方式使用：

目标

1.完成office文档->pdf

入门案例

安装libreoffice

libreoffice官网下载地址

下载可以选择windows/linux或其他操作系统
本节按照windows进行测试

新建springboot项目，引入以下依赖。

        <!--转换工具-->
        <dependency>
            <groupId>org.jodconverter</groupId>
            <artifactId>jodconverter-spring-boot-starter</artifactId>
            <version>4.4.2</version>
        </dependency>
        <dependency>
            <groupId>org.jodconverter</groupId>
            <artifactId>jodconverter-local</artifactId>
            <version>4.4.2</version>
        </dependency>
        <dependency>
            <groupId>org.jodconverter</groupId>
            <artifactId>jodconverter-core</artifactId>
            <version>4.4.2</version>
        </dependency>

配置文件

jodconverter:
  local:
    enabled: true
    # libreOffice根目录
    officeHome: src/main/resources/office-plugin
    # 任务执行的超时时间
    taskExecutionTimeout: 86400000
    # 任务队列的超时时间
    taskQueueTimeout: 86400000
    # 端口（线程）
    portNumbers: [2001,2002,2003]
    # 一个进程的超时时间
    processTimeout: 86400000

以上配置文件是基于本地的libreoffice服务进行配置，更多配置可以查看属性配置类JodConverterLocalProperties

测试代码

    /**
     * 注入文档转换接口，
     * springboot自动装配时会在容器中添加一个bean对象，
     * 也就是其实现类LocalConverter
     */
    @Resource
    private DocumentConverter documentConverter;

    @Test
    public void convert() {
        File source = new File("D:\\document\\测试\\测试.docx");
        File target = new File("D:\\document\\测试\\测试.pdf");
        // convert方法指定源文件对象/输入流
        // to方法指定目标文件对象/输出流(源文件可以不存在，如果不存在则会创建)
        // todo: 目标文件的后缀要和即将转换的文件类型一致，否则会造成文件损坏
        // todo: as方法接受的时DocumentFormat对象，我们可以使用默认注册完的DocumentFormat对象，
        // execute方法是执行转换的方法，方法没有返回值，是同步执行
        try {
            documentConverter.convert(source).to(target).as(DefaultDocumentFormatRegistry.PDF).execute();
        } catch (OfficeException e) {
            log.error("文档转换异常:{}", e.getMessage());
        }
    }

程序运行结果及效果图

运行结果

效果

jodconverter官网：https://github.com/sbraconnier/jodconverter/