SpringBoot集成OpenOffice实现doc文档转html

红太狼 2022-09-12 03:54 592阅读 0赞

# 场景 #

## OpenOffice ##

OpenOffice.org(通称OpenOffice；简称OOo或OO.o)是一套开放源代码的办公室软件，可以在多种操作系统上运作。

默认的文件交换格式是已经成为ISO标准的开放文件格式(ODFOpenDocument Format)，此外也支援Microsoft Office 97至2010的文件格式，

以及其余常见的文件档案。

需求是将doc文档转换成html文件。

注：

博客：  
[BADAO\_LIUMANG\_QIZHI的博客\_CSDN博客][BADAO_LIUMANG_QIZHI_CSDN]  
关注公众号  
霸道的程序猿  
获取编程相关电子书、教程推送与免费下载。

# 实现 #

1、OpenOffice下载

需要在服务器上安装OpenOffice，然后在SpringBoot去调用OpenOffice的服务实现转换。

这里本地是Windows系统，所以选择对应的版本的安装包下载。

[Apache OpenOffice - Official Download][]

![watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAQkFEQU9fTElVTUFOR19RSVpISQ_size_20_color_FFFFFF_t_70_g_se_x_16][]

2、OpenOffice安装

下载完exe安装包之后，双击一路安装，记得选择和记住安装的位置，安装成功之后出现如下图标。

![watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAQkFEQU9fTElVTUFOR19RSVpISQ_size_5_color_FFFFFF_t_70_g_se_x_16][]

这里的安装路径为D:/OpenOffice

![watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAQkFEQU9fTElVTUFOR19RSVpISQ_size_20_color_FFFFFF_t_70_g_se_x_16 1][]

3、启动OpenOffice的服务

来到上面OpenOffice的安装路径下，在此打开cmd

soffice-headless-accept="socket,host=127.0.0.1,port=8100;urp;" -nofirststartwizard

![watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAQkFEQU9fTElVTUFOR19RSVpISQ_size_20_color_FFFFFF_t_70_g_se_x_16 2][]

执行如上命令，启动所需服务。如果没有报错则正常启动

4、新建SpringBoot项目

这里直接使用项目快速开发框架搭建起来项目

若依前后端分离版手把手教你本地搭建环境并运行项目：

