【Java编程系列】Minio实现文件上传下载

2023-09-02 18:36

短信预约 -IT技能 免费直播动态提醒

1、前言

最近给一个租户做minio的独立存储部署，使用过程中，有了一点使用心得，做一个记录分享，希望可以帮到有需要的朋友~~~

2、Minio实战代码

2.1 Minio环境部署

进入下载链接：https://dl.min.io/server/minio/release/ ，按需下载对应版本后，安装完毕即可。装载完成，启动minio后，可以直接打开对应的可视化界面，输入http://ip:9000/，如下图，表示部署安装成功啦（安装细节在本文展开，不清楚的童靴请搜索一下）：

2.2 Minio的Sdk对接实现

2.2.1 Minio Maven依赖

引入相关java sdk所需依赖：

    io.minio    minio    8.2.2

2.2.2 minio配置与初始化

先设置minio的一些配置信息：

minio:  url: http://127.0.0.1:9000    #安装minio的服务器ip  bucket: news                  #创建的存储桶名称（可界面创建，亦可sdk代码创建）  accessKey: testkey            #minio登录账号  secretKey: testpassword       #minio登录密码

通过配置类读取配置信息，为后续使用做准备：

package ***.***.***.***.configure;import lombok.Data;import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;import org.springframework.boot.context.properties.ConfigurationProperties;import org.springframework.context.annotation.Configuration;@Data@Configuration@ConfigurationProperties(prefix = "minio")public class MinioProperties {private String accessKey;private String secretKey;private String url;private String bucket;}

初始化minio客户端：

