SpringBoot使用Minio進行文件存儲的實現

Posted on by

一、minio

MinIO 是一個高性能的對象存儲原生支持 Kubernetes 部署的解決方案。 MinIO 提供瞭一個 Amazon Web Services S3 兼容 API 並支持所有核心 S3 功能。

MinIO 對象存儲使用 buckets 來組織對象。 存儲桶類似於文件系統中的文件夾或目錄，其中每個 桶可以容納任意數量的對象。 MinIO 存儲桶提供 與 AWS S3 存儲桶相同的功能。

其中 MinIO 的優勢有：

高性能：

MinIO是全球領先的對象存儲先鋒，在標準硬件上，讀/寫速度上高達183 GB / 秒 和 171 GB / 秒。

可擴展性：

MinIO利用瞭web縮放器的來之不易的知識，為對象存儲帶來瞭簡單的存儲縮放模型， 在 MinIO, 擴展從單個群集開始，該群集可以與其他MinIO群集聯合以創建全局名稱空間, 並在需要時可以跨越多個不同的數據中心。 通過添加更多集群可以擴展名稱空間, 更多機架，直到實現目標。

雲原生支持：

MinIO 是在過去4年的時間內從0開始打造的一款軟件 ，符合一切原生雲計算的架構和構建過程，並且包含最新的雲計算的全新的技術和概念。 其中包括支持Kubernetes 、微服和多租戶的的容器技術。使對象存儲對於 Kubernetes更加友好。

源碼開放與企業級支持：

MinIO 基於Apache V2 license 100% 開放源代碼 。 這就意味著 MinIO的客戶能夠自動的、無限制、自由免費使用和集成MinIO、自由的創新和創造、 自由的去修改、自由的再次發行新的版本和軟件. 確實, MinIO 強有力的支持和驅動瞭很多世界500強的企業。 此外，其部署的多樣性和專業性提供瞭其他軟件無法比擬的優勢。

官方文檔地址：http://docs.minio.org.cn/minio/baremetal/

在實驗開始前請確保安裝完成瞭 minio ：

二、SpringBoot 使用 Minio 進行文件存儲

首先新建一個 SpringBoot 項目，在 pom 中引入 minio 依賴：

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

在配置文件中，聲明出 minio 的信息：

minio:
  url: http://192.168.40.169:9000   # minio配置的地址，端口9000,註意不是控制臺的端口
  accessKey: minioadmin   # 賬號
  secretKey: minioadmin   # 密碼
  bucketName: test-bucket  # MinIO桶名字

下面創建一個配置類，對 MinioClient 進行創建：

@Data
@Configuration
@ConfigurationProperties(prefix = "minio")
public class MinioConfig {
    /**
     * 服務地址
     */
    private String url;
 
    /**
     * 用戶名
     */
    private String accessKey;
 
    /**
     * 密碼
     */
    private String secretKey;
 
    /**
     * 存儲桶名稱
     */
    private String bucketName;

    @Bean
    public MinioClient getMinioClient() throws Exception {
        MinioClient minioClient = MinioClient.builder().endpoint(url).credentials(accessKey, secretKey).build();
        //判斷桶是否存在，不存在則新建
        if (!minioClient.bucketExists(BucketExistsArgs.builder().bucket(bucketName).build())){
            minioClient.makeBucket(MakeBucketArgs.builder()
                    .bucket(bucketName)
                    .build());
        }
        return minioClient;
    }
}

下面創建一個工具類 MinioTool 將常用的操作封裝在工具類中：

@Component
public class MinioTool {
    
    @Autowired
    private MinioClient minioClient;

    @Autowired
    private MinioConfig minioConfig;
 
    /**
     * 查看存儲bucket是否存在
     *
     * @param bucketName 存儲bucket
     * @return boolean
     */
    public Boolean bucketExists(String bucketName) {
        Boolean found;
        try {
            found = minioClient.bucketExists(BucketExistsArgs.builder().bucket(bucketName).build());
        } catch (Exception e) {
            e.printStackTrace();
            return false;
        }
        return found;
    }
 
