Spring Boot 集成 MinIO 与 KKFile 实现文件预览功能

程序员皮皮林

于 2024-10-01 19:38:37 发布

阅读量413

点赞数 9

文章标签： spring boot 后端

本文链接：https://blog.csdn.net/qq_45990281/article/details/142673593

版权

文章目录

前言
一、项目准备
总结

前言

在现代的 Web 应用中，文件预览功能是提升用户体验的重要部分，尤其是在文档管理系统中。本文将带你逐步实现如何在 Spring Boot 项目中集成 MinIO（一个对象存储系统）与 KKFileView（一个开源文件预览工具），以实现对各种类型文件的在线预览。

一、项目准备

在开始之前，请确保你已经安装和配置好了以下工具：

Java 11+
Spring Boot
MinIO 服务器
KKFileView

第一步：搭建 MinIO 服务器
首先，我们需要配置 MinIO 作为对象存储服务器。你可以在本地或服务器上运行 MinIO。

下载 MinIO
从 MinIO 官方网站下载适用于你操作系统的版本。
运行 MinIO 服务器在安装完 MinIO 后，可以使用以下命令启动 MinIO：

minio server /data --console-address ":9001"

2.1 /data 是存储文件的路径，9001 是 MinIO 控制台的端口。
2.2 访问 MinIO 控制台通过浏览器访问 http://localhost:9001，并使用默认的 access key 和 secret key 登录。你可以在 MinIO 控制台中创建一个 bucket 用来存储文件。

第二步：集成 Spring Boot 与 MinIO
在 Spring Boot 项目中，我们将使用 MinIO SDK 来上传和下载文件。

添加依赖在 pom.xml 中添加 MinIO SDK 的依赖：

<dependency>    
	<groupId>io.minio</groupId>    
	<artifactId>minio</artifactId>    
	<version>8.0.3</version>
</dependency>

配置 MinIO在 application.properties 中添加 MinIO 的配置信息：

 minio.endpoint=http://localhost:9000
 minio.accessKey=minioadmin
 minio.secretKey=minioadmin
 minio.bucketName=files

创建 MinIO Service编写一个 MinIOService 类，用于文件的上传和下载：

@Service
public class MinioService {
	@Value("${minio.endpoint}")    
	private String minioEndpoint;    
	@Value("${minio.accessKey}")    
	private String minioAccessKey;    
	@Value("${minio.secretKey}")    
	private String minioSecretKey;    
	@Value("${minio.bucketName}")    
	private String bucketName;
	
	private MinioClient minioClient;
	@PostConstruct
	public void init() {        
	minioClient = MinioClient.builder()            
		.endpoint(minioEndpoint)            
		.credentials(minioAccessKey, minioSecretKey)            
		.build();    
	}
	public String uploadFile(MultipartFile file) throws Exception {
		 String fileName = System.currentTimeMillis() + "-" + file.getOriginalFilename();
		 minioClient.putObject(
		 	PutObjectArgs.builder()
		 	.bucket(bucketName)
		 	.object(fileName)
		 	.stream(file.getInputStream(), file.getSize(), -1)
		 	.contentType(file.getContentType())
		 	.build()
	);
	return fileName;
}
public String getFileUrl(String fileName) {
		return minioClient.getPresignedObjectUrl(
		GetPresignedObjectUrlArgs.builder()
		.bucket(bucketName)
		.object(fileName)
		.build()
		);
	}
}

第三步：集成 KKFileView 实现文件预览
KKFileView 支持多种格式的文件预览，例如 PDF、Word、Excel 等。

下载并运行 KKFileView从 KKFileView 官方仓库下载源码或使用 Docker 安装：

docker run -d -p 8012:8012 --name kkfileview keking/kkfileview

配置 KKFileView 服务KKFileView 提供了一个 REST API，用于文件预览。我们可以将文件的 URL 传递给 KKFileView，实现在线预览。在 application.properties 中配置 KKFileView 服务的地址：

kkfileview.server=http://localhost:8012

实现预览接口在 MinioService 中创建一个方法，用于生成文件的预览 URL：

public String getPreviewUrl(String fileName) {
	String fileUrl = getFileUrl(fileName);
	return kkFileViewServer + "/onlinePreview?url=" + URLEncoder.encode(fileUrl, StandardCharsets.UTF_8);
}

Controller 实现文件上传和预览创建一个 FileController，实现文件上传和预览的接口：

@RestController
@RequestMapping("/files")
public class FileController {
	@Autowired
	private MinioService minioService;
	@PostMapping("/upload")
	public ResponseEntity<String> uploadFile(@RequestParam("file") MultipartFile file) {
		try {
			String fileName = minioService.uploadFile(file);
			return ResponseEntity.ok(fileName);
		} catch (Exception e) {
		    return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(e.getMessage());
		}
	}
	@GetMapping("/preview/{fileName}")
	public ResponseEntity<String> previewFile(@PathVariable String fileName) {
		String previewUrl = minioService.getPreviewUrl(fileName);
		return ResponseEntity.ok(previewUrl);
	}
}