在上一篇文章中,我们已经在云服务器中安装并开启了minio服务,本章我们将为大家讲解如何利用程序将文件上传到minio桶中
下面介绍MinIO中的几个核心概念,这些概念在所有的对象存储服务中也都是通用的。
- **对象(Object)**
对象是实际的数据单元,例如我们上传的一个图片。
- **存储桶(Bucket)**
存储桶是用于组织对象的命名空间,类似于文件夹。每个存储桶可以包含多个对象。
- **端点(Endpoint)**
端点是MinIO服务器的网络地址,用于访问存储桶和对象,例如`http://192.168.10.101:9000`
**注意:**
`9000`为MinIO的API的默认端口,前边配置的`9001`以为管理页面端口。
- **Access Key 和 Secret Key**
**Access Key**是用于标识和验证访问者身份的唯一标识符,相当于用户名。
**Secret Key**是与**Access Key**关联的密码,用于验证访问者的身份。
首先
确保你的云服务器中开启了minio服务,然后去浏览器访问IP+PORT进行访问,比如:http://192.168.1.236:9001
在上一篇文章中,我们修改了用户名和密码,分别为admin 12345678,输入登录即可
另外的一些功能可以参考官方文档,这里指简单讲解
点击创建桶后,输入桶名即可,一些权限默认即可,不需要特别设置
然后去用户中查看
minio界面上传文件
**访问图片**
- **图片URL**
由于MinIO提供了HTTP访问功能,所以可以通过浏览器直接访问对象。对象URL为MinIO的`Endpoint`+`对象的存储路径`,例如下图中的图片对象的URL为http://211.159.166.206:9000/doctorimg/37.jpg]
不出意外的话,使用浏览器访问上述URL,会得到如下响应,很显然是没有访问权限。
若想继续访问图片,需要修改图片**所在桶**的访问权限,如下图所示
若想继续访问图片,需要修改图片**所在桶**的访问权限,
如上图所示,可选的访问权限共有三个选项,分别是`Private`、`Public`和`Custom`,具体说明如下
- `Private`
只允许桶的所有者对该桶进行读写。
- `Public`
允许所有人对该桶进行读写。
- `Custom`
自定义访问权限。
若想将权限设置为只允许所有者写,但允许所有人读,就需要自定义访问权限。自定义访问权限,需要使用一个规定格式的JSON字符串进行描述,具体格式可参考[官方文档]
例如以下JSON字符串表达的含义是:允许(`Allow`)所有人(`*`)读取(`s3:GetObject`)指定桶(`doctorimg`)的所有内容。
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"AWS": [
"*"
]
},
"Action": [
"s3:GetObject"
],
"Resource": [
"arn:aws:s3:::doctorimg/*"
]
}
]
}
然后再次访问
Java程序整合minio
MinIO提供了多种语言的SDK供开发者使用,本项目需要用到Java SDK,下面通过一个简单案例熟悉一下其基本用法,具体内容可参考[官方文档](https://www.minio.org.cn/docs/minio/linux/developers/java/minio-java.html#)。
1. **创建一个Maven项目**
2. **引入如下依赖**
<dependency>
<groupId>io.minio</groupId>
<artifactId>minio</artifactId>
<version>8.5.3</version>
</dependency>
注意 在此时很有可能会报依赖不兼容的错误
我自己也查询了许多资料,如果你是大佬,那你可以梳理清楚,各依赖相互兼容的关系,当我没说,如果你是小白,可以参考我的方法:在引入两个与其配套的底层依赖
<!--minio-->
<dependency>
<groupId>io.minio</groupId>
<artifactId>minio</artifactId>
<version>${minio.version}</version>
</dependency>
<dependency>
<groupId>com.squareup.okhttp3</groupId>
<artifactId>okhttp</artifactId>
<version>${okhttp3.version}</version> <!-- 或者尝试更低版本 -->
</dependency>
<dependency>
<groupId>com.squareup.okio</groupId>
<artifactId>okio</artifactId>
<version>${okio.version}</version>
</dependency>
<minio.version>8.5.3</minio.version>
<okhttp3.version>4.8.1</okhttp3.version>
<okio.version>2.8.0</okio.version>
3. **编写如下内容**
package com.example.minio;
import io.minio.*;
import io.minio.errors.MinioException;
import java.io.IOException;
import java.security.InvalidKeyException;
import java.security.NoSuchAlgorithmException;
public class testminio {
public static void main(String[] args) throws IOException, NoSuchAlgorithmException, InvalidKeyException {
try {
// 构造 MinIO Client 实例,用于连接 MinIO 服务器
// MinioClient.builder() 是 MinIO 客户端的构建器模式,使用 endpoint() 方法设置服务器地址
// 使用 credentials() 方法设置访问凭证(用户名和密码)
MinioClient minioClient = MinioClient.builder()
.endpoint("http://211.159.166.206:9000") // MinIO 服务器地址,包含 IP 和端口
.credentials("admin", "12345678") // 设置 MinIO 访问的用户名和密码
.build();
// 检查是否已经存在名为 doctorimg 的桶(bucket)
boolean found = minioClient.bucketExists(BucketExistsArgs.builder().bucket("doctorimg").build());
if (!found) {
// 如果桶不存在,则创建一个名为 doctorimg 的桶
minioClient.makeBucket(MakeBucketArgs.builder().bucket("doctorimg").build());
// 设置桶的访问权限为公开,允许所有用户进行 GetObject 操作(即可以读取桶中的对象)
// 设置桶策略的 JSON 格式,允许所有用户访问 doctorimg 桶中的对象
String policy = "{\n" +
" \"Statement\" : [ {\n" +
" \"Action\" : \"s3:GetObject\",\n" +
" \"Effect\" : \"Allow\",\n" +
" \"Principal\" : \"*\",\n" +
" \"Resource\" : \"arn:aws:s3:::doctorimg/*\"\n" +
" } ],\n" +
" \"Version\" : \"2012-10-17\"\n" +
"}";
// 将设置的策略应用到 doctorimg 桶上
minioClient.setBucketPolicy(SetBucketPolicyArgs.builder().bucket("doctorimg").config(policy).build());
} else {
// 如果桶已经存在,打印提示信息
System.out.println("Bucket 'doctorimg' already exists.");
}
// 上传文件到 MinIO 的 doctorimg 桶中
// 使用 UploadObjectArgs.builder() 方法构建上传参数
// bucket() 设置目标桶名
// object() 设置文件在桶中的名称
// filename() 设置要上传的文件的本地路径
minioClient.uploadObject(
UploadObjectArgs.builder()
.bucket("doctorimg") // 上传到的桶名
.object("37.jpg") // 文件在桶中存储时的名称
.filename("F:\\hospitalsystem\\upload\\doctor_img\\37.jpg") // 本地文件的绝对路径
.build());
// 文件上传成功后,打印提示信息
System.out.println("上传成功");
} catch (MinioException e) {
// 捕获 MinIO 客户端异常并打印错误信息
System.out.println("Error occurred: " + e);
}
}
}
运行上述代码,然后查看MinIO管理页面,观察是否上传成功。
注意
String policy = "{\n" +
" \"Statement\" : [ {\n" +
" \"Action\" : \"s3:GetObject\",\n" +
" \"Effect\" : \"Allow\",\n" +
" \"Principal\" : \"*\",\n" +
" \"Resource\" : \"arn:aws:s3:::doctorimg/*\"\n" +
" } ],\n" +
" \"Version\" : \"2012-10-17\"\n" +
"}";
此段代码表示设置权限,不同jdk版本对支持不同类型,jdk8只支持json,但jdk22支持文本类型,大家可以用文心一言生成适合你版本的类型
希望本篇博客能帮助你从入门到精通Minio,快速在项目中应用它的强大功能。