跳到主要内容

📎 OFFICE文档预览

说明:

该预览原理为通过转换文件格式为pdf进行浏览器预览,特殊样式的文档会显示不全或显示错位,所以它并不是一个特别完美的预览方案,请酌情考虑使用。

该组件不依赖于cn.skyisazure.wjjhook:core,可独立使用。

该组件依赖于通过软件安装的openoffice,下载安装可参考:官网

使用

* 必须:需要安装openoffice服务,用于转换为pdf文件

引入依赖:

必要依赖:hutool和springboot-web

<dependency>
<groupId>cn.skyisazure.wjjhook</groupId>
<artifactId>office-preview-spring-boot-starter</artifactId>
<version>${office.perview.version}</version>
</dependency>

配置:

spring:
wjjhook:
office:
# openoffice服务host
host: 192.168.0.250
# 端口
ports: 8100
# 这个值是个数组,正常情况下写一个端口号即可。
# ports:
# - 8100
# - 8200
# 执行超时时间
task-execution-timeout: 600000
# 任务队列等待超时时间
task-queue-timeout: 600000

然后可在项目中直接GET访问:

/office-preview?path=XXXXX(应该通过浏览器直接访问,而不是接口)

path参数可接受网络地址、本地地址、resource对应地址。要求结尾要有文件的格式信息(即:.docx.xlsx...)

例如:

  • 网络地址(网络文件)

    /office-preview?path=https://www.abc.com/file/random.xlsx

  • 本地路径(服务器文件)

    /office-preview?path=/root/file/random.xlsx(LINUX)

    /office-preview?path=C:/file/random.xlsx(WINDOWS)

  • resource(项目resources中文件的相对路径)

    /office-preview?path=/file/random.xlsx