SpringBoot+MinIO+KKFileView實現(xiàn)文件預(yù)覽功能
在現(xiàn)代的 Web 應(yīng)用中，文件上傳和預(yù)覽是常見的需求場景。尤其是在內(nèi)容管理系統(tǒng)（CMS）或企業(yè)內(nèi)部應(yīng)用中，文件預(yù)覽功能尤為重要。通過 Spring Boot 搭配 MinIO 和 KKFileView，我們可以輕松實現(xiàn)高效的文件存儲和在線預(yù)覽功能。
本文將從以下幾個方面，帶你逐步實現(xiàn)一個簡單的文件預(yù)覽系統(tǒng)。
一、項目背景和技術(shù)選型
- Spring Boot：主流的 Java 后端開發(fā)框架，用于快速構(gòu)建 RESTful 服務(wù)。
- MinIO：一款高性能的對象存儲服務(wù)，支持 S3 協(xié)議，適合大文件存儲。
- KKFileView：一款輕量級文件在線預(yù)覽服務(wù)，支持多種文件格式（如 Office 文檔、PDF、圖片等）。
系統(tǒng)架構(gòu)圖：
功能目標(biāo)
用戶上傳文件到 MinIO。
后端通過 KKFileView 生成文件預(yù)覽鏈接。
用戶通過前端直接查看文件內(nèi)容。
二、環(huán)境準(zhǔn)備
1. MinIO 安裝和啟動
下載并運行 MinIO：
docker run -p 9000:9000 -p 9001:9001 \ --name minio \ -e "MINIO_ROOT_USER=minioadmin" \ -e "MINIO_ROOT_PASSWORD=minioadmin" \ quay.io/minio/minio server /data --console-address ":9001"
訪問 MinIO 控制臺：http://localhost:9001
默認(rèn)賬號密碼：
- 用戶名：minioadmin
- 密碼：minioadmin
創(chuàng)建一個存儲桶（如 preview-files）。
2. KKFileView 安裝和啟動
下載并運行 KKFileView：
docker run -d --name kkfileview \ -p 8012:8012 \ --restart=always \ kekingcn/kkfileview:latest
訪問 KKFileView 服務(wù)：http://localhost:8012
三、項目代碼實現(xiàn)
1. 引入依賴
在 pom.xml 文件中添加以下依賴：
<dependencies>
<!-- Spring Boot Web -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!-- MinIO 客戶端 -->
<dependency>
<groupId>io.minio</groupId>
<artifactId>minio</artifactId>
<version>8.5.4</version>
</dependency>
<!-- Apache Commons IO -->
<dependency>
<groupId>commons-io</groupId>
<artifactId>commons-io</artifactId>
</dependency>
</dependencies>2. 配置文件
在 application.yml 中配置 MinIO 和 KKFileView 服務(wù)地址：
minio: endpoint: http://localhost:9000 accessKey: minioadmin secretKey: minioadmin bucketName: preview-files kkfileview: serverUrl: http://localhost:8012
3. MinIO 文件上傳和預(yù)覽服務(wù)
創(chuàng)建 MinioService 類：
import io.minio.*;
import io.minio.errors.MinioException;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Service;
import java.io.InputStream;
@Service
public class MinioService {
@Value("${minio.endpoint}")
private String endpoint;
@Value("${minio.accessKey}")
private String accessKey;
@Value("${minio.secretKey}")
private String secretKey;
@Value("${minio.bucketName}")
private String bucketName;
private MinioClient getClient() {
return MinioClient.builder()
.endpoint(endpoint)
.credentials(accessKey, secretKey)
.build();
}
public String uploadFile(String fileName, InputStream inputStream, String contentType) throws Exception {
MinioClient client = getClient();
client.putObject(
PutObjectArgs.builder()
.bucket(bucketName)
.object(fileName)
.stream(inputStream, -1, 10485760)
.contentType(contentType)
.build()
);
return endpoint + "/" + bucketName + "/" + fileName;
}
}4. KKFileView 服務(wù)對接
創(chuàng)建 FilePreviewService 類：
import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Service;
@Service
public class FilePreviewService {
@Value("${kkfileview.serverUrl}")
private String kkFileViewServerUrl;
public String generatePreviewUrl(String fileUrl) {
return kkFileViewServerUrl + "/onlinePreview?url=" + fileUrl;
}
}5. REST 控制器
創(chuàng)建 FileController 類：
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.multipart.MultipartFile;
import java.io.InputStream;
@RestController
@RequestMapping("/files")
public class FileController {
@Autowired
private MinioService minioService;
@Autowired
private FilePreviewService filePreviewService;
@PostMapping("/upload")
public String uploadFile(@RequestParam("file") MultipartFile file) {
try (InputStream inputStream = file.getInputStream()) {
String fileUrl = minioService.uploadFile(file.getOriginalFilename(), inputStream, file.getContentType());
return "上傳成功，文件地址：" + fileUrl;
} catch (Exception e) {
e.printStackTrace();
return "上傳失?。? + e.getMessage();
}
}
@GetMapping("/preview")
public String previewFile(@RequestParam("fileUrl") String fileUrl) {
return filePreviewService.generatePreviewUrl(fileUrl);
}
}四、運行和測試
啟動 Spring Boot 項目。
上傳文件：
curl -F "file=@example.pdf" http://localhost:8080/files/upload
輸出類似以下內(nèi)容：
上傳成功，文件地址：http://localhost:9000/preview-files/example.pdf
生成預(yù)覽鏈接：
curl "http://localhost:8080/files/preview?fileUrl=http://localhost:9000/preview-files/example.pdf"
輸出類似以下內(nèi)容：
http://localhost:8012/onlinePreview?url=http://localhost:9000/preview-files/example.pdf
在瀏覽器中打開預(yù)覽鏈接即可查看文件內(nèi)容。
五、總結(jié)
通過 Spring Boot、MinIO 和 KKFileView 的結(jié)合，我們輕松實現(xiàn)了文件上傳和在線預(yù)覽功能。
- MinIO 提供了高效的對象存儲服務(wù)。
- KKFileView 提供了強大的文檔解析能力。
- Spring Boot 實現(xiàn)了兩者的無縫對接。
這套方案輕量高效，適合企業(yè)內(nèi)部文件管理系統(tǒng)，也可以輕松擴展至分布式環(huán)境。
到此這篇關(guān)于SpringBoot+MinIO+KKFileView實現(xiàn)文件預(yù)覽功能的文章就介紹到這了,更多相關(guān)SpringBoot MinIO KKFileView文件預(yù)覽內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
相關(guān)文章
這篇文章主要介紹了Java如何基于DOM解析xml文件,文中通過示例代碼介紹的非常詳細，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,需要的朋友可以參考下2020-09-09
背包問題是計算機科學(xué)中的經(jīng)典問題,涉及到在給定的一組物品中選擇最佳的物品組合,以使其總重量不超過背包所能承載的限制,同時獲得最大的總價值,這篇文章主要介紹了java解析背包問題的相關(guān)資料,需要的朋友可以參考下2025-10-10
使用Spring?Cloud?Stream處理事件的示例詳解
Spring?Cloud?Stream?是基于?Spring?Boot?的用于構(gòu)建消息驅(qū)動微服務(wù)的框架，本文主要介紹了如何使用?Spring?Cloud?Stream?來處理事件，需要的可以參考一下2023-06-06
MyEclipse打開文件跳轉(zhuǎn)到notepad打開問題及解決方案
windows系統(tǒng)打開README.md文件，每次都需要右鍵選擇notepad打開，感覺很麻煩，然后就把README.md文件打開方式默認(rèn)選擇了notepad，這樣每次雙擊就能打開，感覺很方便，這篇文章主要介紹了MyEclipse打開文件跳轉(zhuǎn)到notepad打開問題,需要的朋友可以參考下2024-03-03
在Java面向?qū)ο缶幊讨?抽象類是一個非常重要的概念,本文將深入淺出地講解Java抽象類的相關(guān)知識,幫助讀者徹底掌握抽象類的使用,感興趣的朋友跟隨小編一起看看吧2026-03-03
java中對list分頁并顯示數(shù)據(jù)到頁面實例代碼
這篇文章主要介紹了java中對list分頁并顯示數(shù)據(jù)到頁面實例代碼，分享了相關(guān)代碼示例，小編覺得還是挺不錯的，具有一定借鑒價值，需要的朋友可以參考下2018-02-02
java編程創(chuàng)建型設(shè)計模式工廠方法模式示例詳解
這篇文章主要為大家介紹了java編程創(chuàng)建型設(shè)計模式之工廠方法模式的創(chuàng)建及案例詳解，有需要的朋友可以借鑒參考下，希望能夠有所幫助2022-02-02
這篇文章主要介紹了Java接口定義與實現(xiàn)方法,簡單說明了接口的概念、功能,并結(jié)合實例形式分析了接口的相關(guān)定義與使用技巧,需要的朋友可以參考下2017-11-11
Java連接MySQL數(shù)據(jù)庫并實現(xiàn)數(shù)據(jù)交互的示例
數(shù)據(jù)庫是非常重要的一種存儲格式,可以大大提高存儲效率,本文主要介紹了Java連接MySQL數(shù)據(jù)庫并實現(xiàn)數(shù)據(jù)交互的示例,具有一定的參考價值,感興趣的可以了解一下2024-03-03
在學(xué)習(xí)Spring的時候遇到了一個問題,后臺一直接收不到前臺傳遞過來的參數(shù),耽誤了好長時間終于找到了原因,這篇文章主要給大家介紹了關(guān)于spring中前端明明傳了值后端卻接收不到問題的解決辦法,需要的朋友可以參考下2024-05-05