Spring Boot搭配MinIO和KKFileView实现文件存储和在线预览

更新时间：2024年12月14日 11:37:13 作者：JaggerVip

在现代的Web应用中,文件上传和预览是常见的需求场景,尤其是在内容管理系统（CMS）或企业内部应用,本文介绍了如何使用SpringBoot、MinIO和KKFileView实现文件上传和在线预览功能,包括项目背景、技术选型、环境准备、项目代码实现和运行测试等步骤

一、项目背景和技术选型

Spring Boot：主流的 Java 后端开发框架，用于快速构建 RESTful 服务。
MinIO：一款高性能的对象存储服务，支持 S3 协议，适合大文件存储。
KKFileView：一款轻量级文件在线预览服务，支持多种文件格式（如 Office 文档、PDF、图片等）。

系统架构图：

功能目标

用户上传文件到 MinIO。
后端通过 KKFileView 生成文件预览链接。
用户通过前端直接查看文件内容。

二、环境准备

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

默认账号密码：

用户名：minioadmin
密码：minioadmin

创建一个存储桶（如 preview-files）。

2. KKFileView 安装和启动

下载并运行 KKFileView：

docker run -d --name kkfileview \
  -p 8012:8012 \
  --restart=always \
  kekingcn/kkfileview:latest

访问 KKFileView 服务：http://localhost:8012

三、项目代码实现

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 服务地址：

minio:
  endpoint: http://localhost:9000
  accessKey: minioadmin
  secretKey: minioadmin
  bucketName: preview-files

kkfileview:
  serverUrl: http://localhost:8012

3. MinIO 文件上传和预览服务

创建 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 服务对接

创建 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 控制器

创建 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

输出类似以下内容：

上传成功，文件地址：http://localhost:9000/preview-files/example.pdf

生成预览链接：

curl "http://localhost:8080/files/preview?fileUrl=http://localhost:9000/preview-files/example.pdf"

输出类似以下内容：

http://localhost:8012/onlinePreview?url=http://localhost:9000/preview-files/example.pdf

在浏览器中打开预览链接即可查看文件内容。

五、总结

通过 Spring Boot、MinIO 和 KKFileView 的结合，我们轻松实现了文件上传和在线预览功能。

MinIO 提供了高效的对象存储服务。
KKFileView 提供了强大的文档解析能力。
Spring Boot 实现了两者的无缝对接。

这套方案轻量高效，适合企业内部文件管理系统，也可以轻松扩展至分布式环境。

到此这篇关于Spring Boot搭配MinIO和KKFileView实现文件存储和在线预览的文章就介绍到这了,更多相关Spring Boot实现文件上传和预览内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

简单了解java函数式编码结构及优势
这篇文章主要介绍了简单了解java函数式编码结构及优势，本文将探讨三种下一代 JVM 语言：Groovy、Scala 和 Clojure，比较并对比新的功能和范例，让 Java 开发人员对自己近期的未来发展有大体的认识。,需要的朋友可以参考下
2019-06-06
Java Spring的核心与设计思想你知道吗
这篇文章主要为大家详细介绍了Java Spring的核心与设计思想，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下，希望能够给你带来帮助
2022-03-03
thymeleaf中前后端数据交互方法汇总
这篇文章主要介绍了thymeleaf中前后端数据交互小结，本文通过示例代码给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友参考下吧
2022-07-07
Nacos配置中心集群原理及源码分析
这篇文章主要为大家介绍了Nacos配置中心集群原理及源码分析，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步早日升职加薪
2022-03-03
maven安装jar包到本地的操作方法
这篇文章主要介绍了maven安装jar包到本地,执行该命令后，Maven 会将该 JAR 文件安装到你本地 Maven 仓库中，需要的朋友可以参考下
2007-01-01
java生成二维码并且给二维码添加logo
这篇文章主要介绍了java生成二维码并且给二维码添加logo的实例代码，代码简单易懂，非常不错，具有一定的参考借鉴价值,需要的朋友可以参考下
2019-12-12
Java内部排序之插入排序与交换排序详解
这篇文章主要介绍了Java内部排序之插入排序与交换排序详解,排序是将任意序列重新排列按照关键字有序,排序根基存储器的不同分为内部排序、外部排序,排序根据关键字分为稳定排序、不稳定排序,需要的朋友可以参考下
2023-12-12
RocketMQ源码本地搭建调试方法
这篇文章主要介绍了RocketMQ源码本地搭建调试,本文给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下
2023-01-01
SpringBoot中的静态资源访问的实现
这篇文章主要介绍了SpringBoot中的静态资源访问的实现，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2020-09-09
Spring多线程通过@Scheduled实现定时任务
这篇文章主要介绍了Spring多线程通过@Scheduled实现定时任务，@Scheduled 定时任务调度注解，是spring定时任务中最重要的，下文关于其具体介绍，需要的小伙伴可以参考一下
2022-05-05