MinioTemplate MinIO工具类

package com.xxx.service.store.minio;

import com.xxx.exception.FileDeleteException;
import com.xxx.exception.FileReadException;
import com.xxx.exception.FileStoreException;
import io.minio.*;
import io.minio.messages.DeleteError;
import io.minio.messages.DeleteObject;
import io.minio.messages.Item;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;

import java.io.InputStream;
import java.util.ArrayList;
import java.util.List;
import java.util.stream.Collectors;

/**
 * minio对象存储操作模板,相比MinioClient提供了更简单的操作方法和异常包装
 */
@Component
public class MinioTemplate {

    private static final Logger LOG = LoggerFactory.getLogger(MinioTemplate.class);

    @Autowired(required = false)
    private MinioClient minioClient;
	// 保存
    public void putObject(String bucketName, String objectName, InputStream in) throws FileStoreException {
        try {
            minioClient.putObject(PutObjectArgs.builder()
                    .bucket(bucketName)
                    .object(objectName)
                    .stream(in, in.available(), -1)
                    .build());
        } catch (Exception e) {
            throw new FileStoreException(e);
        }
    }
	// 查询
    public List<String> listObjects(String bucketName, String prefix) throws FileReadException {
        try {
            Iterable<Result<Item>> results = minioClient.listObjects(ListObjectsArgs.builder()
                    .bucket(bucketName)
                    .prefix(prefix)
                    .recursive(true)
                    .build());
            List<String> objectNameList = new ArrayList<>();
            for (Result<Item> result : results) {
                objectNameList.add(result.get().objectName());
            }
            return objectNameList;
        } catch (Exception e) {
            throw new FileReadException(e);
        }
    }
	// 删除
    public void removeObjects(String bucketName, List<String> objectNameList) throws FileDeleteException {
        try {
            List<DeleteObject> deleteObjects = objectNameList.stream()
                    .map(DeleteObject::new)
                    .collect(Collectors.toList());
            Iterable<Result<DeleteError>> results = minioClient.removeObjects(RemoveObjectsArgs.builder()
                    .bucket(bucketName)
                    .objects(deleteObjects)
                    .build());
            // minio处理批量删除的时候,采用的延迟执行,需要通过迭代返回结果
            for (Result<DeleteError> errorResult : results) {
                DeleteError error = errorResult.get();
                if (LOG.isWarnEnabled()) {
                    LOG.warn("Error in deleting object " + error.objectName() + "; " + error.message());
                }
            }
        } catch (Exception e) {
            throw new FileDeleteException(e);
        }
    }
	// 分片组合
    public void composeObject(String sourceBucketName, List<String> sourceObjectNameList, String targetBucketName, String targetObjectName)
            throws FileStoreException {
        try {
            List<ComposeSource> sources = sourceObjectNameList.stream()
                    .map(objectName -> ComposeSource.builder()
                            .bucket(sourceBucketName)
                            .object(objectName)
                            .build()
                    )
                    .collect(Collectors.toList());
            minioClient.composeObject(ComposeObjectArgs.builder()
                    .bucket(targetBucketName)
                    .object(targetObjectName)
                    .sources(sources)
                    .build());
        } catch (Exception e) {
            throw new FileStoreException(e);
        }
    }
	// 获取对象流
    public InputStream getInputStream(String bucketName, String objectName) throws FileReadException {
        try {
            return minioClient.getObject(GetObjectArgs.builder()
                    .bucket(bucketName)
                    .object(objectName)
                    .build());
        } catch (Exception e) {
            throw new FileReadException(e);
        }
    }
}

### 关于 MinIO 工具类的使用 MinIO 是一种高性能的对象存储解决方案,兼容 Amazon S3 API。它支持多种编程语言 SDK 的集成,便于开发者快速实现对象存储功能[^2]。 以下是基于 Java 编程语言的一个简单示例代码,展示如何利用 MinIO 提供的功能完成基本的操作(如创建 Bucket 和上传文件)。此代码还涵盖了将 Bucket 设置为 Public 的必要步骤[^3]: #### 创建并初始化 MinIO 客户端 ```java import io.minio.MinioClient; import io.minio.errors.MinioException; public class MinioExample { public static void main(String[] args) throws Exception { try { // 初始化 MinIO 客户端实例 MinioClient minioClient = new MinioClient( "http://localhost:9000", // 替换为目标服务器 URL "your-access-key", // 访问密钥 "your-secret-key" // 秘密密钥 ); boolean isExist = minioClient.bucketExists("my-bucket"); if (!isExist) { minioClient.makeBucket("my-bucket"); // 如果不存在,则创建一个新的 bucket } } catch (MinioException e) { System.out.println("Error occurred: " + e); } } } ``` 上述代码展示了如何连接到本地运行的 MinIO 实例,并检查是否存在名为 `my-bucket` 的 Bucket。如果该 Bucket 尚未存在,则会自动创建[^1]。 #### 文件上传至指定 Bucket 并设置访问权限 为了使上传的文件可以通过公共链接访问,需确保目标 Bucket 被显式设为 Public。以下是一个完整的例子: ```java // 继续上一段中的客户端定义... try { String objectName = "example-file.txt"; // 上传文件到已存在的 my-bucket 中 minioClient.putObject( "my-bucket", objectName, "/path/to/local/example-file.txt" ); // 修改 Bucket 权限策略使其公开可读 String policyJson = "{ \"Version\":\"2012-10-17\", " + "\"Statement\":[{" + " \"Effect\": \"Allow\"," + " \"Principal\": {\"AWS\": [\"*\"]}," + " \"Action\": [\"s3:GetObject\"]," + " \"Resource\": [\"arn:aws:s3:::my-bucket/*\"]" + "}]}"; minioClient.setBucketPolicy("my-bucket", "", policyJson); } catch (Exception e) { System.err.println(e.getMessage()); } ``` 以上脚本实现了向特定 Bucket 添加新文件以及调整其安全属性的过程。注意,在实际部署环境中应谨慎处理敏感数据的安全性和隐私保护问题。 ###
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值