| 标题 | 地址| | --- | --- | | 记录Minio Docker部署 | https://juejin.cn/post/7206615325022224443| | Minio控制台详细教程 | https://juejin.cn/post/7206973995727372343| | SpringBoot集成Minio | 本文| | 企业级Minio的spring-boot-stater | 暂定| ### 找到我们需要的依赖打开maven仓库，搜索minio 地址【】 ![](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/461d8149ddcb485d9e6f8c0abcbbe1fc~tplv-k3u1fbpfcp-zoom-1.image) 这里选择的是8.5.1因为有12个人使用，下意识的选择嘿嘿。 ![](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/7587899410464493a756b654e14a50df~tplv-k3u1fbpfcp-zoom-1.image) ``` io.minio minio 8.5.1 ``` ### 创建一个SpringBoot项目如图所示，这里就过多的讲解了。 ![](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/041789c3e6e0430796fa894d9658cb38~tplv-k3u1fbpfcp-zoom-1.image) 创建好后，添加我们的minio Java SDK的依赖 ![](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/9e90c2a5a0f04b74b2e8dea23e1e53c0~tplv-k3u1fbpfcp-zoom-1.image) 本项目所使用的依赖 ``` io.minio minio 8.5.1 org.projectlombok lombok 1.18.12 provided cn.hutool hutool-all 5.8.12 ``` ### YML新增minio配置项如下图所示 ![](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/6871c4b15773420f93e70eeef93a2ec9~tplv-k3u1fbpfcp-zoom-1.image) 解读一下： endpoint：是你启动的minio所指定的api接口地址。获取方式，因为我部署的是docker，启动命令上指定了控制台端口号，以及api端口号，我这边就执行一下docker logs -f --tail 1000 minio查看容器日志的命令。如下图所示，就是我们API地址。 ![](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/4997bb95a7894efbbd2795c637cd81f2~tplv-k3u1fbpfcp-zoom-1.image) bucketName：就是我们的存储桶的名称。 accessKey：就是我们的访问的key secretKey：就是我们的密钥。 accessKey和secretKey要么是你的指定的登录用户账号，要么是你添加的Access Keys。 ![](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/eab6c6d320a44caf8cfb407ff7d206ba~tplv-k3u1fbpfcp-zoom-1.image) ### 新增MinioConfig 如图所示，新增MinioConfig配置类，Builder一个MinioClient对象交给spring管理。这个类的意思就是获取我们的yml配置项，Builder一个MinioClient对象交给spring管理。后续我们只需要声明一下MinioClient就可以调用里面的方法了。 ![](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/404a473fbb9346a0a797c187a4776e1b~tplv-k3u1fbpfcp-zoom-1.image) 代码： ``` @Data @Configuration @ConfigurationProperties(prefix = "minio") public class MinioConfig { private String endpoint; private String accessKey; private String secretKey; private String bucketName; @Bean public MinioClient minioClient() { return MinioClient.builder() .endpoint(endpoint) .credentials(accessKey, secretKey) .build(); } } ``` 下面会给大家查看构建MinioClient可以通过那些参数构建。 ### 查看MinioClient提供的服务如下图所示：点击我们的MinioCilent类，然后点击Structure可以看到下图所示的方法，类等等下面这个图重点是看MinioCilent的Builder类提供了那些方法builder。这里就不详细的讲解了，这个类很简单大家有兴趣的可以看看。 ![](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/7b187e57da5b4888ae7aad89022a2a9d~tplv-k3u1fbpfcp-zoom-1.image) 查看提供的服务。 ![](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/94e4d8cba1ae4623bfcec3b1ddbcc4cd~tplv-k3u1fbpfcp-zoom-1.image) 可以看到有一大推方法，比喻操作bucket的，操作Object的，甚至还有配置相关的方法。所需的参数，返回值都可以看到。下面我会给大家演部分操作。其余的有兴趣的可以研究一下。 ### 编写MinioService 下面就是MinioService相关代码。主要就是引入我们的MinioClient对象，还有MinioConfig配置类调用我们的MinioClient里面的提供的方法。详细请看代码。 ``` package com.example.studyminio.service; import com.example.studyminio.config.MinioConfig; import io.minio.*; import io.minio.http.Method; import io.minio.messages.Bucket; import io.minio.messages.Item; import lombok.RequiredArgsConstructor; import lombok.SneakyThrows; import org.springframework.stereotype.Service; import java.util.ArrayList; import java.util.List; /** * @Author JiaQIng * @Description MinioService * @ClassName MinioService * @Date 21点19分 **/ @Service @RequiredArgsConstructor public class MinioService { private final MinioClient minioClient; private final MinioConfig minioConfig; /** * 查看bucket是否存在 * * @param bucketName * @return */ @SneakyThrows public Boolean bucketExists(String bucketName) { return minioClient.bucketExists(BucketExistsArgs.builder() .bucket(bucketName) .build()); } /** * 创建存储bucket * * @return Boolean */ @SneakyThrows public void makeBucket(String bucketName) { minioClient.makeBucket(MakeBucketArgs.builder() .bucket(bucketName) .build()); } /** * 删除存储bucket * @return Boolean */ @SneakyThrows public void removeBucket(String bucketName) { minioClient.removeBucket(RemoveBucketArgs.builder() .bucket(bucketName) .build()); } /** * 获取全部bucket */ @SneakyThrows public List listBuckets() { return minioClient.listBuckets(); } /** * 获取文件的url * @param fileName * @return */ @SneakyThrows public String getPresignedObjectUrl(String fileName){ GetPresignedObjectUrlArgs build = GetPresignedObjectUrlArgs.builder().bucket(minioConfig.getBucketName()).object(fileName).method(Method.GET).build(); return minioClient.getPresignedObjectUrl(build); } /** * 查看文件对象 * @return 存储bucket内文件对象信息 */ @SneakyThrows public List listObjects() { Iterable> results = minioClient.listObjects( ListObjectsArgs.builder().bucket(minioConfig.getBucketName()).build()); List items = new ArrayList<>(); for (Result result : results) { items.add(result.get()); } return items; } /** * 删除 * @param fileName * @return * @throws Exception */ @SneakyThrows public void remove(String fileName) { minioClient.removeObject(RemoveObjectArgs.builder(). bucket(minioConfig.getBucketName()) .object(fileName) .build()); } } ``` ### 测试 #### 测试查看bucket是否存在如下图所示，测试成功。编写测试方法，测试我们的方法。 ![](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/7cd3e5ce18a144e69623a6eb5db9335b~tplv-k3u1fbpfcp-zoom-1.image) 代码： ``` @Test void bucketExists() { Boolean test = minioService.bucketExists("test1"); // Boolean test = minioService.bucketExists("test"); System.out.println("查看bucket是否存在" + test); } ``` #### 测试创建bucket 如下图所示。编写我们的测试方法，测试创建bucket是否成功。我们去到我们的minio控制台查看是否创建了test1的bucket。 ![](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/a23d366de42d457ab7bae594acf9079a~tplv-k3u1fbpfcp-zoom-1.image) 看我们的minio控制台已经创建成功了。 ![](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/accbd34293e843068c3283a94e9cba85~tplv-k3u1fbpfcp-zoom-1.image) 代码： ``` @Test void makeBucket() { minioService.makeBucket("test1"); } ``` #### 测试删除bucket 如下图所示。编写我们的测试方法，测试删除bucket是否成功。我们去到我们的minio控制台查看是否删除了test1的bucket。 ![](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/fa04225ecfef417a9e1669c434e4cb18~tplv-k3u1fbpfcp-zoom-1.image) 可以看到已经成功的删除了test1这个bucket。 ![](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/9c917aa0c82e4167bcb7b1286063ea16~tplv-k3u1fbpfcp-zoom-1.image) 代码： ``` @Test void removeBucket() { minioService.removeBucket("test1"); } ``` #### 测试获取所有的bucket 如下图所示。编写我们的测试方法，测试获取所有的bucket是否成功。我们去到我们的minio控制台查看是否正确。 ![](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/773897de5e91490ead35e8d9c05e0751~tplv-k3u1fbpfcp-zoom-1.image) 可以看到是正确的，测试没有问题。需要注意的是创建时间需要根据时区获取正确的时间。 ![](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/45d23683443f41ea909bb34349338a80~tplv-k3u1fbpfcp-zoom-1.image) 代码： ``` @Test void listBuckets() { List buckets = minioService.listBuckets(); buckets.forEach(bucket -> System.out.println("bucket名称" + bucket.name() + "-----bucket创建时间" +bucket.creationDate())); } ``` 至此测试完毕，剩下的不给大家演示，毕竟minio SDK提供了太多的方法，本文主要是讲集成，有兴趣的同学可以自己去测试，调用。 ### 总结本文主要是讲解SpringBoot如何集成Minio的Java SDK。有不懂的同学可以私信我，评论，看到了会一一答复的。我们下期再见。