快捷導(dǎo)航

SpringBoot使用Minio進行文件存儲的實現(xiàn)

更新時間：2022年07月25日 15:46:07 作者：小畢超

本文主要介紹了SpringBoot使用Minio進行文件存儲的實現(xiàn)，文中通過示例代碼介紹的非常詳細(xì)，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧

一、minio

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

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

其中 MinIO 的優(yōu)勢有：

高性能：

MinIO是全球領(lǐng)先的對象存儲先鋒，在標(biāo)準(zhǔn)硬件上，讀/寫速度上高達183 GB / 秒 和 171 GB / 秒。

可擴展性：

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

云原生支持：

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

源碼開放與企業(yè)級支持：

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

官方文檔地址：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桶名字

下面創(chuàng)建一個配置類，對 MinioClient 進行創(chuàng)建：

@Data
@Configuration
@ConfigurationProperties(prefix = "minio")
public class MinioConfig {
    /**
     * 服務(wù)地址
     */
    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;
    }
}

下面創(chuàng)建一個工具類 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;
    }
 
    /**
     * 創(chuàng)建存儲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內(nèi)文件對象信息
     */
    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");
                //設(shè)置強制下載不打開
                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;
    }
 
    /**
     * 創(chuàng)建存儲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內(nèi)文件對象信息
     */
    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");
                //設(shè)置強制下載不打開
                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();
    }

}