zoukankan      html  css  js  c++  java
  • springboot学习之路31(整合minio服务)

    介绍

    ​ MinIO 是一个基于Apache License v2.0开源协议的对象存储服务。它兼容亚马逊S3云存储服务接口,非常适合于存储大容量非结构化的数据,例如图片、视频、日志文件、备份数据和容器/虚拟机镜像等,而一个对象文件可以是任意大小,从几kb到最大5T不等。

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

    官网:https://docs.min.io/cn/

    部署

    # 1. docker 部署 (推荐使用)
    	docker pull minio/minio
    	docker run -p 9000:9000 minio/minio server /data
    # 2. linux部署
    	下载:https://dl.min.io/server/minio/release/linux-amd64/minio
    	chmod +x minio
    	./minio server /data
    # 3. window 部署  (默认演示方式)
    	下载:https://dl.min.io/server/minio/release/windows-amd64/minio.exe
    	minio.exe server D:Photos
    

    ​ 启动如下:

      ![](https://img2020.cnblogs.com/blog/1112611/202008/1112611-20200821173347613-728337276.png)
    

    ​ 访问:http://localhost:9000/ 默认是9000端口

    页面介绍:

    使用

    关于使用minio支持很多。(以java为例)

    @Data
    @Configuration
    @ConfigurationProperties(prefix = "minio")
    public class MinioConfig {
    
        private String endpoint;
        private String accessKey;
        private String secretKey;
    
        @Bean
        public MinioClient getMinioClient() throws InvalidEndpointException, InvalidPortException {
            MinioClient minioClient = new MinioClient(endpoint, accessKey, secretKey);
            return minioClient;
        }
    
    }
    
    package com.huhy.minio;
    
    import cn.hutool.core.util.StrUtil;
    import io.minio.MinioClient;
    import io.minio.ObjectStat;
    import io.minio.PutObjectOptions;
    import io.minio.Result;
    import io.minio.errors.*;
    import io.minio.messages.Bucket;
    import io.minio.messages.DeleteError;
    import io.minio.messages.Item;
    import lombok.SneakyThrows;
    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.IOException;
    import java.io.InputStream;
    import java.nio.charset.StandardCharsets;
    import java.util.ArrayList;
    import java.util.List;
    
    /**
     * @author: huhy
     * @project-name: hrg-self20200731
     * @create: 2020-08-21
     * @description: minio工具类
     **/
    @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;
        }
    
        /**
         * 创建存储桶
         *
         * @param bucketName 存储桶名称
         */
        @SneakyThrows
        public boolean makeBucket(String bucketName) {
            boolean flag = bucketExists(bucketName);
            if (!flag) {
                minioClient.makeBucket(bucketName);
                return true;
            } else {
                return false;
            }
        }
    
        /**
         * 列出所有存储桶名称
         *
         * @return
         */
        @SneakyThrows
        public List<String> listBucketNames() {
            List<Bucket> bucketList = listBuckets();
            List<String> bucketListName = new ArrayList<>();
            for (Bucket bucket : bucketList) {
                bucketListName.add(bucket.name());
            }
            return bucketListName;
        }
    
        /**
         * 列出所有存储桶
         *
         * @return
         */
        @SneakyThrows
        public List<Bucket> listBuckets() {
            return minioClient.listBuckets();
        }
    
        /**
         * 删除存储桶
         *
         * @param bucketName 存储桶名称
         * @return
         */
        @SneakyThrows
        public boolean removeBucket(String bucketName) {
            boolean flag = bucketExists(bucketName);
            if (flag) {
                Iterable<Result<Item>> myObjects = listObjects(bucketName);
                for (Result<Item> result : myObjects) {
                    Item item = result.get();
                    // 有对象文件,则删除失败
                    if (item.size() > 0) {
                        return false;
                    }
                }
                // 删除存储桶,注意,只有存储桶为空时才能删除成功。
                minioClient.removeBucket(bucketName);
                flag = bucketExists(bucketName);
                if (!flag) {
                    return true;
                }
    
            }
            return false;
        }
    
        /**
         * 列出存储桶中的所有对象名称
         *
         * @param bucketName 存储桶名称
         * @return
         */
        @SneakyThrows
        public List<String> listObjectNames(String bucketName) {
            List<String> listObjectNames = new ArrayList<>();
            boolean flag = bucketExists(bucketName);
            if (flag) {
                Iterable<Result<Item>> myObjects = listObjects(bucketName);
                for (Result<Item> result : myObjects) {
                    Item item = result.get();
                    listObjectNames.add(item.objectName());
                }
            }
            return listObjectNames;
        }
    
        /**
         * 列出存储桶中的所有对象
         *
         * @param bucketName 存储桶名称
         * @return
         */
        @SneakyThrows
        public Iterable<Result<Item>> listObjects(String bucketName) {
            boolean flag = bucketExists(bucketName);
            if (flag) {
                return minioClient.listObjects(bucketName);
            }
            return null;
        }
    
        /**
         * 通过文件上传到对象
         *
         * @param bucketName 存储桶名称
         * @param objectName 存储桶里的对象名称
         * @param fileName   File name
         * @return
         */
        @SneakyThrows
        public boolean putObject(String bucketName, String objectName, String fileName) {
            boolean flag = bucketExists(bucketName);
            if (flag) {
                minioClient.putObject(bucketName, objectName, fileName, null);
                ObjectStat statObject = statObject(bucketName, objectName);
                if (statObject != null && statObject.length() > 0) {
                    return true;
                }
            }
            return false;
    
        }
    
        /**
         * 文件上传
         *
         * @param bucketName
         * @param multipartFile
         */
        @SneakyThrows
        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 bucketName 存储桶名称
         * @param objectName 存储桶里的对象名称
         * @param stream     要上传的流
         * @return
         */
        @SneakyThrows
        public boolean putObject(String bucketName, String objectName, InputStream stream) {
            boolean flag = bucketExists(bucketName);
            if (flag) {
                minioClient.putObject(bucketName, objectName, stream, new PutObjectOptions(stream.available(), -1));
                ObjectStat statObject = statObject(bucketName, objectName);
                if (statObject != null && statObject.length() > 0) {
                    return true;
                }
            }
            return false;
        }
    
        /**
         * 以流的形式获取一个文件对象
         *
         * @param bucketName 存储桶名称
         * @param objectName 存储桶里的对象名称
         * @return
         */
        @SneakyThrows
        public InputStream getObject(String bucketName, String objectName) {
            boolean flag = bucketExists(bucketName);
            if (flag) {
                ObjectStat statObject = statObject(bucketName, objectName);
                if (statObject != null && statObject.length() > 0) {
                    InputStream stream = minioClient.getObject(bucketName, objectName);
                    return stream;
                }
            }
            return null;
        }
    
        /**
         * 以流的形式获取一个文件对象(断点下载)
         *
         * @param bucketName 存储桶名称
         * @param objectName 存储桶里的对象名称
         * @param offset     起始字节的位置
         * @param length     要读取的长度 (可选,如果无值则代表读到文件结尾)
         * @return
         */
        @SneakyThrows
        public InputStream getObject(String bucketName, String objectName, long offset, Long length) {
            boolean flag = bucketExists(bucketName);
            if (flag) {
                ObjectStat statObject = statObject(bucketName, objectName);
                if (statObject != null && statObject.length() > 0) {
                    InputStream stream = minioClient.getObject(bucketName, objectName, offset, length);
                    return stream;
                }
            }
            return null;
        }
    
        /**
         * 下载并将文件保存到本地
         *
         * @param bucketName 存储桶名称
         * @param objectName 存储桶里的对象名称
         * @param fileName   File name
         * @return
         */
        @SneakyThrows
        public boolean getObject(String bucketName, String objectName, String fileName) {
            boolean flag = bucketExists(bucketName);
            if (flag) {
                ObjectStat statObject = statObject(bucketName, objectName);
                if (statObject != null && statObject.length() > 0) {
                    minioClient.getObject(bucketName, objectName, fileName);
                    return true;
                }
            }
            return false;
        }
    
        /**
         * 删除一个对象
         *
         * @param bucketName 存储桶名称
         * @param objectName 存储桶里的对象名称
         */
        @SneakyThrows
        public boolean removeObject(String bucketName, String objectName) {
            boolean flag = bucketExists(bucketName);
            if (flag) {
                minioClient.removeObject(bucketName, objectName);
                return true;
            }
            return false;
        }
    
        /**
         * 删除指定桶的多个文件对象,返回删除错误的对象列表,全部删除成功,返回空列表
         *
         * @param bucketName  存储桶名称
         * @param objectNames 含有要删除的多个object名称的迭代器对象
         * @return
         */
        @SneakyThrows
        public List<String> removeObject(String bucketName, List<String> objectNames) {
            List<String> deleteErrorNames = new ArrayList<>();
            boolean flag = bucketExists(bucketName);
            if (flag) {
                Iterable<Result<DeleteError>> results = minioClient.removeObjects(bucketName, objectNames);
                for (Result<DeleteError> result : results) {
                    DeleteError error = result.get();
                    deleteErrorNames.add(error.objectName());
                }
            }
            return deleteErrorNames;
        }
    
        /**
         * 生成一个给HTTP GET请求用的presigned URL。
         * 浏览器/移动端的客户端可以用这个URL进行下载,即使其所在的存储桶是私有的。这个presigned URL可以设置一个失效时间,默认值是7天。
         *
         * @param bucketName 存储桶名称
         * @param objectName 存储桶里的对象名称
         * @param expires    失效时间(以秒为单位),默认是7天,不得大于七天
         * @return
         */
        @SneakyThrows
        public String presignedGetObject(String bucketName, String objectName, Integer expires) {
            boolean flag = bucketExists(bucketName);
            String url = "";
            if (flag) {
                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天。
         *
         * @param bucketName 存储桶名称
         * @param objectName 存储桶里的对象名称
         * @param expires    失效时间(以秒为单位),默认是7天,不得大于七天
         * @return
         */
        @SneakyThrows
        public String presignedPutObject(String bucketName, String objectName, Integer expires) {
            boolean flag = bucketExists(bucketName);
            String url = "";
            if (flag) {
                if (expires < 1 || expires > DEFAULT_EXPIRY_TIME) {
                    throw new InvalidExpiresRangeException(expires,
                            "expires must be in range of 1 to " + DEFAULT_EXPIRY_TIME);
                }
                url = minioClient.presignedPutObject(bucketName, objectName, expires);
            }
            return url;
        }
    
        /**
         * 获取对象的元数据
         *
         * @param bucketName 存储桶名称
         * @param objectName 存储桶里的对象名称
         * @return
         */
        @SneakyThrows
        public ObjectStat statObject(String bucketName, String objectName) {
            boolean flag = bucketExists(bucketName);
            if (flag) {
                ObjectStat statObject = minioClient.statObject(bucketName, objectName);
                return statObject;
            }
            return null;
        }
    
        /**
         * 文件访问路径
         *
         * @param bucketName 存储桶名称
         * @param objectName 存储桶里的对象名称
         * @return
         */
        @SneakyThrows
        public String getObjectUrl(String bucketName, String objectName) {
            boolean flag = bucketExists(bucketName);
            String url = "";
            if (flag) {
                url = minioClient.getObjectUrl(bucketName, objectName);
            }
            return url;
        }
    
    
    
        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 (StrUtil.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) {
                e.printStackTrace();
            }
        }
    
    
    
    }
    
    
  • 相关阅读:
    qcow2文件压缩
    raw格式镜像文件压缩并转换为qcow2格式
    centos7 install virt-sysprep
    镜像简介
    QEMU 使用的镜像文件:qcow2 与 raw
    ubuntu14.04中国源
    less css下载及编绎工具
    分布式计算中WebService的替代方案: RPC (XML-RPC | JSON-RPC)
    Asp.net WebServer
    C#取调用堆栈StackTrace
  • 原文地址:https://www.cnblogs.com/huhongy/p/13542211.html
Copyright © 2011-2022 走看看