在线文档预览工具kkFileView

kkFileView是一个基于spring boot打造文件文档在线预览项目解决方案,支持doc、docx、ppt、pptx、xls、xlsx、zip、rar、mp4、mp3以及众多类文本如txt、html、xml、java、properties、sql、js、md、json、conf、ini、vue、php、py、bat、gitignore等文件在线预览 http://file.keking.cn

项目特性

  • 支持office,pdf等办公文档
  • 支持txt,java,php,py,md,js,css等所有纯文本
  • 支持zip,rar,jar,tar,gzip等压缩包
  • 支持jpg,jpeg,png,gif等图片预览(翻转,缩放,镜像)
  • 使用spring boot开发,预览服务搭建部署非常简便
  • rest接口提供服务,跨平台特性(java,php,python,go,php,….)都支持,应用接入简单方便
  • 抽象预览服务接口,方便二次开发,非常方便添加其他类型文件预览支持
  • 最最重要Apache协议开源,代码pull下来想干嘛就干嘛

快速开始

环境安装

项目依赖以下环境:

  1. redis
  2. OpenOffice或者LibreOffice

运行环境

下载源码

可以通过以下地址,下载最新的稳定版源码
https://gitee.com/kekingcn/file-online-preview/releases

修改环境配置

修改环境配置:修改配置文件中的redis连接和本地目录配置

jodconverter-web/src/main/resources/application-dev.properties

1
2
3
4
5
6
#=============================================#spring Redisson配置#===================================#
spring.redisson.address = 127.0.0.1:6379
##资源映射路径(因为jar方式运行的原因)
file.dir = C:\\Users\\yudian\\Desktop\\dev\\
## openoffice相关配置
office.home = C:\\Program Files (x86)\\OpenOffice 4

file.dir为转换文件实际存储地址,注意要以/结尾

特别注意:目录在windows系统,一定要使用\\双斜杠,单斜杠启动会报错

编辑环境

使用maven打包工具进行编译,编译成可以执行的jar文件。

进入file-online-preview目录。

打包命令:mvn clean install -Dmaven.test.skip=true

执行成功后,会在jodconverter-web/target目录中生成一个文件jodconverter-web-1.5.8.RELEASE.jar

启动服务

windows环境下载bat启动脚本,新建一个start.bat文件,拷贝以下内容

1
2
3
4
@echo off
title jodconverter
java -Xmx1024m -Xms1024m -Xss256k -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=256m -jar jodconverter-web-1.5.8.RELEASE.jar
@pause

访问服务

访问http://localhost:8012/成功,代表服务启动成功

参考地址

https://gitee.com/kekingcn/file-online-preview