Spring Boot搭配MinIO和KKFileView實(shí)現(xiàn)文件存儲(chǔ)和在線預(yù)覽
更新時(shí)間：2024年12月14日 11:37:13 作者：JaggerVip
在現(xiàn)代的Web應(yīng)用中,文件上傳和預(yù)覽是常見的需求場(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ù)覽是常見的需求場(chǎng)景。尤其是在內(nèi)容管理系統(tǒng)（CMS）或企業(yè)內(nèi)部應(yīng)用中，文件預(yù)覽功能尤為重要。通過 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 后端開發(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。
- 后端通過 KKFileView 生成文件預(yù)覽鏈接。
- 用戶通過前端直接查看文件內(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"
訪問 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
訪問 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
- 在瀏覽器中打開預(yù)覽鏈接即可查看文件內(nèi)容。
五、總結(jié)
通過 Spring Boot、MinIO 和 KKFileView 的結(jié)合，我們輕松實(shí)現(xiàn)了文件上傳和在線預(yù)覽功能。
- MinIO 提供了高效的對(duì)象存儲(chǔ)服務(wù)。
- KKFileView 提供了強(qiáng)大的文檔解析能力。
- Spring Boot 實(shí)現(xiàn)了兩者的無縫對(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)文章
SpringBoot整合liquibase的實(shí)現(xiàn)方法
這篇文章主要介紹了SpringBoot整合liquibase的實(shí)現(xiàn)方法，文中通過示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2019-08-08
方法類似于C語言中的函數(shù),是包含特定功能的代碼塊,必須定義在類中、main方法外部,本質(zhì)上是一個(gè)造輪子的過程—— 將重復(fù)使用的邏輯包裝成方法,需要時(shí)直接調(diào)用,無需重復(fù)編寫,下面通過示例詳解Java的方法,感興趣的朋友一起看看吧2026-02-02
這篇文章主要給大家介紹了關(guān)于java獲取凌晨與整點(diǎn)時(shí)間戳的相關(guān)資料，文中通過示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2021-03-03
SpringBoot實(shí)現(xiàn)大模型流式Streaming響應(yīng)的示例代碼
這篇文章主要為大家詳細(xì)介紹了SpringBoot實(shí)現(xiàn)大模型流式Streaming響應(yīng)的相關(guān)知識(shí),文中的示例代碼講解詳細(xì),感興趣的小伙伴可以跟隨小編一起學(xué)習(xí)一下2026-01-01
大家好，本篇文章主要講的是Java編程是值傳遞還是引用傳遞的探究，感興趣的同學(xué)趕快來看一看吧，對(duì)你有幫助的話記得收藏一下2022-04-04
Java中將String類型轉(zhuǎn)換為int類型的幾種常見方法
在java中經(jīng)常會(huì)遇到需要對(duì)數(shù)據(jù)進(jìn)行類型轉(zhuǎn)換的場(chǎng)景,這篇文章主要給大家介紹了關(guān)于Java中將String類型轉(zhuǎn)換為int類型的幾種常見方法,文中通過代碼介紹的非常詳細(xì),需要的朋友可以參考下2024-07-07
這篇文章主要介紹了JAVA加解密算法的的相關(guān)資料，文中講解非常詳細(xì)，代碼幫助大家更好的理解和學(xué)習(xí)，感興趣的朋友可以了解下2020-06-06
淺談SpringCloud?Alibaba和SpringCloud的區(qū)別
這篇文章主要介紹了淺談SpringCloud?Alibaba和SpringCloud的區(qū)別,Spring?Cloud?Netflix框架也屬于Spring?Cloud，但是Netflix并不是由spring來進(jìn)行開發(fā)的,需要的朋友可以參考下2023-05-05
下面小編就為大家?guī)硪黄猨ava中數(shù)組的定義及使用方法(推薦)。小編覺得挺不錯(cuò)的，現(xiàn)在就分享給大家，也給大家做個(gè)參考。一起跟隨小編過來看看吧2016-07-07
這篇文章主要介紹了Maven的安裝配置詳解，文中通過示例代碼介紹的非常詳細(xì)，對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2021-10-10