    /**
     * 創建存儲bucket
     *
     * @param bucketName 存儲bucket名稱
     * @return Boolean
     */
    public Boolean makeBucket(String bucketName) {
        try {
            minioClient.makeBucket(MakeBucketArgs.builder()
                    .bucket(bucketName)
                    .build());
        } catch (Exception e) {
            e.printStackTrace();
            return false;
        }
        return true;
    }
 
    /**
     * 刪除存儲bucket
     *
     * @param bucketName 存儲bucket名稱
     * @return Boolean
     */
    public Boolean removeBucket(String bucketName) {
        try {
            minioClient.removeBucket(RemoveBucketArgs.builder()
                    .bucket(bucketName)
                    .build());
        } catch (Exception e) {
            e.printStackTrace();
            return false;
        }
        return true;
    }

    /**
     * 查看文件對象
     *
     * @param bucketName 存儲bucket名稱
     * @return 存儲bucket內文件對象信息
     */
    public Iterable<Result<Item>> listObjects(String bucketName) {
        Iterable<Result<Item>> results = minioClient.listObjects(
                ListObjectsArgs.builder().bucket(bucketName).build());
        return results;
    }

    /**
     * 批量刪除文件對象
     *
     * @param bucketName 存儲bucket名稱
     * @param objects    對象名稱集合
     */
    public Iterable<Result<DeleteError>> removeObjects(String bucketName, List<String> objects) {
        List<DeleteObject> dos = objects.stream().map(e -> new DeleteObject(e)).collect(Collectors.toList());
        Iterable<Result<DeleteError>> results = minioClient.removeObjects(RemoveObjectsArgs.builder().bucket(bucketName).objects(dos).build());
        return results;
    }


    /**
     * 文件上傳
     * 文件名稱相同會覆蓋
     * @param file       文件
     * @return Boolean
     */
    public Boolean upload(MultipartFile file, String fileName) {
        try {
            if (!bucketExists(minioConfig.getBucketName())) {
                makeBucket(minioConfig.getBucketName());
            }
            PutObjectArgs objectArgs = PutObjectArgs.builder().bucket(minioConfig.getBucketName()).object(fileName)
                    .stream(file.getInputStream(), file.getSize(), -1).contentType(file.getContentType()).build();
            minioClient.putObject(objectArgs);
        } catch (Exception e) {
            e.printStackTrace();
            return false;
        }
        return true;
    }
 
