快捷導(dǎo)航

SpringBoot使用Minio進(jìn)行文件存儲(chǔ)的實(shí)現(xiàn)

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

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

一、minio

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

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

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

高性能：

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

可擴(kuò)展性：

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

云原生支持：

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

源碼開(kāi)放與企業(yè)級(jí)支持：

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

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

在實(shí)驗(yàn)開(kāi)始前請(qǐng)確保安裝完成了 minio ：

二、SpringBoot 使用 Minio 進(jìn)行文件存儲(chǔ)

首先新建一個(gè) SpringBoot 項(xiàng)目，在 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,注意不是控制臺(tái)的端口
  accessKey: minioadmin   # 賬號(hào)
  secretKey: minioadmin   # 密碼
  bucketName: test-bucket  # MinIO桶名字

下面創(chuàng)建一個(gè)配置類，對(duì) MinioClient 進(jìn)行創(chuàng)建：

@Data
@Configuration
@ConfigurationProperties(prefix = "minio")
public class MinioConfig {
    /**
     * 服務(wù)地址
     */
    private String url;
 
    /**
     * 用戶名
     */
    private String accessKey;
 
    /**
     * 密碼
     */
    private String secretKey;
 
    /**
     * 存儲(chǔ)桶名稱
     */
    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)建一個(gè)工具類 MinioTool 將常用的操作封裝在工具類中：

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

    @Autowired
    private MinioConfig minioConfig;
 
    /**
     * 查看存儲(chǔ)bucket是否存在
     *
     * @param bucketName 存儲(chǔ)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)建存儲(chǔ)bucket
     *
     * @param bucketName 存儲(chǔ)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;
    }
 
    /**
     * 刪除存儲(chǔ)bucket
     *
     * @param bucketName 存儲(chǔ)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;
    }

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

    /**
     * 批量刪除文件對(duì)象
     *
     * @param bucketName 存儲(chǔ)bucket名稱
     * @param objects    對(duì)象名稱集合
     */
    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;
    }


    /**
     * 文件上傳
     * 文件名稱相同會(huì)覆蓋
     * @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è)置強(qiáng)制下載不打開(kāi)
                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();
    }

}

編寫測(cè)試接口，進(jìn)行測(cè)試：

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

    @Autowired
    private MinioConfig minioConfig;
 
    /**
     * 查看存儲(chǔ)bucket是否存在
     *
     * @param bucketName 存儲(chǔ)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)建存儲(chǔ)bucket
     *
     * @param bucketName 存儲(chǔ)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;
    }
 
    /**
     * 刪除存儲(chǔ)bucket
     *
     * @param bucketName 存儲(chǔ)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;
    }

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

    /**
     * 批量刪除文件對(duì)象
     *
     * @param bucketName 存儲(chǔ)bucket名稱
     * @param objects    對(duì)象名稱集合
     */
    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;
    }


    /**
     * 文件上傳
     * 文件名稱相同會(huì)覆蓋
     * @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è)置強(qiáng)制下載不打開(kāi)
                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();
    }

}

三、測(cè)試

測(cè)試上傳文件：

如果使用返回的 url 直接訪問(wèn)文件，可以發(fā)現(xiàn)返回權(quán)限不足：

這里需要改一下 Bucket 的 Access Policy ，默認(rèn)為 private，可以修改為 public 便無(wú)需認(rèn)證，但安全性無(wú)法保證：

再次進(jìn)行訪問(wèn)，文件就可以打開(kāi)了：

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

到此這篇關(guān)于SpringBoot使用Minio進(jìn)行文件存儲(chǔ)的實(shí)現(xiàn)的文章就介紹到這了,更多相關(guān)SpringBoot Minio文件存儲(chǔ)內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: