跨平台文件在线预览解决方案（三）- LibreOffice vs OpenOffice

川长思鸟来 2022-12-05 05:11 1067阅读 0赞

## 前言 ##

突然有一天在业务系统中发现OpenOffice转换word为pdf时，出现个别中文字丢失以及格式发生变化。这在业务系统中预览合同等重要附件是致命的。Google了半天也没找到问题所在。于是采用LibreOffice进行转换，看看转换效果。office文件在线预览原理一样，先转换成pdf，然后采用pdf. js预览。

## 问题复现 ##

### 原word文件 ###

![068ad530db15f8852cb58574f776f5ef.png][]  
![83c5b3196cf13d1ec99064172b52a96a.png][]

### OpenOffice转换后pdf文件 ###

![6db63b4efdeb5f1be24c557a41de7488.png][]  
![0f4a7d74378d2d78a20ed8dc30130c28.png][]

## 链接 ##

*  关于OpenOffice的使用方法，参考[《跨平台（uni-app）文件在线预览解决方案》第四章节][uni-app]
 *  关于pdf.js的使用方法，参考[《跨平台（uni-app）文件在线预览解决方案》][uni-app]
 *  LibreOffice和OpenOffice中文乱码问题，文后说明解决方法

## 快速开始 ##

### 下载 ###

[地址][Link 1]

下载最新版本，目前是7.0.1

下载三个包：

*  主包：[LibreOffice\_7.0.1\_Linux\_x86-64\_rpm.tar.gz][LibreOffice_7.0.1_Linux_x86-64_rpm.tar.gz]
 *  SDK：[LibreOffice\_7.0.1\_Linux\_x86-64\_rpm\_sdk.tar.gz][LibreOffice_7.0.1_Linux_x86-64_rpm_sdk.tar.gz]
 *  语言包：[LibreOffice\_7.0.1\_Linux\_x86-64\_rpm\_langpack\_zh.tar.gz][LibreOffice_7.0.1_Linux_x86-64_rpm_langpack_zh.tar.gz]

### 安装 ###

*  主包

cd LibreOffice_7.0.1.2_Linux_x86-64_rpm/RPMS
    yum localinstall -y *.rpm

*  SDK

cd LibreOffice_7.0.1.2_Linux_x86-64_rpm_sdk/RPMS
    yum localinstall -y *.rpm

*  语言包

cd LibreOffice_7.0.1.2_Linux_x86-64_rpm_langpack_zh-CN
    yum localinstall -y *.rpm

### 启动 ###

/opt/libreoffice7.0/program/soffice --headless --accept="socket,host=127.0.0.1,port=8101;urp;" --nofirststartwizard > /opt/server/libre.log 2>&1 &
    # 自启动
    将以上命令添加到/etc/rc.local中

### 测试 ###

libreoffice7.0 --headless --invisible --convert-to pdf 原office文件 --outdir 输出目录

## Java集成 ##

### 安装jar ###

<dependency>
    	<groupId>org.jodconverter</groupId>
    	<artifactId>jodconverter-local</artifactId>
    	<version>4.3.0</version>
    </dependency>

### 配置文件libre.properties ###

在resources目录下新建libre.properties

# LibreOffice主目录
    libreOfficeHome=/opt/libreoffice7.0
    # 开启多个LibreOffice进程，每个端口对应一个进程
    # portNumbers=2002,2003
    portNumbers=8101
    # 任务执行超时为5分钟
    taskExecutionTimeoutMinutes=5
    # 任务队列超时为1小时
    taskQueueTimeoutHours=1

### 读取配置，并连接LibreOffice服务 ###

新建类：OfficeManagerInstance.java

