Java整合MinIO实现文件管理

MinIo

MinIO基于Apache License 2.0开源协议的对象存储服务。它兼容Amazon S3云存储接口。适合存储非结构化数据,如图片,音频,视频,日志等。

MinIo基础概念

  • Object:存储到Minio的基本对象,如文件字节流,Anything
  • Bucket:用来存储Object的逻辑空间。每个Bucket之间的数据是相互隔离的。对于客户端而言,就相当于一个存放文件的顶层文件夹。
  • Drive:即存储数据的磁盘,在MiniO启动时,以参数的方式传入。Minio中所有的对象数据都会存储在Drive里
  • Set:即-组Drive的集合,分布式部署根据集群规模自动划分一个或多个Set,每个Set中的Drive分布在不同位置。一个对象存
    储在一个Set上。一个对象存储在一个Set上,一个集群划分为多个Set,一个Set包含的Drive数量是固定的,默认由系统根据集群规模自动计算得出
    一个Set中的Drive尽可能分布在不同的节点上。

docker运行

本次直接基于Docker来运行MinIo

拉取镜像

 docker pull minio/minio

运行镜像

docker run --privileged -d -it -p 9000:9000 -p 9111:9111
--name minio -e "MINIO_ROOT_USER=minioadmin" --privileged=true
-e "MINIO_ROOT_PASSWORD=minio@123456"
-v /Users/wangyupeng/data/minio/data:/data
-v /Users/wangyupeng/data/minio/config:/root/.minio minio/minio server /data
--console-address ":9111" -address ":9000"
  • 运行命令,重要参数说明

1、--privileged

container内的root拥有真正的root权限。否则,container内的root只是外部的一个普通用户权限。
privileged启动的容器,可以看到很多host上的设备,并且可以执行mount。甚至允许你在docker容器中启动docker容器。

2、MINIO_ROOT_USER

登陆管理界面的用户名

3、MINIO_ROOT_PASSWORD

登陆管理页面密码

4、-V

第一个-v 是设置数据存放目录,第二个-v是配置目录

5、--console-address

管理界面 端口设置,一定要和其中一个-p参数的端口对上,不指定的话会随机分配端口

6、-address

api访问端口

7、--name

容器运行的名字

查看运行日志

docker logs minio
  • 出现下面的日志,表示容器运行成功

访问minio

浏览器输入http://127.0.0.1:9111,输入设置的MINIO_ROOT_USERMINIO_ROOT_PASSWORD就能登录了,到此我们已经将minio运行起来了。

SpringBoot整合MinIO

引入依赖

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

配置

server:
  port: 9999

spring:
  servlet:
    multipart:
      max-file-size: 10MB
      max-request-size: 10MB
  minio:
    access-key: minioadmin      #key就是docker初始化是设置的,密钥相同
    secret-key: minio@123456
    url: http://localhost:9000
    bucket-name: admin   # 登陆minio创建的文件桶

构建配置类

package org.triumphxx.minio.config;

import io.minio.MinioClient;
import lombok.Data;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

/**
 * @author:triumphxx
 * @Date:2023/5/28
 * @Time:20:54
 * @微信公众号:北漂码农有话说
 * @网站:https://blog.triumphxx.com.cn
 * @GitHub https://github.com/triumphxx
 * @Desc: minio配置类
 **/
@Configuration
@ConfigurationProperties(prefix = "spring.minio")
@Data
public class MinioConfiguration {
    /**
     * 用户名
     */
    private String accessKey;
    /**
     * 密码
     */
    private String secretKey;
    /**
     * Minio 服务端 api地址
     */
    private String url;
    /**
     * 存储桶名字
     */
    private String bucketName;

    /**
     * 构建 操作Minio的客户端
     * @return
     */
    @Bean
    public MinioClient minioClient() {
        return MinioClient.builder()
                .endpoint(url)
                .credentials(accessKey, secretKey)
                .build();
    }

}

