Spring Boot搭配MinIO和KKFileView實(shí)現(xiàn)文件存儲(chǔ)和在線預(yù)覽
更新時(shí)間：2024年12月14日 11:37:13 作者：JaggerVip
在現(xiàn)代的Web應(yīng)用中,文件上傳和預(yù)覽是常見(jiàn)的需求場(chǎng)景,尤其是在內(nèi)容管理系統(tǒng)（CMS）或企業(yè)內(nèi)部應(yīng)用,本文介紹了如何使用SpringBoot、MinIO和KKFileView實(shí)現(xiàn)文件上傳和在線預(yù)覽功能,包括項(xiàng)目背景、技術(shù)選型、環(huán)境準(zhǔn)備、項(xiàng)目代碼實(shí)現(xiàn)和運(yùn)行測(cè)試等步驟
在現(xiàn)代的 Web 應(yīng)用中，文件上傳和預(yù)覽是常見(jiàn)的需求場(chǎng)景。尤其是在內(nèi)容管理系統(tǒng)（CMS）或企業(yè)內(nèi)部應(yīng)用中，文件預(yù)覽功能尤為重要。通過(guò) Spring Boot 搭配 MinIO 和 KKFileView，我們可以輕松實(shí)現(xiàn)高效的文件存儲(chǔ)和在線預(yù)覽功能。
本文將從以下幾個(gè)方面，帶你逐步實(shí)現(xiàn)一個(gè)簡(jiǎn)單的文件預(yù)覽系統(tǒng)。
一、項(xiàng)目背景和技術(shù)選型
- Spring Boot：主流的 Java 后端開(kāi)發(fā)框架，用于快速構(gòu)建 RESTful 服務(wù)。
- MinIO：一款高性能的對(duì)象存儲(chǔ)服務(wù)，支持 S3 協(xié)議，適合大文件存儲(chǔ)。
- KKFileView：一款輕量級(jí)文件在線預(yù)覽服務(wù)，支持多種文件格式（如 Office 文檔、PDF、圖片等）。
系統(tǒng)架構(gòu)圖：
功能目標(biāo)
- 用戶上傳文件到 MinIO。
- 后端通過(guò) KKFileView 生成文件預(yù)覽鏈接。
- 用戶通過(guò)前端直接查看文件內(nèi)容。
二、環(huán)境準(zhǔn)備
1. MinIO 安裝和啟動(dòng)
下載并運(yùn)行 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"
訪問(wèn) MinIO 控制臺(tái)：http://localhost:9001
默認(rèn)賬號(hào)密碼：
- 用戶名：minioadmin
- 密碼：minioadmin
創(chuàng)建一個(gè)存儲(chǔ)桶（如 preview-files）。
2. KKFileView 安裝和啟動(dòng)
下載并運(yùn)行 KKFileView：
docker run -d --name kkfileview \ -p 8012:8012 \ --restart=always \ kekingcn/kkfileview:latest
訪問(wèn) KKFileView 服務(wù)：http://localhost:8012
三、項(xiàng)目代碼實(shí)現(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ù)對(duì)接
創(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);
}
}四、運(yùn)行和測(cè)試
- 啟動(dòng) Spring Boot 項(xiàng)目。
- 上傳文件：
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
- 在瀏覽器中打開(kāi)預(yù)覽鏈接即可查看文件內(nèi)容。
五、總結(jié)
通過(guò) Spring Boot、MinIO 和 KKFileView 的結(jié)合，我們輕松實(shí)現(xiàn)了文件上傳和在線預(yù)覽功能。
- MinIO 提供了高效的對(duì)象存儲(chǔ)服務(wù)。
- KKFileView 提供了強(qiáng)大的文檔解析能力。
- Spring Boot 實(shí)現(xiàn)了兩者的無(wú)縫對(duì)接。
這套方案輕量高效，適合企業(yè)內(nèi)部文件管理系統(tǒng)，也可以輕松擴(kuò)展至分布式環(huán)境。
到此這篇關(guān)于Spring Boot搭配MinIO和KKFileView實(shí)現(xiàn)文件存儲(chǔ)和在線預(yù)覽的文章就介紹到這了,更多相關(guān)Spring Boot實(shí)現(xiàn)文件上傳和預(yù)覽內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
相關(guān)文章
簡(jiǎn)單了解java函數(shù)式編碼結(jié)構(gòu)及優(yōu)勢(shì)
這篇文章主要介紹了簡(jiǎn)單了解java函數(shù)式編碼結(jié)構(gòu)及優(yōu)勢(shì)，本文將探討三種下一代 JVM 語(yǔ)言：Groovy、Scala 和 Clojure，比較并對(duì)比新的功能和范例，讓 Java 開(kāi)發(fā)人員對(duì)自己近期的未來(lái)發(fā)展有大體的認(rèn)識(shí)。,需要的朋友可以參考下2019-06-06
Java?Spring的核心與設(shè)計(jì)思想你知道嗎
這篇文章主要為大家詳細(xì)介紹了Java?Spring的核心與設(shè)計(jì)思想，文中示例代碼介紹的非常詳細(xì)，具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下，希望能夠給你帶來(lái)幫助2022-03-03
thymeleaf中前后端數(shù)據(jù)交互方法匯總
這篇文章主要介紹了thymeleaf中前后端數(shù)據(jù)交互小結(jié)，本文通過(guò)示例代碼給大家介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值，需要的朋友參考下吧2022-07-07
這篇文章主要為大家介紹了Nacos配置中心集群原理及源碼分析，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進(jìn)步早日升職加薪2022-03-03
這篇文章主要介紹了maven安裝jar包到本地,執(zhí)行該命令后，Maven?會(huì)將該?JAR?文件安裝到你本地?Maven?倉(cāng)庫(kù)中，需要的朋友可以參考下2007-01-01
這篇文章主要介紹了java生成二維碼并且給二維碼添加logo的實(shí)例代碼，代碼簡(jiǎn)單易懂，非常不錯(cuò)，具有一定的參考借鑒價(jià)值,需要的朋友可以參考下2019-12-12
這篇文章主要介紹了Java內(nèi)部排序之插入排序與交換排序詳解,排序是將任意序列重新排列按照關(guān)鍵字有序,排序根基存儲(chǔ)器的不同分為內(nèi)部排序、外部排序,排序根據(jù)關(guān)鍵字分為穩(wěn)定排序、不穩(wěn)定排序,需要的朋友可以參考下2023-12-12
這篇文章主要介紹了RocketMQ源碼本地搭建調(diào)試,本文給大家介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值，需要的朋友可以參考下2023-01-01
SpringBoot中的靜態(tài)資源訪問(wèn)的實(shí)現(xiàn)
這篇文章主要介紹了SpringBoot中的靜態(tài)資源訪問(wèn)的實(shí)現(xiàn)，文中通過(guò)示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2020-09-09
Spring多線程通過(guò)@Scheduled實(shí)現(xiàn)定時(shí)任務(wù)
這篇文章主要介紹了Spring多線程通過(guò)@Scheduled實(shí)現(xiàn)定時(shí)任務(wù)，@Scheduled?定時(shí)任務(wù)調(diào)度注解，是spring定時(shí)任務(wù)中最重要的，下文關(guān)于其具體介紹，需要的小伙伴可以參考一下2022-05-05