文檔在線預覽 kkFileView 使用小記

 如果你是通過搜索引擎找到這篇文章的,相信你大概率已經去過kkfileview的github首頁了

在此我就不做過多介紹了,如果是在不清楚項目基本信息請自己去看github

我在這篇博文主要寫的是使用方式,希望能幫助到大家

以下將該項目簡稱為kk

------------------------------------------------------------------------------

一  :  先說原理

1.kk接口通過http或者ftp方式拿到文件服務器上的文件,下載kk服務所在服務器

2.調用轉換接口轉換文件

3.通過open的方式打開新的文件,通過生成的頁面裝填進去(doc通常是圖片或pdf,excel就直接是html了)

 

kk3.x主要是使用其內部重構的org.artofsolving.jodconverter代碼進行轉換

------------------------------------------------------------------------------

二  :  使用姿勢

 

假設你的kk服務部署在linux服務器上

1.下載kkfileview的tar.gz包 (推薦使用3.6.0 ,坑少)

2.解壓到具體目錄,並運行{KK_HOME}/bin/install.sh  安裝openoffice,具體看官方文檔,有詳細解釋

3.修改{KK_HOME}/config/application.properties

 

強烈推薦使用ftp方式獲取待轉換的文件,本文只寫了ftp方式,http方式請自行搭建http文件服務,這里不做展開

 

　　修改項:

　　　　　　　　1. ftp.username 

　　　　　　　　2. ftp.password

4.安裝Linux中文字體(因為大部分運維都不會去安裝這些字體),可以防止轉換文件的時候亂碼,尤其是word excel這些

點擊 這里的鏈接 教程安裝

5. 點擊這里 找到 

非匿名訪問，確定只有訪問一台FTP服務器 

var url = 'ftp://127.0.0.1/file/test.txt'; //要預覽文件的訪問地址
window.open('http://127.0.0.1:8012/onlinePreview?url='+encodeURIComponent(url));

6. 新建一個html頁面

引入

    <script type="text/javascript" src="https://cdn.jsdelivr.net/npm/js-base64@3.6.0/base64.min.js"></script>

    <script src="http://apps.bdimg.com/libs/jquery/1.9.1/jquery.min.js"></script>

7. 保存html 然后瀏覽器打開 ,第一次打開會提示阻止彈窗,點擊允許

---------------------------------------------------------------------------------------------------------------------

 

三  :  問題排查

 

假設按照上面的步驟你遇到了坑

排查問題的思路主要在這幾點

 

1.檢查前端頁面的base64包,轉換之后的編碼是否和你要打開的文件名一致

2.檢查ftp服務器,用戶名,密碼,端口,如果ftp服務器沒有用默認端口,那么需要在

var url = 'ftp://127.0.0.1/file/test.txt'; //要預覽文件的訪問地址

 這句話加上端口,例如

var url = 'ftp://127.0.0.1:9876/file/test.txt'; //要預覽文件的訪問地址

　　9876就是ftp服務端口

3.檢查文件是否損壞,正常情況下能不能打開

4.kk服務器端口,默認8012是否開啟

------------------------------------------------------------------------------------------------------------------

 

總的來說,需要結合報錯信息來找問題,

結尾真摯的說一句kkfileview,NB! 感謝