昨晚搭建環境都花了好一會時間，主要在浪費在了安裝 openoffice 這個依賴環境上(Mac 須要手動安裝)。php
而後，又一步一步功能演示，記錄，調試項目，而且簡單研究了一下核心代碼以後才把這篇文章寫完。html
另外，這篇文章我還會簡單分析一下項目核心代碼。前端
若是有幫助，歡迎點贊/再看鼓勵，我會開心好久 ღ( ´･ᴗ･` )比心vue
項目介紹
官方是這樣介紹 kkFileView 的：java
kkFileView 是使用 spring boot 打造文件文檔在線預覽項目解決方案，支持 doc、docx、ppt、pptx、xls、xlsx、zip、rar、mp四、mp3 以及衆多類文本如 txt、html、xml、java、properties、sql、js、md、json、conf、ini、vue、php、py、bat、gitignore 等文件在線預覽git
簡單來講 kkFileView 就是常見的文件類型的在線預覽解決方案。程序員
總的來講我以爲 kkFileView 是一個很是棒的開源項目，在線文件預覽這個需求很是常見。感謝開源！github
下面， 我站在一個「上帝」的角度從多個維度來評價一下 kkFileView：web
- 代碼質量通常，有不少能夠優化的地方好比：
Controller層代碼嵌套太多邏輯- 沒有進行全局異常處理(代碼中是直接返回錯誤信息的 json 數據給前端，我並不推薦這樣作)
- 返回值不須要經過
ObjectMapper轉換爲 JSON 格式（ResponseEntity+@RestController就好了） - ......
- 使用的公司比較多，說明項目總體功能仍是比較穩定和成熟的！
- 代碼總體邏輯仍是比較清晰的，比較容易看懂，給做者們點個贊！
環境搭建
克隆項目
經過如下命令便可將項目克隆到本地：面試
git clone https://gitee.com/kekingcn/file-online-preview.git
安裝 OpenOffice
office 類型的文件的預覽依賴了 OpenOffice ，因此咱們首先要安裝 OpenOffice(Windows 下已內置，Linux 會自動安裝，Mac OS 下須要手動安裝)。
下面演示一下如何在 Mac 上安裝 OpenOffice。
你能夠經過如下命令安裝最新版的 OpenOffice：
brew cask install openoffice
不過，這種方式下載可能會比較慢，你能夠直接去官網下載 dmg 安裝包。
官方下載地址：https://www.openoffice.org/download/
不少小夥伴就要問了：OpenOffice 是什麼呢？
OpenOffice 是 Apache 旗下的一款開源免費的文字處理軟件，支持 Windows、Liunx、OS X 等主流操做系統。
OpenOffice 和 Windows 下 office 辦公軟件有點相似，不過其實開源免費的。
啓動項目
運行FilePreviewApplication的 main 方法，服務啓動後，訪問http://localhost:8012/ 會看到以下界面，表明服務啓動成功。
使用
咱們首先上傳了 3 個不一樣的類型的文件來分別演示一下圖片、PDF、Word 文檔的預覽。
圖片的預覽
kkFileView 支持 jpg，jpeg，png，gif 等多種格式圖片的預覽，還包括了翻轉，縮放圖片等操做。
圖片的預覽效果以下。
Word 文檔的預覽
kkFileView 支持 doc，docx 文檔預覽。
另外，根據 Word 大小以及網速問題， Word 預覽提供了兩種模式：
- 每頁 Word 轉爲圖片預覽
- 整個 Word 文檔轉成 PDF，再預覽 PDF。
兩種模式的適用場景以下
- 圖片預覽 ：Word 文件大（加載 PDF 速度比較慢）的狀況。
- PDF 預覽 ：內網訪問（加載 PDF 速度比較快）的狀況。
圖片預覽模式預覽效果以下：
PDF 預覽模式預覽效果以下：
PDF 文檔的預覽
kkFileView 支持 PDF 文檔預覽。相似 Word 文檔預覽， PDF 預覽提供了兩種模式：
- 每頁 Word 轉爲圖片預覽
- 整個 Word 文檔轉成 PDF，再預覽 PDF。
因爲和 Word 文檔的預覽展現效果一致，這裏就不放圖片了。
文件預覽核心代碼分析
API 層
文件預覽調用的接口是 /onlinePreview 。
經過分析 /onlinePreview 接口咱們發現， 後端接收到預覽請求以後，會從 URL 和請求中篩選出本身須要的信息好比文件後綴、文件名。
以後會調用FilePreview類 的 filePreviewHandle() 方法。filePreviewHandle() 方法是實現文件預覽的核心方法。
@RequestMapping(value = "/onlinePreview")
public String onlinePreview(String url, Model model, HttpServletRequest req) {
FileAttribute fileAttribute = fileUtils.getFileAttribute(url);
req.setAttribute("fileKey", req.getParameter("fileKey"));
model.addAttribute("pdfDownloadDisable", ConfigConstants.getPdfDownloadDisable());
model.addAttribute("officePreviewType", req.getParameter("officePreviewType"));
FilePreview filePreview = previewFactory.get(fileAttribute);
logger.info("預覽文件url：{}，previewType：{}", url, fileAttribute.getType());
return filePreview.filePreviewHandle(url, model, fileAttribute);
}
FilePreview 是文件預覽接口，不一樣的文件類型的預覽都實現了 FilePreview 接口，並實現了 filePreviewHandle() 方法。
文件預覽接口
public interface FilePreview {
String filePreviewHandle(String url, Model model, FileAttribute fileAttribute);
}
不一樣的文件類型的預覽都實現了 FilePreview 接口，以下圖所示。
不一樣文件類型的預覽都會實現 FilePreview 接口，而後重寫filePreviewHandle()方法。好比： OfficeFilePreviewImpl 這個主要負責處理 office 文件的預覽、PdfFilePreviewImpl 主要負責處理 pdf 文件的預覽。
文件預覽具體實現分析
下面咱們以 office 文件的預覽爲入口來分析。
首先要明確的是 excel 類型的預覽是經過將 excel 文件轉換爲 HTML 實現的，其餘類型 office 文件的預覽是經過將文件轉換爲 PDF 或者是 圖片的方式來預覽的。
舉個例子。咱們上傳了一份名爲 武漢市文化市場管理辦法.docx 的 Word 文件並預覽的話，jodconverter-web/src/main/file 路徑下會生成兩個相關文件，這兩個文件分別對應了咱們提到的 PDF 預覽 和 圖片預覽這兩種方式。
武漢市文化市場管理辦法.pdf- 由 Word 文件所轉化獲得的一系列圖片
咱們以一個名爲 武漢市文化市場管理辦法.docx 的文件來舉例說明一下代碼中是如何作的。
經過分析代碼， 咱們定位到了 OfficeFilePreviewImpl 這個主要負責處理 office 文件預覽的類。
/**
* 處理office文件
*/
@Service
public class OfficeFilePreviewImpl implements FilePreview {
}
咱們來簡單分析一下 OfficeFilePreviewImpl 類中實現預覽的核心方法是 filePreviewHandle 。
說明：這部分代碼的邏輯不夠清晰，還能夠抽方法優化以讓人更容易讀懂，感興趣的小夥伴能夠本身動手重構一下，而後去給做者提個 PR。
@Override
public String filePreviewHandle(String url, Model model, FileAttribute fileAttribute) {
// 1.獲取預覽類型(image/pdf/html)，用戶請求中傳了officePreviewType參數就取參數的，沒傳取系統默認（image）
String officePreviewType = model.asMap().get("officePreviewType") == null ? ConfigConstants.getOfficePreviewType() : model.asMap().get("officePreviewType").toString();
// 2.獲取 URL 地址
String baseUrl = BaseUrlFilter.getBaseUrl();// http://localhost:8012/
// 3.獲取圖片相關信息
String suffix=fileAttribute.getSuffix();//文件後綴如docx
String fileName=fileAttribute.getName();//文件名如：武漢市文化市場管理辦法.docx
// 4. 判斷是否爲 html 格式預覽也就是判斷文件否爲 excel
boolean isHtml = suffix.equalsIgnoreCase("xls") || suffix.equalsIgnoreCase("xlsx");
// 5. 將文件的後綴名更換爲 .pdf 或者 .html（excel文件的狀況）
String pdfName = fileName.substring(0, fileName.lastIndexOf(".") + 1) + (isHtml ? "html" : "pdf");
// 6. 轉換後的文件輸出的文件夾如 file-online-preview/jodconverter-web/src/main/file/武漢市文化市場管理辦法.pdf）
String outFilePath = FILE_DIR + pdfName;
// 7 .判斷以前是否已轉換過，若是轉換過，直接返回，不然執行轉換
// 文件第一次被預覽的時候會首先對文件進行緩存處理
if (!fileUtils.listConvertedFiles().containsKey(pdfName) || !ConfigConstants.isCacheEnabled()) {
String filePath;
// 下載文件
ReturnResponse<String> response = downloadUtils.downLoad(fileAttribute, null);
if (0 != response.getCode()) {
model.addAttribute("fileType", suffix);
model.addAttribute("msg", response.getMsg());
return "fileNotSupported";
}
filePath = response.getContent();
if (StringUtils.hasText(outFilePath)) {
officeToPdf.openOfficeToPDF(filePath, outFilePath);
if (isHtml) {
// 對轉換後的文件進行操做(改變編碼方式)
fileUtils.doActionConvertedFile(outFilePath);
}
if (ConfigConstants.isCacheEnabled()) {
// 加入緩存
fileUtils.addConvertedFile(pdfName, fileUtils.getRelativePath(outFilePath));
}
}
}
// 8.根據預覽類型officePreviewType，選擇不一樣的預覽方式
// 好比,若是預覽類型officePreviewType爲pdf則進行pdf方式預覽
if (!isHtml && baseUrl != null && (OFFICE_PREVIEW_TYPE_IMAGE.equals(officePreviewType) || OFFICE_PREVIEW_TYPE_ALL_IMAGES.equals(officePreviewType))) {
return getPreviewType(model, fileAttribute, officePreviewType, baseUrl, pdfName, outFilePath, pdfUtils, OFFICE_PREVIEW_TYPE_IMAGE);
}
model.addAttribute("pdfUrl", pdfName);
return isHtml ? "html" : "pdf";
}
項目地址： https://github.com/kekingcn/kkFileView
我整理了一份優質原創PDF資源免費分享給你們，大部份內容都是個人原創，少部分來自朋友。
<img src="https://cdn.jsdelivr.net/gh/javaguide-tech/blog-images/2020-10/image-20201012105544846.png" style="zoom:50%;" />
<img src="https://cdn.jsdelivr.net/gh/javaguide-tech/blog-images/2020-10/image-20201012105608336.png" alt="image-20201012105608336" style="zoom:50%;" />
下載地址：https://cowtransfer.com/s/fbed14f0c22a4d 。
個人開源項目推薦
- JavaGuide ：「Java學習+面試指南」一份涵蓋大部分Java程序員所須要掌握的核心知識。準備 Java 面試，首選 JavaGuide！
- guide-rpc-framework ：A custom RPC framework implemented by Netty+Kyro+Zookeeper.（一款基於 Netty+Kyro+Zookeeper 實現的自定義 RPC 框架-附詳細實現過程和相關教程）
- jsoncat ：仿 Spring Boot 但不一樣於 Spring Boot 的一個輕量級的 HTTP 框架
- programmer-advancement ：程序員應該有的一些好習慣+面試必知事項！
- springboot-guide ：Not only Spring Boot but also important knowledge of Spring（不僅是SpringBoot還有Spring重要知識點）
- awesome-java ：Collection of awesome Java project on Github(Github 上很是棒的 Java 開源項目集合).
我是 Guide 哥，一 Java 後端開發，會一點前端，自由的少年。咱們下期再見！微信搜「JavaGuide」回覆「面試突擊」領取我整理的 4 本原創PDF