一:背景
用户在查看文章详情的时候,文章除了正文外还附带有各类型附件(如:word,excel,ppt,zip等),当用户想要查看附件时,需要先下载到本地再打开,这样很不方便,于是用户希望能够有在线预览附件的功能。
二:方案(参考:)
日常开发中常见的文件格式有pdf,word,Excel,PPT,Html,txt,图片等。pdf,Html,txt,图片这种实现在线预览非常简单,有一些前端的插件可以满足要求。word,Excel,PPT如果要实现在线预览,就非常的困难。word,Excel,PPT实现在线预览常用的方式就是先转换成pdf,然后在进行预览。下面我就介绍常用的几种方案
方法一、kkfileview 文件在线预览
kkfileview支持文件格式多,而且不用开发。不过需要单独部署一个文件预览的服务,而且服务
器也需要安装openoffice。
方法二、officetohtml纯前端的方式
officetohtml纯前端的方式可以不用安装任何插件及服务,但是目前只支持文件地址的方式预览
,如果是文件流的话无法使用。
方法三、JODConverter
JODConverter 依赖于openoffice,需要在服务器单独安装openoffice。
方法四、Aspose
Aspose使用的是破解版的,如果商用使用需要考虑版权问题。
综上所述,考虑到方法四有版权问题所以我首先排除了选四,一,二,三都需要安装openoffice,又由于方法一支持的文件类型更多而且无需开发,所以最终我选择了方法一,接下来我就单讲方法一的整个实现过程。
三:kkfileview 文件在线预览具体实现
1. windows环境部署运行
1.1 环境要求
1. Java: 1.8+
2. OpenOffice或LiberOffice(Windows下已内置)无需考虑此条
1.2 下载 kkFileView-4.0.0.zip(Windows版)
下载链接:kkFileView 发行版 - Gitee.com
或从我的资源里拿
1.3 解压 kkFileView-4.0.0.zip ,然后进入到kkFileView-4.0.0/bin/ 目录下,双击 startup.bat 即可启动该应用。浏览器能正常访问:http://localhost:8012 即可表示启动正常。
1.4 项目接入使用
如果你的项目需要接入文件预览项目,达到对docx,excel,ppt,jpg等文件的预览效果,那么通过在你的前端项目中加入下面的代码即可成功实现。
var url = 'http://127.0.0.1:8080/file/test.txt'; //要预览文件的访问地址
window.open('http://127.0.0.1:8012/onlinePreview?url='+encodeURIComponent
(Base64.encode(url)));
黄色背景部分为运行的kkFileView的地址
Base64 一定要用,否则文件打不开
完毕!
2. linux环境部署运行
2.1 环境要求
1. Java: 1.8+
2. OpenOffice或LiberOffice(CentOS或Ubuntu下, 联网了会自动下载安装,MacOS下需要
自行安装),由于我是CentOS系统且是内网,无法自动下载,于是我选择了手动下载安装包并离线安装LiberOffice。
2.2 下载 LibreOffice_7.1.4_Linux_x86-64_rpm.tar.gz(Linux版)
将LibreOffice_7.1.4_Linux_x86-64_rpm.tar.gz上传到服务器后解压,进入到LibreOffice_7.1.4_Linux_x86-64_rpm/RPMS/目录下,进行LibreOffice的安装:
> cd /LibreOffice_7.1.4_Linux_x86-64_rpm/RPMS/
> yum localinstall *.rpm
安装完成后会出现/opt/libreOffice7.1目录。
备注:如果想要卸载libreOffice,则:
1.查看安装的(会显示安装了的列表):rpm -qa|grep libreoffice
2.卸载(根据列表显示的):yum remove libreoffice7.1-ure-7.1.4.2-2.x86_64
3. yum remove 剩余列表显示的
4.删除 /opt/ 目录下的libreOffice7.1 文件夹即可完成卸载。
2.3 下载 kkFileView-4.0.0.tar.gz (Linux或MacOS版)
下载链接:kkFileView 发行版 - Gitee.com
或从我附件里拿
2.4 上传 kkFileView-4.0.0.tar.gz 包到服务器后解压
> tar -zxvf kkFileView-4.0.0.tar.gz
2.5 进入解压后的文件夹目录 /kkFileView-4.0.0/bin/ ,启动 kkFileView 应用
> sh startup.sh
2.6 启动后可以去 /kkFileView-4.0.0/log/kkFileView.log查看日志,如果日志报如下错误,可以先将
kkFileView进程 kill掉,然后 kill 掉报错信息里的 2001端口的pid和2002端口的pid,然后再次重启即可
报错信息:
Caused by:.....Error creating bean with name 'officePluginManager': Invocation of init method failed:....failed to start and connect
Caused by:org.artofsolving.jodconverter.office.OfficeException:failed to start and connect
Caused by:....office.OfficeException:could not establish connection
Caused by:.....a process with acceptString 'socket,host=127.0.0.1,port=2001' is already running;pid 299361
2.7 浏览器能正常访问:http://服务器ip:8012 表明kkFileView应用运行正常,接下来参照上面的项目接入使用即可。