SpringBoot使用minio及配置代码

目录

• 1、导入 minio jar包
• 2、配置
• 3、实现

MinIO是一个开源的对象存储服务。适合于存储大容量非结构化的数据，例如图片、视频、日志文件、备份数据和容器/虚拟机镜像等，而一个对象文件可以是任意大小，从几kb到最大5T不等。

MinIO是一个非常轻量的服务,可以很简单的和其他应用的结合，类似 NodeJS, Redis 或者 MySQL。

1、导入 minio jar包

  	  io.minio
      minio
      7.1.0
  

2、配置

application.yml 配置

minio:
  endpoint: 172.0.0.1
  port: 9000
  accessKey: minio
  secretKey: miniopassword
  secure: false
  bucketName: "my-bucket"
  configDir: "/home/data/"

类配置

/**
 * minio配置
 */
 public static class Minio{
	/**
	* minio地址
	*/
	public static String Url="http://127.0.0.1:9000";
	/**
	* AK
	*/
	public static String AccessKey="minio";
	/**
	* SK
	*/
	public static String SecretKey="miniopassword";
	/**
	 * 文件夹
 	 */
	public static String BuckeName="my-buckeName";
 }

3、实现

package com.minio.config;

import io.minio.MinioClient;
import io.minio.errors.InvalidEndpointException;
import io.minio.errors.InvalidPortException;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;
import org.checkerframework.checker.units.qual.A;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.context.annotation.Bean;
import org.springframework.stereotype.Component;
@Data
@Component
@ConfigurationProperties(prefix = "minio")
public class MinioConfig {
    @ApiModelProperty("endPoint是一个URL，域名，IPv4或者IPv6地址")
    private String endpoint;
    @ApiModelProperty("TCP/IP端口号")
    private int port;
    @ApiModelProperty("accessKey类似于用户ID，用于唯一标识你的账户")
    private String accessKey;
    @ApiModelProperty("secretKey是你账户的密码")
    private String secretKey;
    @ApiModelProperty("如果是true，则用的是https而不是http,默认值是true")
    private Boolean secure;
    @ApiModelProperty("默认存储桶")
    private String bucketName;
    @ApiModelProperty("配置目录")
    private String configDir;
    @Bean
    public MinioClient getMinioClient() throws InvalidEndpointException, InvalidPortException {
        MinioClient minioClient = new MinioClient(endpoint, port, accessKey, secretKey,secure);
        return minioClient;
    }
}

package com.hope.minio.utils;

import io.minio.MinioClient;
import io.minio.ObjectStat;
import io.minio.PutObjectOptions;
import io.minio.Result;
import io.minio.errors.ErrorResponseException;
import io.minio.errors.InvalidExpiresRangeException;
import io.minio.messages.Bucket;
import io.minio.messages.DeleteError;
import io.minio.messages.Item;
import lombok.SneakyThrows;
import org.apache.commons.lang3.StringUtils;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;
import org.springframework.web.multipart.MultipartFile;
import javax.servlet.ServletOutputStream;
import javax.servlet.http.HttpServletResponse;
import java.io.InputStream;
import java.nio.charset.StandardCharsets;
import java.util.ArrayList;
import java.util.List;
/**
 * @PackageName: com.hope.minio.utils
 * @ClassName: MinioUtil
 * @Author Hope
 * @Date 2020/7/27 11:43
 * @Description: TODO
 */