package cn.sccl.common.config;
    
    import org.jodconverter.core.office.OfficeManager;
    import org.jodconverter.local.office.LocalOfficeManager;
    import org.springframework.core.io.support.PropertiesLoaderUtils;
    import org.springframework.stereotype.Component;
    
    import javax.annotation.PostConstruct;
    import java.io.IOException;
    import java.util.Properties;
    
    @Component
    public class OfficeManagerInstance { 
        private static OfficeManager INSTANCE = null;
    
        public static synchronized void start() { 
            officeManagerStart();
        }
    
        @PostConstruct
        private void init() { 
            try { 
                Properties properties = PropertiesLoaderUtils.loadAllProperties("libre.properties");
                String[] portNumbers = properties.getProperty("portNumbers", "").split(",");
                int[] ports = new int[portNumbers.length];
    
                for (int i = 0; i < portNumbers.length; i++) { 
                    ports[i] = Integer.parseInt(portNumbers[i]);
                }
    
                LocalOfficeManager.Builder builder = LocalOfficeManager.builder().install();
                builder.officeHome(properties.getProperty("libreOfficeHome", ""));
                builder.portNumbers(ports);
                builder.taskExecutionTimeout(Long.parseLong(properties.getProperty("taskExecutionTimeoutMinutes", "")) * 1000 * 60); // minute
                builder.taskQueueTimeout(Long.parseLong(properties.getProperty("taskQueueTimeoutHours", "")) * 1000 * 60 * 60); // hour
    
                INSTANCE = builder.build();
                officeManagerStart();
            } catch (IOException e) { 
                e.printStackTrace();
            }
        }
    
        private static void officeManagerStart() { 
            if (INSTANCE.isRunning()) { 
                return;
            }
    
            try { 
                INSTANCE.start();
            } catch (Exception e) { 
                e.printStackTrace();
            }
        }
    }

### 工具类LibreOfficeUtil ###

新建工具类：LibreOfficeUtil.java

package cn.sccl.common.util;
    
    import cn.sccl.common.config.OfficeManagerInstance;
    import org.jodconverter.local.JodConverter;
    
    import java.io.File;
    
    public class LibreOfficeUtil { 
        /** * 利用 JodConverter 将 Offfice 文档转换为 PDF（要依赖 LibreOffice），该转换为同步转换，返回时就已经转换完成 */
        public static boolean convertOffice2PDFSyncIsSuccess(File sourceFile, File targetFile) { 
            try { 
                OfficeManagerInstance.start();
                JodConverter.convert(sourceFile).to(targetFile).execute();
            } catch (Exception e) { 
                e.printStackTrace();
                return false;
            }
    
            return true;
        }
    
        /** * 利用 LibreOffice 将 Office 文档转换成 PDF，该转换是异步的，返回时，转换可能还在进行中，转换是否有异常也未可知 * @param filePath 目标文件地址 * @param targetFilePath 输出文件夹 * @return 子线程执行完毕的返回值 */
        public static int convertOffice2PDFAsync(String filePath, String fileName, String targetFilePath) throws Exception { 
            String command;
            int exitStatus;
            String osName = System.getProperty("os.name");
            String outDir = targetFilePath.length() > 0 ? " --outdir " + targetFilePath : "";
    
            if (osName.contains("Windows")) { 
                command = "cmd /c cd /d " + filePath + " && start soffice --headless --invisible --convert-to pdf ./" + fileName + outDir;
            } else { 
                command = "libreoffice6.3 --headless --invisible --convert-to pdf:writer_pdf_Export " + filePath + fileName + outDir;
            }
    
            exitStatus = executeOSCommand(command);
            return exitStatus;
        }
    
        /** * 调用操作系统的控制台，执行 command 指令 * 执行该方法时，并没有等到指令执行完毕才返回，而是执行之后立即返回，返回结果为 0，只能说明正确的调用了操作系统的控制台指令，但执行结果如何，是否有异常，在这里是不能体现的，所以，更好的姿势是用同步转换功能。 */
        private static int executeOSCommand(String command) throws Exception { 
            Process process;
            process = Runtime.getRuntime().exec(command); // 转换需要时间，比如一个 3M 左右的文档大概需要 8 秒左右，但实际测试时，并不会等转换结束才执行下一行代码，而是把执行指令发送出去后就立即执行下一行代码了。
    
            int exitStatus = process.waitFor();
    
            if (exitStatus == 0) { 
                exitStatus = process.exitValue();
            }
    
            // 销毁子进程
            process.destroy();
            return exitStatus;
        }
    }

### 使用方法 ###

boolean ret = LibreOfficeUtil.convertOffice2PDFSyncIsSuccess(sourceFile, pdfFile);

## 效果对比 ##