[若依前后端分离版手把手教你本地搭建环境并运行项目\_BADAO\_LIUMANG\_QIZHI的博客-CSDN博客\_若依前后端分离版本的配置![icon-default.png?t=L892][icon-default.png_t_L892]https://blog.csdn.net/BADAO\_LIUMANG\_QIZHI/article/details/108465662][BADAO_LIUMANG_QIZHI_-CSDN_icon-default.png_t_L892_icon-default.png_t_L892_https_blog.csdn.net_BADAO_LIUMANG_QIZHI_article_details_108465662]

上面在搭建起来前后端分离版的项目后。

在后端SpringBoot项目的pom文件中，引入如下依赖

<dependency>
                <groupId>org.jodconverter</groupId>
                <artifactId>jodconverter-core</artifactId>
                <version>4.2.2</version>
            </dependency>
            <dependency>
                <groupId>org.jodconverter</groupId>
                <artifactId>jodconverter-spring-boot-starter</artifactId>
                <version>4.2.2</version>
            </dependency>
            
            
            <dependency>
                <groupId>org.jodconverter</groupId>
                <artifactId>jodconverter-local</artifactId>
                <version>4.2.2</version>
            </dependency>
            
            <dependency>
                <groupId>commons-io</groupId>
                <artifactId>commons-io</artifactId>
                <version>2.6</version>
            </dependency>

![watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAQkFEQU9fTElVTUFOR19RSVpISQ_size_20_color_FFFFFF_t_70_g_se_x_16 3][]

5、配置文件中添加配置

找到application.yml中添加如下jodconverter的配置

#jodconverter配置
    jodconverter:
      local:
          enabled: true
      #home:安装地址
          office-home: D:\\OpenOffice
          max-tasks-per-process: 10
          port-numbers: 8100

要特别注意的是这里的home要跟你上面openoffice的安装路径所对应。

另外这里的端口不要乱改，就是上面启动openOffice的服务时指定的端口。

![watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAQkFEQU9fTElVTUFOR19RSVpISQ_size_20_color_FFFFFF_t_70_g_se_x_16 4][]

6、新建Word文档

新建一个word文档，并新增一些内容，然后将其放在resource下新建的static目录下

![watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAQkFEQU9fTElVTUFOR19RSVpISQ_size_20_color_FFFFFF_t_70_g_se_x_16 5][]

7、新建Controller

新建一个Controller，直接注入转换器

@RestController
    @RequestMapping("/openoffice")
    public class OpenOfficeController extends BaseController
    {
        // 第一步：转换器直接注入
        @Autowired
        private DocumentConverter converter;

然后编写转换的方法

@RequestMapping("/convertToHtml")
        public void convertToHtml() throws OfficeException, FileNotFoundException {
            //转换后的新文件
            File newFile = new File("D://badao.html");
            //需要转换的文件
            File sourceFile = new File(ResourceUtils.getFile("classpath:static").getAbsolutePath() + "\\badao.doc");
            converter.convert(sourceFile).to(newFile).execute();
        }

直接调用转换器的converter方法即可，这里将转换后的文件存放在D盘下。

完整Controller方法

package com.ruoyi.web.controller.system;
    
    import com.ruoyi.common.core.controller.BaseController;
    import org.jodconverter.DocumentConverter;
    import org.jodconverter.office.OfficeException;
    import org.springframework.beans.factory.annotation.Autowired;
    import org.springframework.util.ResourceUtils;
    import org.springframework.web.bind.annotation.RequestMapping;
    import org.springframework.web.bind.annotation.RestController;
    import java.io.File;
    import java.io.FileNotFoundException;
    
    @RestController
    @RequestMapping("/openoffice")
    public class OpenOfficeController extends BaseController
    {
        // 第一步：转换器直接注入
        @Autowired
        private DocumentConverter converter;
    
        @RequestMapping("/convertToHtml")
        public void convertToHtml() throws OfficeException, FileNotFoundException {
            //转换后的新文件
            File newFile = new File("D://badao.html");
            //需要转换的文件
            File sourceFile = new File(ResourceUtils.getFile("classpath:static").getAbsolutePath() + "\\badao.doc");
            converter.convert(sourceFile).to(newFile).execute();
        }
       
    }

然后就可以直接使用接口测试工具调用该接口进行测试转换效果。

8、使用前端调用接口测试效果。

因为这里考虑后面业务流程的实现，所以用前端调用该接口进行测试。

前端新增页面，页面新增按钮，按钮设置点击方法，调用Js中的方法

<template>
      <div class="component-upload-image">
        <el-button @click="convertToHtmlRequest">doc转换成html</el-button>
      </div>
    </template>
    
    <script>
    import {convertToHtml } from "@/api/system/openOffice";
    export default {
      name: "openOffice",
      data() {
        return {
         
        };
      },
      methods: {
        convertToHtmlRequest() {
          convertToHtml().then((response) => {
            console.log(response);
          });
        }
      },
      watch: {},
    };
    </script>
    
    <style scoped lang="scss">
    
    </style>

调用的js代码中发出请求并调用后台接口

import request from '@/utils/request'
    
    export function convertToHtml() {
      return request({
        url: '/openoffice/convertToHtml',
        method: 'get',
      })
    }

效果展示

![watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAQkFEQU9fTElVTUFOR19RSVpISQ_size_20_color_FFFFFF_t_70_g_se_x_16 6][]

9、问题

如果后台在启动时提示：

invalid officeHome: it doesn't contain soffice.bin:D:...

![watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAQkFEQU9fTElVTUFOR19RSVpISQ_size_20_color_FFFFFF_t_70_g_se_x_16 7][]那就是OpenOffice的安装路径和在application.yml中配置的路径不对应。

[BADAO_LIUMANG_QIZHI_CSDN]: https://blog.csdn.net/badao_liumang_qizhi
[Apache OpenOffice - Official Download]: https://www.openoffice.org/download/
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAQkFEQU9fTElVTUFOR19RSVpISQ_size_20_color_FFFFFF_t_70_g_se_x_16]: /images/20220828/fc060a0a04604d2f9d85aacfa1a7d2e2.png
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAQkFEQU9fTElVTUFOR19RSVpISQ_size_5_color_FFFFFF_t_70_g_se_x_16]: /images/20220828/82cd515cc2ba4ed1a02e1d57a7bd1e28.png
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAQkFEQU9fTElVTUFOR19RSVpISQ_size_20_color_FFFFFF_t_70_g_se_x_16 1]: /images/20220828/b7cf3fb889f74d38be7ef92fc0f0a70e.png
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAQkFEQU9fTElVTUFOR19RSVpISQ_size_20_color_FFFFFF_t_70_g_se_x_16 2]: /images/20220828/dcec5b2b24514ef2a49a3ad2977c22a9.png
[icon-default.png_t_L892]: https://csdnimg.cn/release/blog_editor_html/release1.9.1/ckeditor/plugins/CsdnLink/icons/icon-default.png?t=L892
[BADAO_LIUMANG_QIZHI_-CSDN_icon-default.png_t_L892_icon-default.png_t_L892_https_blog.csdn.net_BADAO_LIUMANG_QIZHI_article_details_108465662]: /images/20220828/869a490dfbc24edc85554fdba32d6862.png
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAQkFEQU9fTElVTUFOR19RSVpISQ_size_20_color_FFFFFF_t_70_g_se_x_16 3]: /images/20220828/3238dba4daa54d9d965bebfbe455c96a.png
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAQkFEQU9fTElVTUFOR19RSVpISQ_size_20_color_FFFFFF_t_70_g_se_x_16 4]: /images/20220828/9eab92bb6e6845afacc2bbf3b84a000e.png
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAQkFEQU9fTElVTUFOR19RSVpISQ_size_20_color_FFFFFF_t_70_g_se_x_16 5]: /images/20220828/1c84a7377578494786f791355ab263e5.png
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAQkFEQU9fTElVTUFOR19RSVpISQ_size_20_color_FFFFFF_t_70_g_se_x_16 6]: /images/20220828/faf53a577f384aa6ab413180ad2d5397.png
[watermark_type_ZHJvaWRzYW5zZmFsbGJhY2s_shadow_50_text_Q1NETiBAQkFEQU9fTElVTUFOR19RSVpISQ_size_20_color_FFFFFF_t_70_g_se_x_16 7]: /images/20220828/70e0529d6bd4489391953e2f8ff6a6ea.png