📎 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