package ***.***.***.utils;import ***.***.***.MinioProperties;import io.minio.BucketExistsArgs;import io.minio.GetObjectArgs;import io.minio.MakeBucketArgs;import io.minio.MinioClient;import io.minio.PutObjectArgs;import io.minio.RemoveObjectArgs;import io.minio.errors.ErrorResponseException;import io.minio.errors.InsufficientDataException;import io.minio.errors.InternalException;import io.minio.errors.InvalidResponseException;import io.minio.errors.ServerException;import io.minio.errors.XmlParserException;import org.springframework.beans.factory.annotation.Autowired;import java.io.IOException;import java.io.InputStream;import java.security.InvalidKeyException;import java.security.NoSuchAlgorithmException;public class MinioClientUtil {@Autowiredprivate MinioProperties properties;private MinioClient client;    //初始化minio clientprivate void init() throws NoSuchAlgorithmException, InvalidKeyException, IOException,InvalidResponseException, InsufficientDataException, ServerException, ErrorResponseException,XmlParserException, InternalException {if (null != client) {return;}client = MinioClient.builder().endpoint(properties.getUrl()).credentials(properties.getAccessKey(), properties.getSecretKey()).build();makeBucket(properties.getBucket());}    //创建自定义的存储桶    //这里只做了简单的桶存在判断，这里还可以添加设置桶的策略等public void makeBucket(String bucket) throws IOException, InvalidKeyException, InvalidResponseException,InsufficientDataException, NoSuchAlgorithmException, ServerException, InternalException, XmlParserException,ErrorResponseException {boolean bucketExist = client.bucketExists(BucketExistsArgs.builder().bucket(bucket).build());if (!bucketExist) {client.makeBucket(MakeBucketArgs.builder().bucket(bucket).build());}}}

2.2.3 上传文件

import io.minio.BucketExistsArgs;import io.minio.GetObjectArgs;import io.minio.MakeBucketArgs;import io.minio.MinioClient;import io.minio.PutObjectArgs;import io.minio.RemoveObjectArgs;import io.minio.errors.ErrorResponseException;import io.minio.errors.InsufficientDataException;import io.minio.errors.InternalException;import io.minio.errors.InvalidResponseException;import io.minio.errors.ServerException;import io.minio.errors.XmlParserException;import org.springframework.beans.factory.annotation.Autowired;import java.io.IOException;import java.io.InputStream;import java.security.InvalidKeyException;import java.security.NoSuchAlgorithmException;public class MinioClientUtil {public void uploadFile(String bucket, String fileName, InputStream ins, long fileSize)throws IOException, InvalidKeyException, InvalidResponseException, InsufficientDataException,NoSuchAlgorithmException, ServerException, InternalException, XmlParserException,ErrorResponseException {init();makeBucket(bucket);PutObjectArgs.Builder putObjectArgsBuilder = PutObjectArgs.builder().bucket(bucket).object(fileName).stream(ins, fileSize, 5 * 1024 * 1024);client.putObject(putObjectArgsBuilder.build());}}

2.2.4 下载文件

import io.minio.BucketExistsArgs;import io.minio.GetObjectArgs;import io.minio.MakeBucketArgs;import io.minio.MinioClient;import io.minio.RemoveObjectArgs;import io.minio.errors.ErrorResponseException;import io.minio.errors.InsufficientDataException;import io.minio.errors.InternalException;import io.minio.errors.InvalidResponseException;import io.minio.errors.ServerException;import io.minio.errors.XmlParserException;import org.springframework.beans.factory.annotation.Autowired;import java.io.IOException;import java.io.InputStream;import java.security.InvalidKeyException;import java.security.NoSuchAlgorithmException;public class MinioClientUtil {public InputStream download(String bucket, String fileName)throws IOException, InvalidKeyException, InvalidResponseException, InsufficientDataException,NoSuchAlgorithmException, ServerException, InternalException, XmlParserException,ErrorResponseException {init();GetObjectArgs.Builder getObjectArgsBuilder = GetObjectArgs.builder().bucket(bucket).object(fileName);return client.getObject(getObjectArgsBuilder.build());}}

2.2.5 生成文件预签名url

import io.minio.BucketExistsArgs;import io.minio.GetObjectArgs;import io.minio.GetPresignedObjectUrlArgs;import io.minio.MakeBucketArgs;import io.minio.MinioClient;import io.minio.PutObjectArgs;import io.minio.RemoveObjectArgs;import io.minio.errors.ErrorResponseException;import io.minio.errors.InsufficientDataException;import io.minio.errors.InternalException;import io.minio.errors.InvalidResponseException;import io.minio.errors.ServerException;import io.minio.errors.XmlParserException;import io.minio.http.Method;import org.springframework.beans.factory.annotation.Autowired;import java.io.IOException;import java.io.InputStream;import java.security.InvalidKeyException;import java.security.NoSuchAlgorithmException;public class MinioClientUtil {private String getMinioURL(String bucket, String fileName) throws IOException, NoSuchAlgorithmException, InvalidKeyException, InvalidResponseException, ServerException, XmlParserException, InternalException, InsufficientDataException, ErrorResponseException {if (null == client) {init();}GetPresignedObjectUrlArgs build = GetPresignedObjectUrlArgs.builder().method(Method.GET).bucket(bucket).object(fileName).expiry(60 * 60 * 24)   //生成的预签名url可访问的有效时间，最大期限7天.build();return client.getPresignedObjectUrl(build);}}

2.2.6 文件永久性访问实现

这里做永久访问有效实现，是为了应对一种场景。例如，我们的图片文件，需要直接通过url（非下载后）可显示或打开，在系统用户头像这里，就可能会要求如此实现。因此，我们需要保证我们生成的图片url只可以直接访问的。

但是，通过上述预签名url的生成方式，有一个最大时效7天的限制，所以此方式暂不考虑。

minio其实也提供了，文件直接通过ip端口或域名的方式访问的，即用url访问minio存储桶中的文件。要想能直接通过自己定义的 ip+端口+图片路径 来访问的话，需要将minio指定存储桶的访问策略调整一下，如下图所示：

点击add，策略选Read Only就行了，就可以访问了。

然后，通过 http://ip:9000/同名/文件路径及名称 的URL形式，就可以永久访问到这个图片文件啦~~

这里有一个访问形式上的微调，可能有的系统，是使用域名访问的，这个时候域名的一些端口都是通过nginx指定统一了，那这个时候，对于minio如果需要使用域名访问，则需要把nginx再指定配置一下，就可以啦！

2.2.7 删除文件

import io.minio.BucketExistsArgs;import io.minio.GetObjectArgs;import io.minio.GetPresignedObjectUrlArgs;import io.minio.MakeBucketArgs;import io.minio.MinioClient;import io.minio.PutObjectArgs;import io.minio.RemoveObjectArgs;import io.minio.errors.ErrorResponseException;import io.minio.errors.InsufficientDataException;import io.minio.errors.InternalException;import io.minio.errors.InvalidResponseException;import io.minio.errors.ServerException;import io.minio.errors.XmlParserException;import io.minio.http.Method;import org.springframework.beans.factory.annotation.Autowired;import java.io.IOException;import java.io.InputStream;import java.security.InvalidKeyException;import java.security.NoSuchAlgorithmException;public class MinioClientUtil {public void delete(String bucket, String fileName) throws IOException, InvalidKeyException, InvalidResponseException,InsufficientDataException, NoSuchAlgorithmException, ServerException, InternalException, XmlParserException,ErrorResponseException {init();client.removeObject(RemoveObjectArgs.builder().bucket(bucket).object(fileName).build());}}