    /**
     * 文件下載
     *
     * @param fileName   文件名稱
     * @param res        response
     * @return Boolean
     */
    public void download(String fileName, HttpServletResponse res) {
        GetObjectArgs objectArgs = GetObjectArgs.builder().bucket(minioConfig.getBucketName())
                .object(fileName).build();
        try (GetObjectResponse response = minioClient.getObject(objectArgs)) {
            byte[] buf = new byte[1024];
            int len;
            try (FastByteArrayOutputStream os = new FastByteArrayOutputStream()) {
                while ((len = response.read(buf)) != -1) {
                    os.write(buf, 0, len);
                }
                os.flush();
                byte[] bytes = os.toByteArray();
                res.setCharacterEncoding("utf-8");
                //設置強制下載不打開
                res.setContentType("application/force-download");
                res.addHeader("Content-Disposition", "attachment;fileName=" + fileName);
                try (ServletOutputStream stream = res.getOutputStream()) {
                    stream.write(bytes);
                    stream.flush();
                }
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    public String getFileUrl(String fileName){
        return StringFormatter.concat(minioConfig.getUrl(), "/", minioConfig.getBucketName(), "/", fileName).getValue();
    }

}

編寫測試接口，進行測試：

@Component
public class MinioTool {
    
    @Autowired
    private MinioClient minioClient;

    @Autowired
    private MinioConfig minioConfig;
 
    /**
     * 查看存儲bucket是否存在
     *
     * @param bucketName 存儲bucket
     * @return boolean
     */
    public Boolean bucketExists(String bucketName) {
        Boolean found;
        try {
            found = minioClient.bucketExists(BucketExistsArgs.builder().bucket(bucketName).build());
        } catch (Exception e) {
            e.printStackTrace();
            return false;
        }
        return found;
    }
 
    /**
     * 創建存儲bucket
     *
     * @param bucketName 存儲bucket名稱
     * @return Boolean
     */
    public Boolean makeBucket(String bucketName) {
        try {
            minioClient.makeBucket(MakeBucketArgs.builder()
                    .bucket(bucketName)
                    .build());
        } catch (Exception e) {
            e.printStackTrace();
            return false;
        }
        return true;
    }
 
    /**
     * 刪除存儲bucket
     *
     * @param bucketName 存儲bucket名稱
     * @return Boolean
     */
    public Boolean removeBucket(String bucketName) {
        try {
            minioClient.removeBucket(RemoveBucketArgs.builder()
                    .bucket(bucketName)
                    .build());
        } catch (Exception e) {
            e.printStackTrace();
            return false;
        }
        return true;
    }

    /**
     * 查看文件對象
     *
     * @param bucketName 存儲bucket名稱
     * @return 存儲bucket內文件對象信息
     */
    public Iterable<Result<Item>> listObjects(String bucketName) {
        Iterable<Result<Item>> results = minioClient.listObjects(
                ListObjectsArgs.builder().bucket(bucketName).build());
        return results;
    }

    /**
     * 批量刪除文件對象
     *
     * @param bucketName 存儲bucket名稱
     * @param objects    對象名稱集合
     */
    public Iterable<Result<DeleteError>> removeObjects(String bucketName, List<String> objects) {
        List<DeleteObject> dos = objects.stream().map(e -> new DeleteObject(e)).collect(Collectors.toList());
        Iterable<Result<DeleteError>> results = minioClient.removeObjects(RemoveObjectsArgs.builder().bucket(bucketName).objects(dos).build());
        return results;
    }


    /**
     * 文件上傳
     * 文件名稱相同會覆蓋
     * @param file       文件
     * @return Boolean
     */
    public Boolean upload(MultipartFile file, String fileName) {
        try {
            if (!bucketExists(minioConfig.getBucketName())) {
                makeBucket(minioConfig.getBucketName());
            }
            PutObjectArgs objectArgs = PutObjectArgs.builder().bucket(minioConfig.getBucketName()).object(fileName)
                    .stream(file.getInputStream(), file.getSize(), -1).contentType(file.getContentType()).build();
            minioClient.putObject(objectArgs);
        } catch (Exception e) {
            e.printStackTrace();
            return false;
        }
        return true;
    }
 
    /**
     * 文件下載
     *
     * @param fileName   文件名稱
     * @param res        response
     * @return Boolean
     */
    public void download(String fileName, HttpServletResponse res) {
        GetObjectArgs objectArgs = GetObjectArgs.builder().bucket(minioConfig.getBucketName())
                .object(fileName).build();
        try (GetObjectResponse response = minioClient.getObject(objectArgs)) {
            byte[] buf = new byte[1024];
            int len;
            try (FastByteArrayOutputStream os = new FastByteArrayOutputStream()) {
                while ((len = response.read(buf)) != -1) {
                    os.write(buf, 0, len);
                }
                os.flush();
                byte[] bytes = os.toByteArray();
                res.setCharacterEncoding("utf-8");
                //設置強制下載不打開
                res.setContentType("application/force-download");
                res.addHeader("Content-Disposition", "attachment;fileName=" + fileName);
                try (ServletOutputStream stream = res.getOutputStream()) {
                    stream.write(bytes);
                    stream.flush();
                }
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

    public String getFileUrl(String fileName){
        return StringFormatter.concat(minioConfig.getUrl(), "/", minioConfig.getBucketName(), "/", fileName).getValue();
    }

}

三、測試

測試上傳文件：

如果使用 返回的 url 直接訪問文件，可以發現返回權限不足：

這裡需要改一下 Bucket 的 Access Policy ，默認為 private，可以修改為 public 便無需認證，但安全性無法保證：

再次進行訪問，文件就可以打開瞭：

如果需要保持 private ，可以通過 MinioClient 進行下載，使用 download 測試接口下載文件：http://localhost:8080/file/download/20cab4e3979eba6003f95aca0dc75c63.jpg

 到此這篇關於SpringBoot使用Minio進行文件存儲的實現的文章就介紹到這瞭,更多相關SpringBoot Minio文件存儲內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet！

推薦閱讀：