![b08d2551b1475125205269cada880345.png][]

![912e0c26f43a695b2205687ec2dd8823.png][]

效果明显比OpenOffice效果好，就转换速率来说，差不多时间，这个就没有详细计算了。

## 中文乱码问题解决 ##

不管是用LibreOffice还是OpenOffice，都会遇到中文乱码问题。统一解决办法如下：

环境：CentOS7

*  查看字体目录`vim /etc/fonts/fonts.conf`，默认在/usr/share/fonts/
 *  安装中文字体

mkdir /usr/share/fonts/chinese
    cd /usr/share/fonts/chinese
    # 将windows字体拷贝到该目录，如下：搜索“简体”，拷贝所有

![5d877660f7f461c9f0933e78895fb53a.png][]

![5f4f9eab72e0e0e4f95e8c76e17f3019.png][]

chmod 755 *.TTF
    chmod 755 *.TTC
    # (如果提示 mkfontscale: command not found，需自行安装 # yum install mkfontscale)
    mkfontscale
    
    mkfontdir
    
    # (如果提示 fc-cache: command not found，则需要安装# yum install fontconfig )
    fc-cache -fv
    
    # 安装完成，重启LibreOffice或OpenOffice服务

![b9c369443b192642f975be9020b3234e.png][] ![weixin.gif][]

转载请注明：[我的技术分享][Link 2] » [跨平台文件在线预览解决方案（三）- LibreOffice vs OpenOffice][- LibreOffice vs OpenOffice]

[068ad530db15f8852cb58574f776f5ef.png]: /images/20221123/ddbde9ba6e654b779bd627ea02e95f33.png
[83c5b3196cf13d1ec99064172b52a96a.png]: /images/20221123/ad3c25e566494fa1a1c2a8a45928594d.png
[6db63b4efdeb5f1be24c557a41de7488.png]: /images/20221123/54ce6323649d4bc7b5d6f7d7afecdead.png
[0f4a7d74378d2d78a20ed8dc30130c28.png]: /images/20221123/4d6173a274d4499e87a2f2b040f08dd8.png
[uni-app]: http://silianpan.cn/index.php/2019/10/25/uniapp_file_online_preview/
[Link 1]: https://mirrors.cloud.tencent.com/libreoffice/libreoffice/stable/
[LibreOffice_7.0.1_Linux_x86-64_rpm.tar.gz]: https://mirrors.cloud.tencent.com/libreoffice/libreoffice/stable/7.0.1/rpm/x86_64/LibreOffice_7.0.1_Linux_x86-64_rpm.tar.gz
[LibreOffice_7.0.1_Linux_x86-64_rpm_sdk.tar.gz]: https://mirrors.cloud.tencent.com/libreoffice/libreoffice/stable/7.0.1/rpm/x86_64/LibreOffice_7.0.1_Linux_x86-64_rpm_sdk.tar.gz
[LibreOffice_7.0.1_Linux_x86-64_rpm_langpack_zh.tar.gz]: https://mirrors.cloud.tencent.com/libreoffice/libreoffice/stable/7.0.1/rpm/x86_64/LibreOffice_7.0.1_Linux_x86-64_rpm_langpack_zh-CN.tar.gz
[b08d2551b1475125205269cada880345.png]: /images/20221123/e4ec8f4b3e184f35a14ffd386a90a11a.png
[912e0c26f43a695b2205687ec2dd8823.png]: /images/20221123/faea2ebc944f45d88f61d6fdd0cb57bd.png
[5d877660f7f461c9f0933e78895fb53a.png]: /images/20221123/8a27dc4ab96648dca5ed4c627637c2c4.png
[5f4f9eab72e0e0e4f95e8c76e17f3019.png]: /images/20221123/0fcf189e47b243ff93d40038655d8bf2.png
[b9c369443b192642f975be9020b3234e.png]: http://silianpan.cn/wp-content/uploads/2019/10/b9c369443b192642f975be9020b3234e.png
[weixin.gif]: http://silianpan.cn/wp-content/themes/yusi1.0/img/weixin.gif
[Link 2]: http://silianpan.cn
[- LibreOffice vs OpenOffice]: http://silianpan.cn/index.php/2020/09/09/file_preview_libreoffice/