构建操作minio的服务类

package org.triumphxx.minio.service;

import io.minio.GetPresignedObjectUrlArgs;
import io.minio.MinioClient;
import io.minio.PostPolicy;
import io.minio.PutObjectArgs;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import org.springframework.web.multipart.MultipartFile;
import org.triumphxx.minio.config.MinioConfiguration;
import io.minio.http.Method;

import java.io.InputStream;
import java.time.ZonedDateTime;
import java.util.HashMap;
import java.util.Map;
import java.util.concurrent.TimeUnit;

/**
 * @author:triumphxx
 * @Date:2023/5/28
 * @Time:20:59
 * @微信公众号:北漂码农有话说
 * @网站:https://blog.triumphxx.com.cn
 * @GitHub https://github.com/triumphxx
 * @Desc: 操作minio的服务
 **/
@Service
@Slf4j
public class MinIoService {
    @Autowired
    private MinioClient minioClient;

    @Autowired
    private MinioConfiguration configuration;


    /**
     * 获取上传文件临时签名,作用是:前端获取到签名信息后可以直接将文件上传到minio
     * @param fileName
     * @param time
     * @return
     */
    public Map getPolicyUrl(String fileName, ZonedDateTime time) {
        PostPolicy postPolicy = new PostPolicy(configuration.getBucketName(), time);
        postPolicy.addEqualsCondition("key", fileName);
        try {
            Map<String, String> map = minioClient.getPresignedPostFormData(postPolicy);
            HashMap<String, String> policyMap = new HashMap<>();
            map.forEach((k,v)->{
                policyMap.put(k.replaceAll("-",""),v);
            });
            policyMap.put("host",configuration.getUrl()+"/"+configuration.getBucketName());
            return policyMap;
        }  catch (Exception e) {
            e.printStackTrace();
        }
        return null;
    }

    /**
     *
     * @param objectName
     * @param time
     * @param timeUnit
     * @return
     */
    public String getFileUrl(String objectName,int time, TimeUnit timeUnit) {
        try {
            return minioClient.getPresignedObjectUrl(GetPresignedObjectUrlArgs.builder()
                    .method(Method.GET)
                    .bucket(configuration.getBucketName())
                    .object(objectName)
                    .expiry(time, timeUnit).build());
        } catch (Exception e) {
            e.printStackTrace();
        }
        return null;
    }

    /**
     * 针对前端直接上传的是文件的格式
     * @param file 文件
     */
    public void uploadToFile(MultipartFile file) {
        // 使用putObject上传一个文件到存储桶中。
        try {
            InputStream inputStream = file.getInputStream();
            String fileName = file.getOriginalFilename();
            log.info("上传的文件名为:{}",fileName);
            minioClient.putObject(PutObjectArgs.builder()
                    .bucket(configuration.getBucketName())
                    .object(fileName.substring(0,fileName.indexOf(".")))
                    .stream(inputStream, file.getSize(), -1)
                    .contentType(file.getContentType())
                    .build());
        } catch (Exception e){
            e.printStackTrace();
        }
    }

    /**
     * 根据文件名访问指定有效期的文件访问链接
     * @param objectName
     * @param time
     * @param timeUnit
     * @return
     */
    public String getUrl(String objectName, int time, TimeUnit timeUnit) {
        String url = null;
        try {
            url = minioClient.getPresignedObjectUrl(GetPresignedObjectUrlArgs.builder()
                    .method(Method.GET)
                    .bucket(configuration.getBucketName())
                    .object(objectName)
                    .expiry(time, timeUnit).build());
        }catch (Exception e){
            e.printStackTrace();
        }
        return url;
    }
}

创建测试类

package org.triumphxx.minio.controller;

import org.springframework.web.bind.annotation.*;
import org.springframework.web.multipart.MultipartFile;
import org.triumphxx.minio.service.MinIoService;

