签入版本

This commit is contained in:
2026-09-10 21:41:50 +08:00
commit 717116a605
2693 changed files with 355025 additions and 0 deletions
@@ -0,0 +1,106 @@
// +======================================================================
// | 小蚂蚁云·企业数字化开发平台 [ 加速数字化转型,构建智能未来 ]
// +----------------------------------------------------------------------
// | 核心价值:赋能开发者 · 服务企业 · 共建生态
// +----------------------------------------------------------------------
// | Copyright (c) 2020-2026 小蚂蚁云团队 版权所有
// +----------------------------------------------------------------------
// | 官方平台: https://www.xiaomayicloud.com
// +======================================================================
// | 【知识产权声明】
// | 1. 权属声明:本软件是受《中华人民共和国著作权法》
// | 保护的专有财产,完整版权归小蚂蚁云团队所有
// | 2. 权利范围:所有知识产权(商标、专利、著作权、
// | 商业秘密等)均归小蚂蚁云团队所有,受法律保护
// | 3. 授权性质:用户仅可获得有限的、非独占的使用许可
// | 4. 禁止行为:未经书面授权,禁止对本软件本身
// | 申请任何知识产权
// | 5. 权利保留:未在本协议中明示授予的一切权利
// | 均由小蚂蚁云团队保留
// +======================================================================
// | 【授权状态说明】
// | 1. 未授权状态:用户未购买有效的商业许可证
// | 2. 商业授权:已购买正式商业许可证的用户
// +======================================================================
// | 【绝对禁止条款】
// | 无论授权状态如何,任何用户均严格禁止以下行为:
// | 1. 逆向工程:对软件进行反编译、反汇编、技术破解或任何形式的逆向分析
// | 2. 版权破坏:移除、修改、遮挡软件中的版权标识、许可控制或技术保护措施
// | 3. 非法传播:复制、分发、出租、出借、转售、再许可本软件或其许可权利
// | 4. 竞争性使用:利用本软件的代码、架构、设计开发直接竞争的产品或服务
// | 5. 侵权使用:将软件用于侵犯第三方知识产权或其他合法权益的用途
// +======================================================================
// | 【商业授权许可范围】
// | 购买有效商业许可证的用户,在遵守上述禁止条款的前提下,获得:
// | 1. 使用权利:在许可证约定的项目数量、开发者数量范围内使用本软件
// | 2. 技术支持:商业授权用户可以获取本地开发部署的技术支持服务
// | 3. 版本更新:在许可证有效期内获取软件更新、安全补丁和功能增强
// | 4. 商业部署:将基于本软件开发的应用程序用于商业运营和生产环境
// +======================================================================
// | 【许可证获取】
// | 1. 获取途径:仅通过小蚂蚁云官方渠道购买(官网、授权代理商),购买记录凭证
// | 2. 转让限制:许可证与购买主体绑定,未经书面同意不得转让
// | 3. 终止情形:许可证到期、违反协议、破产清算等情况下自动终止
// +======================================================================
// | 【合法使用要求】
// | 1. 仅限用于合法合规的软件研发
// | 2. 严禁用于任何违法、侵权或恶意行为
// | 3. 严禁违反我国法律法规和政策
// +======================================================================
// | 【免责声明】
// | 因使用本框架导致的以下情况,我们概不负责:
// | 1. 项目研发中的意外、疏忽、违约等风险
// | 2. 侵犯第三方知识产权或其他合法权益
// | 3. 任何直接、间接、附带或衍生一切损失
// | 4. 用户违规违法行为的一切法律后果
// +======================================================================
// | 【协议重要提示】
// | 1. 本声明是《小蚂蚁云最终用户许可协议》的摘要版本
// | 2. 下载、安装或使用本软件即表示您接受全部协议条款
// | 3. 我们保留单方面修改本声明的权利,修改后的版本在官网公布即生效
// | 4. 用户有义务定期查看最新版本,继续使用视为接受修改
// +======================================================================
// | 【侵权举报与合规】
// | 1. 知识产权侵权举报:请联系官方客服
// | 2. 许可证合规咨询:xiaomayicloud@163.com
// | 3. 违规使用将终止授权并追究责任
// | 4. 无条件配合司法机关调查取证
// | 5. 保留一切法律追诉权利
// | 6. 对有效举报和合规建议,我们将给予感谢和奖励
// +======================================================================
package com.xiaomayi.minio.config;
import io.minio.MinioClient;
import lombok.extern.slf4j.Slf4j;
import org.springframework.boot.context.properties.EnableConfigurationProperties;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
/**
* <p>
* Minio配置类
* </p>
*
* @author 小蚂蚁云团队
* @since 2024-06-04
*/
@Slf4j
@Configuration
@EnableConfigurationProperties(MinioProperties.class)
public class MinioConfig {
/**
* Minio客户端注册
*
* @return 返回结果
*/
@Bean
public MinioClient minioClient() {
return MinioClient.builder()
.endpoint(MinioProperties.getEndpoint())
.credentials(MinioProperties.getAccessKey(), MinioProperties.getSecretKey())
.build();
}
}
@@ -0,0 +1,156 @@
// +======================================================================
// | 小蚂蚁云·企业数字化开发平台 [ 加速数字化转型,构建智能未来 ]
// +----------------------------------------------------------------------
// | 核心价值:赋能开发者 · 服务企业 · 共建生态
// +----------------------------------------------------------------------
// | Copyright (c) 2020-2026 小蚂蚁云团队 版权所有
// +----------------------------------------------------------------------
// | 官方平台: https://www.xiaomayicloud.com
// +======================================================================
// | 【知识产权声明】
// | 1. 权属声明:本软件是受《中华人民共和国著作权法》
// | 保护的专有财产,完整版权归小蚂蚁云团队所有
// | 2. 权利范围:所有知识产权(商标、专利、著作权、
// | 商业秘密等)均归小蚂蚁云团队所有,受法律保护
// | 3. 授权性质:用户仅可获得有限的、非独占的使用许可
// | 4. 禁止行为:未经书面授权,禁止对本软件本身
// | 申请任何知识产权
// | 5. 权利保留:未在本协议中明示授予的一切权利
// | 均由小蚂蚁云团队保留
// +======================================================================
// | 【授权状态说明】
// | 1. 未授权状态:用户未购买有效的商业许可证
// | 2. 商业授权:已购买正式商业许可证的用户
// +======================================================================
// | 【绝对禁止条款】
// | 无论授权状态如何,任何用户均严格禁止以下行为:
// | 1. 逆向工程:对软件进行反编译、反汇编、技术破解或任何形式的逆向分析
// | 2. 版权破坏:移除、修改、遮挡软件中的版权标识、许可控制或技术保护措施
// | 3. 非法传播:复制、分发、出租、出借、转售、再许可本软件或其许可权利
// | 4. 竞争性使用:利用本软件的代码、架构、设计开发直接竞争的产品或服务
// | 5. 侵权使用:将软件用于侵犯第三方知识产权或其他合法权益的用途
// +======================================================================
// | 【商业授权许可范围】
// | 购买有效商业许可证的用户,在遵守上述禁止条款的前提下,获得:
// | 1. 使用权利:在许可证约定的项目数量、开发者数量范围内使用本软件
// | 2. 技术支持:商业授权用户可以获取本地开发部署的技术支持服务
// | 3. 版本更新:在许可证有效期内获取软件更新、安全补丁和功能增强
// | 4. 商业部署:将基于本软件开发的应用程序用于商业运营和生产环境
// +======================================================================
// | 【许可证获取】
// | 1. 获取途径:仅通过小蚂蚁云官方渠道购买(官网、授权代理商),购买记录凭证
// | 2. 转让限制:许可证与购买主体绑定,未经书面同意不得转让
// | 3. 终止情形:许可证到期、违反协议、破产清算等情况下自动终止
// +======================================================================
// | 【合法使用要求】
// | 1. 仅限用于合法合规的软件研发
// | 2. 严禁用于任何违法、侵权或恶意行为
// | 3. 严禁违反我国法律法规和政策
// +======================================================================
// | 【免责声明】
// | 因使用本框架导致的以下情况,我们概不负责:
// | 1. 项目研发中的意外、疏忽、违约等风险
// | 2. 侵犯第三方知识产权或其他合法权益
// | 3. 任何直接、间接、附带或衍生一切损失
// | 4. 用户违规违法行为的一切法律后果
// +======================================================================
// | 【协议重要提示】
// | 1. 本声明是《小蚂蚁云最终用户许可协议》的摘要版本
// | 2. 下载、安装或使用本软件即表示您接受全部协议条款
// | 3. 我们保留单方面修改本声明的权利,修改后的版本在官网公布即生效
// | 4. 用户有义务定期查看最新版本,继续使用视为接受修改
// +======================================================================
// | 【侵权举报与合规】
// | 1. 知识产权侵权举报:请联系官方客服
// | 2. 许可证合规咨询:xiaomayicloud@163.com
// | 3. 违规使用将终止授权并追究责任
// | 4. 无条件配合司法机关调查取证
// | 5. 保留一切法律追诉权利
// | 6. 对有效举报和合规建议,我们将给予感谢和奖励
// +======================================================================
package com.xiaomayi.minio.config;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.context.annotation.Configuration;
import java.util.ArrayList;
import java.util.List;
/**
* <p>
* Minio属性配置类
* </p>
*
* @author 小蚂蚁云团队
* @since 2024-06-04
*/
@Configuration
@ConfigurationProperties(prefix = "minio")
public class MinioProperties {
/**
* 对象存储服务URL
*/
private static String endpoint;
/**
* 对象存储服务KEY
*/
private static String accessKey;
/**
* 对象存储服务秘钥
*/
private static String secretKey;
/**
* 对象存储服务存储桶名
*/
private static String bucketName;
/**
* 可上传的文件后缀名
*/
private static List<String> fileExts = new ArrayList<>();
public static String getAccessKey() {
return accessKey;
}
public void setAccessKey(String accessKey) {
MinioProperties.accessKey = accessKey;
}
public static String getSecretKey() {
return secretKey;
}
public void setSecretKey(String secretKey) {
MinioProperties.secretKey = secretKey;
}
public static String getEndpoint() {
return endpoint;
}
public void setEndpoint(String endpoint) {
MinioProperties.endpoint = endpoint;
}
public static String getBucketName() {
return bucketName;
}
public void setBucketName(String bucketName) {
MinioProperties.bucketName = bucketName;
}
public static List<String> getFileExts() {
return fileExts;
}
public void setFileExts(List<String> fileExts) {
MinioProperties.fileExts = fileExts;
}
}
@@ -0,0 +1,141 @@
// +======================================================================
// | 小蚂蚁云·企业数字化开发平台 [ 加速数字化转型,构建智能未来 ]
// +----------------------------------------------------------------------
// | 核心价值:赋能开发者 · 服务企业 · 共建生态
// +----------------------------------------------------------------------
// | Copyright (c) 2020-2026 小蚂蚁云团队 版权所有
// +----------------------------------------------------------------------
// | 官方平台: https://www.xiaomayicloud.com
// +======================================================================
// | 【知识产权声明】
// | 1. 权属声明:本软件是受《中华人民共和国著作权法》
// | 保护的专有财产,完整版权归小蚂蚁云团队所有
// | 2. 权利范围:所有知识产权(商标、专利、著作权、
// | 商业秘密等)均归小蚂蚁云团队所有,受法律保护
// | 3. 授权性质:用户仅可获得有限的、非独占的使用许可
// | 4. 禁止行为:未经书面授权,禁止对本软件本身
// | 申请任何知识产权
// | 5. 权利保留:未在本协议中明示授予的一切权利
// | 均由小蚂蚁云团队保留
// +======================================================================
// | 【授权状态说明】
// | 1. 未授权状态:用户未购买有效的商业许可证
// | 2. 商业授权:已购买正式商业许可证的用户
// +======================================================================
// | 【绝对禁止条款】
// | 无论授权状态如何,任何用户均严格禁止以下行为:
// | 1. 逆向工程:对软件进行反编译、反汇编、技术破解或任何形式的逆向分析
// | 2. 版权破坏:移除、修改、遮挡软件中的版权标识、许可控制或技术保护措施
// | 3. 非法传播:复制、分发、出租、出借、转售、再许可本软件或其许可权利
// | 4. 竞争性使用:利用本软件的代码、架构、设计开发直接竞争的产品或服务
// | 5. 侵权使用:将软件用于侵犯第三方知识产权或其他合法权益的用途
// +======================================================================
// | 【商业授权许可范围】
// | 购买有效商业许可证的用户,在遵守上述禁止条款的前提下,获得:
// | 1. 使用权利:在许可证约定的项目数量、开发者数量范围内使用本软件
// | 2. 技术支持:商业授权用户可以获取本地开发部署的技术支持服务
// | 3. 版本更新:在许可证有效期内获取软件更新、安全补丁和功能增强
// | 4. 商业部署:将基于本软件开发的应用程序用于商业运营和生产环境
// +======================================================================
// | 【许可证获取】
// | 1. 获取途径:仅通过小蚂蚁云官方渠道购买(官网、授权代理商),购买记录凭证
// | 2. 转让限制:许可证与购买主体绑定,未经书面同意不得转让
// | 3. 终止情形:许可证到期、违反协议、破产清算等情况下自动终止
// +======================================================================
// | 【合法使用要求】
// | 1. 仅限用于合法合规的软件研发
// | 2. 严禁用于任何违法、侵权或恶意行为
// | 3. 严禁违反我国法律法规和政策
// +======================================================================
// | 【免责声明】
// | 因使用本框架导致的以下情况,我们概不负责:
// | 1. 项目研发中的意外、疏忽、违约等风险
// | 2. 侵犯第三方知识产权或其他合法权益
// | 3. 任何直接、间接、附带或衍生一切损失
// | 4. 用户违规违法行为的一切法律后果
// +======================================================================
// | 【协议重要提示】
// | 1. 本声明是《小蚂蚁云最终用户许可协议》的摘要版本
// | 2. 下载、安装或使用本软件即表示您接受全部协议条款
// | 3. 我们保留单方面修改本声明的权利,修改后的版本在官网公布即生效
// | 4. 用户有义务定期查看最新版本,继续使用视为接受修改
// +======================================================================
// | 【侵权举报与合规】
// | 1. 知识产权侵权举报:请联系官方客服
// | 2. 许可证合规咨询:xiaomayicloud@163.com
// | 3. 违规使用将终止授权并追究责任
// | 4. 无条件配合司法机关调查取证
// | 5. 保留一切法律追诉权利
// | 6. 对有效举报和合规建议,我们将给予感谢和奖励
// +======================================================================
package com.xiaomayi.minio.constants;
public class MinioConstants {
/**
* JPEG图片,浏览器预览
*/
public static final String IMAGE_JPG = "image/jpeg";
/**
* PNG图片,浏览器预览
*/
public static final String IMAGE_PNG = "image/png";
/**
* GIF图片,浏览器预览
*/
public static final String IMAGE_GIF = "image/gif";
/**
* PDF文档,浏览器预览
*/
public static final String APPLICATION_PDF = "application/pdf";
/**
* MP4视频,浏览器预览
*/
public static final String APPLICATION_MP4 = "video/mp4";
/**
* Wworld类型
*/
public static final String APPLICATION_WORD = "application/msword";
/**
* 二进制流,浏览器预览
*/
public static final String APPLICATION_STREAM = "application/octet-stream";
/**
* 默认大小:50M
*/
public static final long FILE_MAX_SIZE = 50 * 1024 * 1024;
/**
* 默认的文件名最大长度:100
*/
public static final int FILE_NAME_LENGTH = 100;
/**
* 设置获取文件和图片的过期时间,expires签名有效时间,单位秒
*/
public static final Integer EXPIRES = 604800;
/**
* 图片桶
*/
public static final String BUCKET_IMG = "image";
/**
* 文件桶
*/
public static final String BUCKET_FILE = "file";
/**
* 视频桶
*/
public static final String BUCKET_VIDEO = "video";
}
@@ -0,0 +1,100 @@
// +======================================================================
// | 小蚂蚁云·企业数字化开发平台 [ 加速数字化转型,构建智能未来 ]
// +----------------------------------------------------------------------
// | 核心价值:赋能开发者 · 服务企业 · 共建生态
// +----------------------------------------------------------------------
// | Copyright (c) 2020-2026 小蚂蚁云团队 版权所有
// +----------------------------------------------------------------------
// | 官方平台: https://www.xiaomayicloud.com
// +======================================================================
// | 【知识产权声明】
// | 1. 权属声明:本软件是受《中华人民共和国著作权法》
// | 保护的专有财产,完整版权归小蚂蚁云团队所有
// | 2. 权利范围:所有知识产权(商标、专利、著作权、
// | 商业秘密等)均归小蚂蚁云团队所有,受法律保护
// | 3. 授权性质:用户仅可获得有限的、非独占的使用许可
// | 4. 禁止行为:未经书面授权,禁止对本软件本身
// | 申请任何知识产权
// | 5. 权利保留:未在本协议中明示授予的一切权利
// | 均由小蚂蚁云团队保留
// +======================================================================
// | 【授权状态说明】
// | 1. 未授权状态:用户未购买有效的商业许可证
// | 2. 商业授权:已购买正式商业许可证的用户
// +======================================================================
// | 【绝对禁止条款】
// | 无论授权状态如何,任何用户均严格禁止以下行为:
// | 1. 逆向工程:对软件进行反编译、反汇编、技术破解或任何形式的逆向分析
// | 2. 版权破坏:移除、修改、遮挡软件中的版权标识、许可控制或技术保护措施
// | 3. 非法传播:复制、分发、出租、出借、转售、再许可本软件或其许可权利
// | 4. 竞争性使用:利用本软件的代码、架构、设计开发直接竞争的产品或服务
// | 5. 侵权使用:将软件用于侵犯第三方知识产权或其他合法权益的用途
// +======================================================================
// | 【商业授权许可范围】
// | 购买有效商业许可证的用户,在遵守上述禁止条款的前提下,获得:
// | 1. 使用权利:在许可证约定的项目数量、开发者数量范围内使用本软件
// | 2. 技术支持:商业授权用户可以获取本地开发部署的技术支持服务
// | 3. 版本更新:在许可证有效期内获取软件更新、安全补丁和功能增强
// | 4. 商业部署:将基于本软件开发的应用程序用于商业运营和生产环境
// +======================================================================
// | 【许可证获取】
// | 1. 获取途径:仅通过小蚂蚁云官方渠道购买(官网、授权代理商),购买记录凭证
// | 2. 转让限制:许可证与购买主体绑定,未经书面同意不得转让
// | 3. 终止情形:许可证到期、违反协议、破产清算等情况下自动终止
// +======================================================================
// | 【合法使用要求】
// | 1. 仅限用于合法合规的软件研发
// | 2. 严禁用于任何违法、侵权或恶意行为
// | 3. 严禁违反我国法律法规和政策
// +======================================================================
// | 【免责声明】
// | 因使用本框架导致的以下情况,我们概不负责:
// | 1. 项目研发中的意外、疏忽、违约等风险
// | 2. 侵犯第三方知识产权或其他合法权益
// | 3. 任何直接、间接、附带或衍生一切损失
// | 4. 用户违规违法行为的一切法律后果
// +======================================================================
// | 【协议重要提示】
// | 1. 本声明是《小蚂蚁云最终用户许可协议》的摘要版本
// | 2. 下载、安装或使用本软件即表示您接受全部协议条款
// | 3. 我们保留单方面修改本声明的权利,修改后的版本在官网公布即生效
// | 4. 用户有义务定期查看最新版本,继续使用视为接受修改
// +======================================================================
// | 【侵权举报与合规】
// | 1. 知识产权侵权举报:请联系官方客服
// | 2. 许可证合规咨询:xiaomayicloud@163.com
// | 3. 违规使用将终止授权并追究责任
// | 4. 无条件配合司法机关调查取证
// | 5. 保留一切法律追诉权利
// | 6. 对有效举报和合规建议,我们将给予感谢和奖励
// +======================================================================
package com.xiaomayi.minio.controller;
import com.xiaomayi.minio.utils.MinioUtils;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.multipart.MultipartFile;
import java.util.List;
@Slf4j
@RestController
public class MinioController {
@Autowired
private MinioUtils minioUtils;
@PostMapping("/upload")
public Object upload(MultipartFile file) {
// 上传文件
List<String> upload = minioUtils.uploadFile(new MultipartFile[]{file}, "");
// return address + "/" + bucketName + "/" + upload.get(0);
return null;
}
}
@@ -0,0 +1,154 @@
// +======================================================================
// | 小蚂蚁云·企业数字化开发平台 [ 加速数字化转型,构建智能未来 ]
// +----------------------------------------------------------------------
// | 核心价值:赋能开发者 · 服务企业 · 共建生态
// +----------------------------------------------------------------------
// | Copyright (c) 2020-2026 小蚂蚁云团队 版权所有
// +----------------------------------------------------------------------
// | 官方平台: https://www.xiaomayicloud.com
// +======================================================================
// | 【知识产权声明】
// | 1. 权属声明:本软件是受《中华人民共和国著作权法》
// | 保护的专有财产,完整版权归小蚂蚁云团队所有
// | 2. 权利范围:所有知识产权(商标、专利、著作权、
// | 商业秘密等)均归小蚂蚁云团队所有,受法律保护
// | 3. 授权性质:用户仅可获得有限的、非独占的使用许可
// | 4. 禁止行为:未经书面授权,禁止对本软件本身
// | 申请任何知识产权
// | 5. 权利保留:未在本协议中明示授予的一切权利
// | 均由小蚂蚁云团队保留
// +======================================================================
// | 【授权状态说明】
// | 1. 未授权状态:用户未购买有效的商业许可证
// | 2. 商业授权:已购买正式商业许可证的用户
// +======================================================================
// | 【绝对禁止条款】
// | 无论授权状态如何,任何用户均严格禁止以下行为:
// | 1. 逆向工程:对软件进行反编译、反汇编、技术破解或任何形式的逆向分析
// | 2. 版权破坏:移除、修改、遮挡软件中的版权标识、许可控制或技术保护措施
// | 3. 非法传播:复制、分发、出租、出借、转售、再许可本软件或其许可权利
// | 4. 竞争性使用:利用本软件的代码、架构、设计开发直接竞争的产品或服务
// | 5. 侵权使用:将软件用于侵犯第三方知识产权或其他合法权益的用途
// +======================================================================
// | 【商业授权许可范围】
// | 购买有效商业许可证的用户,在遵守上述禁止条款的前提下,获得:
// | 1. 使用权利:在许可证约定的项目数量、开发者数量范围内使用本软件
// | 2. 技术支持:商业授权用户可以获取本地开发部署的技术支持服务
// | 3. 版本更新:在许可证有效期内获取软件更新、安全补丁和功能增强
// | 4. 商业部署:将基于本软件开发的应用程序用于商业运营和生产环境
// +======================================================================
// | 【许可证获取】
// | 1. 获取途径:仅通过小蚂蚁云官方渠道购买(官网、授权代理商),购买记录凭证
// | 2. 转让限制:许可证与购买主体绑定,未经书面同意不得转让
// | 3. 终止情形:许可证到期、违反协议、破产清算等情况下自动终止
// +======================================================================
// | 【合法使用要求】
// | 1. 仅限用于合法合规的软件研发
// | 2. 严禁用于任何违法、侵权或恶意行为
// | 3. 严禁违反我国法律法规和政策
// +======================================================================
// | 【免责声明】
// | 因使用本框架导致的以下情况,我们概不负责:
// | 1. 项目研发中的意外、疏忽、违约等风险
// | 2. 侵犯第三方知识产权或其他合法权益
// | 3. 任何直接、间接、附带或衍生一切损失
// | 4. 用户违规违法行为的一切法律后果
// +======================================================================
// | 【协议重要提示】
// | 1. 本声明是《小蚂蚁云最终用户许可协议》的摘要版本
// | 2. 下载、安装或使用本软件即表示您接受全部协议条款
// | 3. 我们保留单方面修改本声明的权利,修改后的版本在官网公布即生效
// | 4. 用户有义务定期查看最新版本,继续使用视为接受修改
// +======================================================================
// | 【侵权举报与合规】
// | 1. 知识产权侵权举报:请联系官方客服
// | 2. 许可证合规咨询:xiaomayicloud@163.com
// | 3. 违规使用将终止授权并追究责任
// | 4. 无条件配合司法机关调查取证
// | 5. 保留一切法律追诉权利
// | 6. 对有效举报和合规建议,我们将给予感谢和奖励
// +======================================================================
package com.xiaomayi.minio.model;
import com.xiaomayi.core.utils.FileUtils;
import io.minio.messages.Item;
import io.minio.messages.Owner;
import lombok.Data;
import java.time.LocalDateTime;
/**
* <p>
* 存储对象模型
* </p>
*
* @author 小蚂蚁云团队
* @since 2024-06-04
*/
@Data
public class MinioItem {
/**
* 文件名称
*/
private String objectName;
/**
* 最后操作时间
*/
private LocalDateTime lastModified;
/**
* ETag
*/
private String etag;
/**
* 对象大小
*/
private String size;
/**
* 存储类
*/
private String storageClass;
/**
* 拥有者
*/
private Owner owner;
/**
* 对象类型:directory(目录)或file(文件)
*/
private String type;
/**
* 文件地址
*/
private String url;
/**
* 构造函数
*/
public MinioItem() {
}
/**
* 构造函数
*
* @param item 参数
*/
public MinioItem(Item item) {
this.objectName = item.objectName();
this.type = item.isDir() ? "directory" : "file";
this.etag = item.etag();
long sizeNum = item.size();
this.size = sizeNum > 0 ? FileUtils.formatFileSize(sizeNum) : "0";
this.storageClass = item.storageClass();
this.owner = item.owner();
this.lastModified = item.lastModified().toLocalDateTime();
}
}
@@ -0,0 +1,855 @@
// +======================================================================
// | 小蚂蚁云·企业数字化开发平台 [ 加速数字化转型,构建智能未来 ]
// +----------------------------------------------------------------------
// | 核心价值:赋能开发者 · 服务企业 · 共建生态
// +----------------------------------------------------------------------
// | Copyright (c) 2020-2026 小蚂蚁云团队 版权所有
// +----------------------------------------------------------------------
// | 官方平台: https://www.xiaomayicloud.com
// +======================================================================
// | 【知识产权声明】
// | 1. 权属声明:本软件是受《中华人民共和国著作权法》
// | 保护的专有财产,完整版权归小蚂蚁云团队所有
// | 2. 权利范围:所有知识产权(商标、专利、著作权、
// | 商业秘密等)均归小蚂蚁云团队所有,受法律保护
// | 3. 授权性质:用户仅可获得有限的、非独占的使用许可
// | 4. 禁止行为:未经书面授权,禁止对本软件本身
// | 申请任何知识产权
// | 5. 权利保留:未在本协议中明示授予的一切权利
// | 均由小蚂蚁云团队保留
// +======================================================================
// | 【授权状态说明】
// | 1. 未授权状态:用户未购买有效的商业许可证
// | 2. 商业授权:已购买正式商业许可证的用户
// +======================================================================
// | 【绝对禁止条款】
// | 无论授权状态如何,任何用户均严格禁止以下行为:
// | 1. 逆向工程:对软件进行反编译、反汇编、技术破解或任何形式的逆向分析
// | 2. 版权破坏:移除、修改、遮挡软件中的版权标识、许可控制或技术保护措施
// | 3. 非法传播:复制、分发、出租、出借、转售、再许可本软件或其许可权利
// | 4. 竞争性使用:利用本软件的代码、架构、设计开发直接竞争的产品或服务
// | 5. 侵权使用:将软件用于侵犯第三方知识产权或其他合法权益的用途
// +======================================================================
// | 【商业授权许可范围】
// | 购买有效商业许可证的用户,在遵守上述禁止条款的前提下,获得:
// | 1. 使用权利:在许可证约定的项目数量、开发者数量范围内使用本软件
// | 2. 技术支持:商业授权用户可以获取本地开发部署的技术支持服务
// | 3. 版本更新:在许可证有效期内获取软件更新、安全补丁和功能增强
// | 4. 商业部署:将基于本软件开发的应用程序用于商业运营和生产环境
// +======================================================================
// | 【许可证获取】
// | 1. 获取途径:仅通过小蚂蚁云官方渠道购买(官网、授权代理商),购买记录凭证
// | 2. 转让限制:许可证与购买主体绑定,未经书面同意不得转让
// | 3. 终止情形:许可证到期、违反协议、破产清算等情况下自动终止
// +======================================================================
// | 【合法使用要求】
// | 1. 仅限用于合法合规的软件研发
// | 2. 严禁用于任何违法、侵权或恶意行为
// | 3. 严禁违反我国法律法规和政策
// +======================================================================
// | 【免责声明】
// | 因使用本框架导致的以下情况,我们概不负责:
// | 1. 项目研发中的意外、疏忽、违约等风险
// | 2. 侵犯第三方知识产权或其他合法权益
// | 3. 任何直接、间接、附带或衍生一切损失
// | 4. 用户违规违法行为的一切法律后果
// +======================================================================
// | 【协议重要提示】
// | 1. 本声明是《小蚂蚁云最终用户许可协议》的摘要版本
// | 2. 下载、安装或使用本软件即表示您接受全部协议条款
// | 3. 我们保留单方面修改本声明的权利,修改后的版本在官网公布即生效
// | 4. 用户有义务定期查看最新版本,继续使用视为接受修改
// +======================================================================
// | 【侵权举报与合规】
// | 1. 知识产权侵权举报:请联系官方客服
// | 2. 许可证合规咨询:xiaomayicloud@163.com
// | 3. 违规使用将终止授权并追究责任
// | 4. 无条件配合司法机关调查取证
// | 5. 保留一切法律追诉权利
// | 6. 对有效举报和合规建议,我们将给予感谢和奖励
// +======================================================================
package com.xiaomayi.minio.utils;
import com.xiaomayi.core.utils.StringUtils;
import com.xiaomayi.minio.config.MinioProperties;
import com.xiaomayi.minio.model.MinioItem;
import io.minio.*;
import io.minio.http.Method;
import io.minio.messages.Bucket;
import io.minio.messages.Item;
import jakarta.servlet.http.HttpServletResponse;
import lombok.extern.slf4j.Slf4j;
import org.apache.tomcat.util.http.fileupload.IOUtils;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;
import org.springframework.web.multipart.MultipartFile;
import java.io.IOException;
import java.io.InputStream;
import java.io.UnsupportedEncodingException;
import java.net.URLDecoder;
import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.util.ArrayList;
import java.util.List;
import java.util.Optional;
/**
* <p>
* Minio工具类
* </p>
*
* @author 小蚂蚁云团队
* @since 2024-06-04
*/
@Slf4j
@Component
public class MinioUtils {
@Autowired
private MinioClient minioClient;
/**
* 检查存储桶是否存在
*
* @param bucketName 存储桶名
* @return 返回结果
*/
public boolean bucketExists(String bucketName) {
try {
return minioClient.bucketExists(
BucketExistsArgs.builder()
.bucket(bucketName)
.build()
);
} catch (Exception e) {
log.error("检查存储桶是否存在失败:" + e.getMessage());
return false;
}
}
/**
* 创建存储桶
*
* @param bucketName 存储桶名
* @return 返回结果
*/
public boolean createBucket(String bucketName) {
try {
if (!this.bucketExists(bucketName)) {
minioClient.makeBucket(
MakeBucketArgs.builder()
.bucket(bucketName)
.build()
);
}
return true;
} catch (Exception e) {
log.error("创建存储桶失败:" + e);
return false;
}
}
/**
* 根据存储桶名称获取信息
*
* @param bucketName 存储桶名
* @return 返回结果
*/
public Optional<Bucket> getBucket(String bucketName) {
try {
return minioClient.listBuckets()
.stream()
.filter(b -> b.name().equals(bucketName))
.findFirst();
} catch (Exception e) {
log.error("根据存储桶名称获取信息失败:" + e);
}
return null;
}
/**
* 获取全部存储桶
*
* @return 返回结果
*/
public List<Bucket> getBuckets() {
try {
return minioClient.listBuckets();
} catch (Exception e) {
log.error("获取全部存储桶失败:" + e);
return null;
}
}
/**
* 获取全部存储桶名称
*
* @return 返回结果
*/
public List<String> getAllBuckets() {
List<String> list = null;
try {
// 获取全部存储桶
List<Bucket> buckets = getBuckets();
list = new ArrayList<>(buckets.size());
// 遍历存储桶
for (Bucket bucket : buckets) {
// 存储桶名称加入列表
list.add(bucket.name());
}
} catch (Exception e) {
log.error("获取存储桶名异常:{}", e.getMessage());
}
return list;
}
/**
* 获取存储桶策略
*
* @param bucketName 存储桶名称
* @return 返回结果
*/
public String getBucketPolicy(String bucketName) {
try {
return minioClient
.getBucketPolicy(
GetBucketPolicyArgs
.builder()
.bucket(bucketName)
.build()
);
} catch (Exception e) {
log.error("获取桶策略异常:{}", e.getMessage());
}
return null;
}
/**
* 获取文件URL地址
*
* @param bucketName 存储桶名称
* @return 返回结果
*/
public String getPrefixUrl(String bucketName) {
return String.format("%s/%s/", MinioProperties.getEndpoint(), bucketName);
}
/**
* 删除存储桶
*
* @param bucketName 存储桶名
*/
public void removeBucket(String bucketName) {
try {
minioClient.removeBucket(
RemoveBucketArgs.builder()
.bucket(bucketName)
.build()
);
} catch (Exception e) {
log.error("删除存储桶异常:{}" + e.getMessage());
}
}
/**
* 获取文件流
*
* @param bucketName 存储桶名称
* @param objectName 文件名称
* @return 返回结果
*/
public InputStream getObject(String bucketName, String objectName) {
try {
return minioClient.getObject(
GetObjectArgs.builder()
.bucket(bucketName)
.object(objectName)
.build()
);
} catch (Exception e) {
log.error("获取文件失败:" + e);
}
return null;
}
/**
* 断点下载
*
* @param bucketName 存储桶
* @param objectName 文件名称
* @param offset 起始字节的位置
* @param length 要读取的长度
* @return 二进制流
*/
public InputStream getObject(String bucketName, String objectName, long offset, long length) {
try {
return minioClient.getObject(
GetObjectArgs.builder()
.bucket(bucketName)
.object(objectName)
.offset(offset)
.length(length)
.build());
} catch (Exception e) {
log.error("断点下载异常:{}", e.getMessage());
}
return null;
}
/**
* 获取存储桶所有文件
*
* @param bucketName 存储桶名称
* @return 返回结果
*/
public List<MinioItem> getObjects(String bucketName) {
return getObjects(bucketName, null, true);
}
/**
* 获取存储桶文件列表
*
* @param bucketName 存储桶名
* @param prefix 文件前缀
* @return 返回结果
*/
public List<MinioItem> getObjects(String bucketName, String prefix) {
return getObjects(bucketName, prefix, true);
}
/**
* 根据文件前缀查询文件
*
* @param bucketName 存储桶名
* @param prefix 文件前缀
* @param recursive 是否递归查询
* @return 返回结果
*/
public List<MinioItem> getObjects(String bucketName, String prefix, boolean recursive) {
try {
// 查询存储桶文件列表
Iterable<Result<Item>> results = listObjects(bucketName, prefix, recursive);
// 实例化文件列表
List<MinioItem> list = new ArrayList<MinioItem>();
// 遍历数据源
for (Result<Item> result : results) {
Item item = result.get();
MinioItem minioItem = new MinioItem(item);
minioItem.setUrl(getObjectURL(bucketName, item.objectName()));
list.add(minioItem);
}
// 返回结果
return list;
} catch (Exception e) {
log.error("获取所有文件失败:" + e);
}
return null;
}
/**
* 获取路径下文件列表
*
* @param bucketName 存储桶名称
* @param prefix 文件名称
* @param recursive 是否递归查找,false:模拟文件夹结构查找
* @return 二进制流
*/
public Iterable<Result<Item>> listObjects(String bucketName, String prefix, boolean recursive) {
return minioClient.listObjects(
ListObjectsArgs.builder()
.bucket(bucketName)
.prefix(prefix)
.recursive(recursive)
.build());
}
/**
* 获取文件信息
* 备注:如果抛出异常则说明文件不存在
*
* @param bucketName 存储桶名称
* @param objectName 文件名称
* @return 返回结果
*/
public StatObjectResponse getObjectInfo(String bucketName, String objectName) {
try {
return minioClient.statObject(
StatObjectArgs.builder()
.bucket(bucketName)
.object(objectName)
.build());
} catch (Exception e) {
log.error("获取文件异常:{}", e.getMessage());
}
return null;
}
/**
* 复制文件
*
* @param sourceBucket 原存储桶
* @param sourceObject 原文件名
* @param targetBucket 目标存储桶
* @param targetObject 目标文件名
*/
public String copyObject(String sourceBucket, String sourceObject, String targetBucket, String targetObject) {
try {
createBucket(targetBucket);
minioClient.copyObject(CopyObjectArgs.builder()
.bucket(targetBucket)
.object(targetObject)
.source(CopySource.builder()
.bucket(sourceBucket)
.object(sourceObject)
.build())
.build());
// 返回文件地址
return getPrefixUrl(targetBucket) + targetObject;
} catch (Exception e) {
log.error("复制文件异常:{}", e.getMessage());
}
return null;
}
/**
* 删除存储桶下所有文件
*
* @param bucketName 存储桶名称
*/
public void removeObject(String bucketName) {
// 存储桶名称判空
if (StringUtils.isBlank(bucketName)) {
log.error("存储桶名称不能为空");
return;
}
// 检查存储桶是否存在
boolean bucketExist = bucketExists(bucketName);
if (!bucketExist) {
log.error("存储桶不存在");
return;
}
try {
minioClient.deleteBucketEncryption(DeleteBucketEncryptionArgs.builder().bucket(bucketName).build());
} catch (Exception e) {
log.error("删除桶文件异常:{}" + e.getMessage());
}
}
/**
* 删除文件
*
* @param bucketName 存储桶名称
* @param objectName 文件名称
*/
public void removeObject(String bucketName, String objectName) {
// 文件名判空
if (StringUtils.isBlank(objectName)) {
log.error("文件名称不能为空");
return;
}
// 检查存储桶是否存在
boolean bucketExist = bucketExists(bucketName);
if (!bucketExist) {
log.error("存储桶不存在");
return;
}
try {
minioClient.removeObject(
RemoveObjectArgs.builder()
.bucket(bucketName)
.object(objectName)
.build()
);
} catch (Exception e) {
log.error("删除文件失败:" + e.getMessage());
}
}
/**
* 批量删除文件
*
* @param bucketName 存储桶名称
* @param objects 文件列表
*/
public void removeObjects(String bucketName, List<String> objects) {
objects.forEach(item -> {
removeObject(bucketName, item);
});
}
/**
* 获取⽂件外链
*
* @param bucketName 存储桶名称
* @param objectName 文件名
* @return 返回结果
*/
public String getObjectURL(String bucketName, String objectName) {
try {
return minioClient.getPresignedObjectUrl(
GetPresignedObjectUrlArgs.builder()
.method(Method.GET)
.bucket(bucketName)
.object(objectName)
.build());
} catch (Exception e) {
log.error("获取文件地址异常:{}", e.getMessage());
}
return null;
}
/**
* 获取⽂件外链
*
* @param bucketName 存储桶名称
* @param objectName 文件名称
* @param expire 过期时间(秒) 最大为7天 超过7天则默认最大值
* @return 返回结果
*/
public String getObjectURL(String bucketName, String objectName, Integer expire) {
try {
return minioClient.getPresignedObjectUrl(
GetPresignedObjectUrlArgs.builder()
.method(Method.GET)
.bucket(bucketName)
.object(objectName)
// 默认:一天过期时间
// .expiry(1, TimeUnit.DAYS)
.expiry(expire)
.build());
} catch (Exception e) {
log.error("获取文件地址异常:{}", e.getMessage());
}
return null;
}
/**
* 上传本地文件
*
* @param file 文件
* @param bucketName 存储桶名称
* @param objectName 文件名称
* @param contentType 类型
* @return 返回结果
*/
public String uploadFile(MultipartFile file, String bucketName, String objectName, String contentType) {
try {
// 获取文件流
InputStream inputStream = file.getInputStream();
// 上传文件
minioClient.putObject(
PutObjectArgs.builder()
.bucket(bucketName)
.object(objectName)
.contentType(contentType)
.stream(inputStream, inputStream.available(), -1)
.build());
// 返回文件地址
return getPrefixUrl(bucketName) + objectName;
} catch (Exception e) {
log.error("上传文件异常:{}", e.getMessage());
}
return null;
}
/**
* 上传本地文件
*
* @param bucketName 存储桶名称
* @param objectName 文件名称
* @param filePath 文件路径
* @return 返回结果
*/
public String uploadFile(String bucketName, String objectName, String filePath) {
try {
minioClient.uploadObject(
UploadObjectArgs.builder()
.bucket(bucketName)
.object(objectName)
.filename(filePath)
// 设置文件类型
// .contentType("image/png")
.build());
// 返回文件地址
return getPrefixUrl(bucketName) + objectName;
} catch (Exception e) {
log.error("上传文件失败:{}", e.getMessage());
}
return null;
}
/**
* 通过流上传文件
*
* @param inputStream 文件流
* @param bucketName 存储桶
* @param objectName 文件对象
*/
public String uploadFile(InputStream inputStream, String bucketName, String objectName) {
try {
minioClient.putObject(
PutObjectArgs.builder()
.bucket(bucketName)
.object(objectName)
.stream(inputStream, inputStream.available(), -1)
.build());
// 返回文件地址
return getPrefixUrl(bucketName) + objectName;
} catch (Exception e) {
log.error("上传文件失败:{}", e.getMessage());
}
return null;
}
/**
* 上传文件
*
* @param inputStream 文件流
* @param bucketName 存储桶名称
* @param objectName 文件名称
* @param contentType 类型
*/
public String uploadFile(InputStream inputStream, String bucketName, String objectName, String contentType) {
try {
// 上传文件至存储桶,文件名称相同会覆盖
minioClient.putObject(
PutObjectArgs.builder()
.bucket(bucketName)
.object(objectName)
.stream(inputStream, inputStream.available(), -1)
.contentType(contentType)
.build()
);
// 返回文件地址
return getPrefixUrl(bucketName) + objectName;
} catch (Exception e) {
log.error("上传文件失败:" + e);
}
return null;
}
/**
* 上传文件
*
* @param multipartFile 文件
* @param bucketName 存储桶名称
* @return 返回结果
*/
public List<String> uploadFile(MultipartFile[] multipartFile, String bucketName) {
List<String> names = new ArrayList<>(multipartFile.length);
for (MultipartFile file : multipartFile) {
String fileName = file.getOriginalFilename();
String[] split = fileName.split("\\.");
if (split.length > 1) {
fileName = split[0] + "_" + System.currentTimeMillis() + "." + split[1];
} else {
fileName = fileName + System.currentTimeMillis();
}
InputStream in = null;
try {
in = file.getInputStream();
minioClient.putObject(PutObjectArgs.builder()
.bucket(bucketName)
.object(fileName)
.stream(in, in.available(), -1)
.contentType(file.getContentType())
.build()
);
} catch (Exception e) {
e.printStackTrace();
} finally {
if (in != null) {
try {
in.close();
} catch (IOException e) {
e.printStackTrace();
}
}
}
names.add(fileName);
}
return names;
}
/**
* 上传文件
*
* @param file 文件
*/
public String uploadFile(MultipartFile file) {
return uploadFile(file, MinioProperties.getBucketName(), null);
}
/**
* 上传文件
*
* @param file 文件
* @param bucketName 存储桶名称
*/
public String uploadFile(MultipartFile file, String bucketName) {
return uploadFile(file, bucketName, null);
}
/**
* 上传文件
*
* @param file 文件
* @param bucketName 存储桶名称
* @param objectName 文件名称
* @return 返回结果
*/
public String uploadFile(MultipartFile file, String bucketName, String objectName) {
try {
// 判断文件是否为空
if (null == file || 0 == file.getSize()) {
return null;
}
// 判断存储桶是否存在 不存在则创建
if (!createBucket(bucketName)) {
return null;
}
// 文件名为空则取原始文件名
if (StringUtils.isEmpty(objectName)) {
// 获取原始文件名称
objectName = file.getOriginalFilename();
}
// 上传文件至存储桶,文件名称相同会覆盖
minioClient.putObject(
PutObjectArgs.builder()
.bucket(bucketName)
.object(objectName)
.stream(file.getInputStream(), file.getSize(), -1)
.contentType(file.getContentType())
.build());
// 返回文件地址
return getPrefixUrl(bucketName) + objectName;
} catch (Exception e) {
log.error("上传文件异常:{}", e.getMessage());
}
return null;
}
/**
* 文件上传/文件分块上传
*
* @param bucketName 桶名称
* @param objectName 对象名称
* @param sliceIndex 分片索引
* @param file 文件
*/
public boolean uploadFile(String bucketName, String objectName, Integer sliceIndex, MultipartFile file) {
try {
if (sliceIndex != null) {
objectName = objectName.concat("/").concat(Integer.toString(sliceIndex));
}
// 写入文件
minioClient.putObject(PutObjectArgs.builder()
.bucket(bucketName)
.object(objectName)
.stream(file.getInputStream(), file.getSize(), -1)
.contentType(file.getContentType())
.build());
log.debug("上传到minio文件|uploadFile|参数:bucketName:{},objectName:{},sliceIndex:{}"
, bucketName, objectName, sliceIndex);
return true;
} catch (Exception e) {
log.error("文件上传到Minio异常|参数:bucketName:{},objectName:{},sliceIndex:{}|异常:{}", bucketName, objectName, sliceIndex, e);
return false;
}
}
/**
* 文件合并
*
* @param bucketName 桶名称
* @param objectName 对象名称
* @param sourceObjectList 源文件分片数据
*/
public boolean composeFile(String bucketName, String objectName, List<ComposeSource> sourceObjectList) {
// 合并操作
try {
ObjectWriteResponse response = minioClient.composeObject(
ComposeObjectArgs.builder()
.bucket(bucketName)
.object(objectName)
.sources(sourceObjectList)
.build());
return true;
} catch (Exception e) {
log.error("Minio文件按合并异常!|参数:bucketName:{},objectName:{}|异常:{}", bucketName, objectName, e);
return false;
}
}
/**
* 下载文件
*
* @param bucketName 存储桶名称
* @param objectName 文件名称
* @return 返回结果
*/
public InputStream download(String bucketName, String objectName) {
try {
return minioClient.getObject(
GetObjectArgs.builder()
.bucket(bucketName)
.object(objectName)
.build());
} catch (Exception e) {
log.error("下载文件异常:{}", e.getMessage());
}
return null;
}
/**
* 文件下载
*
* @param response 网络响应
* @param bucketName 存储桶名称
* @param objectName 文件名称
*/
public void download(HttpServletResponse response, String bucketName, String objectName) {
InputStream inputStream = null;
try {
StatObjectResponse stat = minioClient.statObject(
StatObjectArgs.builder()
.bucket(bucketName)
.object(objectName)
.build()
);
inputStream = this.getObject(bucketName, objectName);
response.setContentType(stat.contentType());
response.setHeader("Content-Disposition", "attachment;filename=" + URLEncoder.encode(objectName, String.valueOf(StandardCharsets.UTF_8)));
IOUtils.copy(inputStream, response.getOutputStream());
} catch (Exception e) {
log.error("下载文件失败:" + e.getMessage());
} finally {
if (inputStream != null) {
try {
inputStream.close();
} catch (IOException e) {
e.printStackTrace();
}
}
}
}
/**
* 将URLDecoder编码转成UTF8
*
* @param url URL地址
* @return 返回结果
*/
public static String getUtf8ByURLDecoder(String url) {
try {
String result = url.replaceAll("%(?![0-9a-fA-F]{2})", "%25");
return URLDecoder.decode(result, "UTF-8");
} catch (UnsupportedEncodingException e) {
log.error("编码转换异常:{}", e.getMessage());
}
return null;
}
}