@Component
public class MinioUtil {
    @Autowired
    private MinioClient minioClient;
    private static final int DEFAULT_EXPIRY_TIME = 7 * 24 * 3600;
    /**
     * 检查存储桶是否存在
     *
     * @param bucketName 存储桶名称
     * @return
     */
    @SneakyThrows
    public boolean bucketExists(String bucketName) {
        boolean flag = false;
        flag = minioClient.bucketExists(bucketName);
        if (flag) {
            return true;
        }
        return false;
    }
     * 创建存储桶
    public boolean makeBucket(String bucketName) {
        boolean flag = bucketExists(bucketName);
        if (!flag) {
            minioClient.makeBucket(bucketName);
        } else {
            return false;
     * 列出所有存储桶名称
    public List listBucketNames() {
        List bucketList = listBuckets();
        List bucketListName = new ArrayList<>();
        for (Bucket bucket : bucketList) {
            bucketListName.add(bucket.name());
        return bucketListName;
     * 列出所有存储桶
    public List listBuckets() {
        return minioClient.listBuckets();
     * 删除存储桶
    public boolean removeBucket(String bucketName) {
            Iterable> myObjects = listObjects(bucketName);
            for (Result result : myObjects) {
                Item item = result.get();
                // 有对象文件，则删除失败
                if (item.size() > 0) {
                    return false;
                }
            }
            // 删除存储桶，注意，只有存储桶为空时才能删除成功。
            minioClient.removeBucket(bucketName);
            flag = bucketExists(bucketName);
            if (!flag) {
                return true;
     * 列出存储桶中的所有对象名称
    public List listObjectNames(String bucketName) {
        List listObjectNames = new ArrayList<>();
                listObjectNames.add(item.objectName());
        return listObjectNames;
     * 列出存储桶中的所有对象
    public Iterable> listObjects(String bucketName) {
            return minioClient.listObjects(bucketName);
        return null;
     * 通过文件上传到对象
     * @param objectName 存储桶里的对象名称
     * @param fileName   File name
    public boolean putObject(String bucketName, String objectName, String fileName) {
            minioClient.putObject(bucketName, objectName, fileName, null);
            ObjectStat statObject = statObject(bucketName, objectName);
            if (statObject != null && statObject.length() > 0) {
     * 文件上传
     * @param bucketName
     * @param multipartFile
    public void putObject(String bucketName, MultipartFile multipartFile, String filename) {
        PutObjectOptions putObjectOptions = new PutObjectOptions(multipartFile.getSize(), PutObjectOptions.MIN_MULTIPART_SIZE);
        putObjectOptions.setContentType(multipartFile.getContentType());
        minioClient.putObject(bucketName, filename, multipartFile.getInputStream(), putObjectOptions);
     * 通过InputStream上传对象
     * @param stream     要上传的流
    public boolean putObject(String bucketName, String objectName, InputStream stream) {
            minioClient.putObject(bucketName, objectName, stream, new PutObjectOptions(stream.available(), -1));
     * 以流的形式获取一个文件对象
    public InputStream getObject(String bucketName, String objectName) {
                InputStream stream = minioClient.getObject(bucketName, objectName);
                return stream;
     * 以流的形式获取一个文件对象（断点下载）
     * @param offset     起始字节的位置
     * @param length     要读取的长度 (可选，如果无值则代表读到文件结尾)
    public InputStream getObject(String bucketName, String objectName, long offset, Long length) {
                InputStream stream = minioClient.getObject(bucketName, objectName, offset, length);
     * 下载并将文件保存到本地
    public boolean getObject(String bucketName, String objectName, String fileName) {
                minioClient.getObject(bucketName, objectName, fileName);
     * 删除一个对象
    public boolean removeObject(String bucketName, String objectName) {
            minioClient.removeObject(bucketName, objectName);
     * 删除指定桶的多个文件对象,返回删除错误的对象列表，全部删除成功，返回空列表
     * @param bucketName  存储桶名称
     * @param objectNames 含有要删除的多个object名称的迭代器对象
    public List removeObject(String bucketName, List objectNames) {
        List deleteErrorNames = new ArrayList<>();
            Iterable> results = minioClient.removeObjects(bucketName, objectNames);
            for (Result result : results) {
                DeleteError error = result.get();
                deleteErrorNames.add(error.objectName());
        return deleteErrorNames;
     * 生成一个给HTTP GET请求用的presigned URL。
     * 浏览器/移动端的客户端可以用这个URL进行下载，即使其所在的存储桶是私有的。这个presigned URL可以设置一个失效时间，默认值是7天。
     * @param expires    失效时间（以秒为单位），默认是7天，不得大于七天
    public String presignedGetObject(String bucketName, String objectName, Integer expires) {
        String url = "";
            if (expires < 1 || expires > DEFAULT_EXPIRY_TIME) {
                throw new InvalidExpiresRangeException(expires,
                        "expires must be in range of 1 to " + DEFAULT_EXPIRY_TIME);
            url = minioClient.presignedGetObject(bucketName, objectName, expires);
        return url;
     * 生成一个给HTTP PUT请求用的presigned URL。
     * 浏览器/移动端的客户端可以用这个URL进行上传，即使其所在的存储桶是私有的。这个presigned URL可以设置一个失效时间，默认值是7天。
    public String presignedPutObject(String bucketName, String objectName, Integer expires) {
            url = minioClient.presignedPutObject(bucketName, objectName, expires);
     * 获取对象的元数据
    public ObjectStat statObject(String bucketName, String objectName) {
            ObjectStat statObject = minioClient.statObject(bucketName, objectName);
            return statObject;
     * 文件访问路径
    public String getObjectUrl(String bucketName, String objectName) {
            url = minioClient.getObjectUrl(bucketName, objectName);
    public void downloadFile(String bucketName, String fileName, String originalName, HttpServletResponse response) {
        try {
            InputStream file = minioClient.getObject(bucketName, fileName);
            String filename = new String(fileName.getBytes("ISO8859-1"), StandardCharsets.UTF_8);
            if (StringUtils.isNotEmpty(originalName)) {
                fileName = originalName;
            response.setHeader("Content-Disposition", "attachment;filename=" + filename);
            ServletOutputStream servletOutputStream = response.getOutputStream();
            int len;
            byte[] buffer = new byte[1024];
            while ((len = file.read(buffer)) > 0) {
                servletOutputStream.write(buffer, 0, len);
            servletOutputStream.flush();
            file.close();
            servletOutputStream.close();
        } catch (ErrorResponseException e) {
            e.printStackTrace();
        } catch (Exception e) {
}

注意:存储桶命名要求
存储桶的命名需符合以下一个或多个规则
. 存储桶名称的长度介于 3 和 63 个字符之间，并且只能包含小写字母、数字、句点和短划线。
. 存储桶名称中的每个标签必须以小写字母或数字开头。
. 存储桶名称不能包含下划线、以短划线结束、包含连续句点或在句点旁边使用短划线。
. 存储桶名称不能采用 IP 地址格式 (198.51.100.24)。
. 存储桶用作可公开访问的 URL，因此您选择的存储桶名称必须具有全局唯一性。如果您选择的名称已被其他一些帐户用于创建存储桶，则必须使用其他名称。

参考地址：
https://blog.csdn.net/weixin_37264997/article/details/107631796