import javax.annotation.Resource;
import java.time.ZonedDateTime;
import java.util.Map;
import java.util.concurrent.TimeUnit;

/**
 * @author:triumphxx
 * @Date:2023/5/28
 * @Time:20:58
 * @微信公众号:北漂码农有话说
 * @网站:https://blog.triumphxx.com.cn
 * @GitHub https://github.com/triumphxx
 * @Desc: 文件上传
 **/
@RestController
public class MinIoController {
    @Resource
    MinIoService minIoService;

    /**
     * 针对于前端的直接上传文件格式的接口
     * @param file
     */
    @PostMapping("/upload")
    public void uploadToFile(@RequestParam("file") MultipartFile file){
        minIoService.uploadToFile(file);
    }
    /**
     * 针对于后端文件流的形式上传文件
     * @param file
     */
    @PostMapping("/uploadToFileInputStream")
    public void uploadToFileInputStream(@RequestParam("file") MultipartFile file){
        minIoService.uploadToFile(file);
    }
    /**
     * 获取 一定有效期的图片连接
     * @param name 文件名称
     * @param time 时间 单位:天
     * @return
     */
    @GetMapping("/getFileUrl")
    public String getFileUrl(@RequestParam("name") String name , @RequestParam("time") int time){
       return minIoService.getUrl(name,time, TimeUnit.DAYS);
    }

    /**
     * 获取 文件签名
     * @param name 文件名称
     * @return
     */
    @PostMapping("/getPolicyUrl")
    public Map getPolicyUrl(@RequestParam("name") String name){
        return minIoService.getPolicyUrl(name, ZonedDateTime.now());
    }

    /**
     * 获取 临时文件连接
     * @param name 文件名称
     * @return
     */
    @PostMapping("/getTempFileUrl")
    public String getTempFileUrl(@RequestParam("name") String name, @RequestParam("time") int time){
        return minIoService.getFileUrl(name, time,TimeUnit.DAYS);
    }
}

使用postman测试

查看上传的图片

看到如下图片表示上传成功!

小结

本篇文章,一起探讨了使用docker运行minio,并且使用springboot整合,实现文件的上传。 源码地址源码传送门

在这里插入图片描述

要在Java整合MinIO,你需要使用MinIOJava客户端库。下面是一个简单的示例代码,用于连接到MinIO服务器并上传文件: 首先,你需要在项目的pom.xml文件中添加MinIO的依赖: ```xml <dependencies> <dependency> <groupId>io.minio</groupId> <artifactId>minio</artifactId> <version>8.0.10</version> </dependency> </dependencies> ``` 然后,使用以下代码连接到MinIO服务器并上传文件: ```java import io.minio.MinioClient; import io.minio.errors.MinioException; public class MinIOExample { public static void main(String[] args) { try { // 创建MinIO客户端对象 MinioClient minioClient = new MinioClient("https://minio.example.com", "accessKey", "secretKey"); // 检查存储桶是否存在,如果不存在则创建 boolean isExist = minioClient.bucketExists("mybucket"); if (!isExist) { minioClient.makeBucket("mybucket"); } // 上传文件 minioClient.putObject("mybucket", "myobject", "path/to/local/file"); System.out.println("文件上传成功"); } catch (MinioException e) { System.out.println("上传失败: " + e.getMessage()); } } } ``` 请确保替换示例代码中的以下参数: - `https://minio.example.com`:MinIO服务器的URL - `accessKey`:MinIO服务器的访问密钥 - `secretKey`:MinIO服务器的秘密密钥 - `mybucket`:存储桶的名称 - `myobject`:要上传的对象的名称 - `path/to/local/file`:要上传的本地文件路径 这只是一个简单的示例,你可以根据自己的需求进行更多操作,如下载文件、列出存储桶中的对象等。你可以参考MinIO的官方文档(https://docs.min.io/docs/java-client-quickstart-guide.html)了解更多功能和用法。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值