djangoadmin/djangoadmin-web
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

签入版本

Browse Source
This commit is contained in:
gitadmin
2026-09-10 21:41:50 +08:00
commit 717116a605
2693 changed files with 355025 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
xiaomayi-common/xiaomayi-file/src/main/java/com/xiaomayi/file/annotation/FileLog.java
+114
View File
@@ -0,0 +1,114 @@
// +======================================================================
// | 小蚂蚁云·企业数字化开发平台 [ 加速数字化转型，构建智能未来 ]
// +----------------------------------------------------------------------
// | 核心价值：赋能开发者 · 服务企业 · 共建生态
// +----------------------------------------------------------------------
// | 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.file.annotation;
import com.xiaomayi.file.enums.FileSource;
import com.xiaomayi.file.enums.FileType;
import java.lang.annotation.*;
/**
* <p>
* 文件日志注解
* </p>
*
* @author 小蚂蚁云团队
* @since 2024-06-16
*/
@Target({ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
public @interface FileLog {
/**
* 日志标题
*
* @return 返回结果
*/
String title() default "未知";
/**
* 文件类型
*
* @return 返回结果
*/
FileType type() default FileType.OTHER;
/**
* 文件来源
*
* @return 返回结果
*/
FileSource source() default FileSource.SYSTEM;
}
xiaomayi-common/xiaomayi-file/src/main/java/com/xiaomayi/file/annotation/FileValidation.java
+129
View File
@@ -0,0 +1,129 @@
// +======================================================================
// | 小蚂蚁云·企业数字化开发平台 [ 加速数字化转型，构建智能未来 ]
// +----------------------------------------------------------------------
// | 核心价值：赋能开发者 · 服务企业 · 共建生态
// +----------------------------------------------------------------------
// | 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.file.annotation;
import com.xiaomayi.file.validation.FileValidator;
import jakarta.validation.Constraint;
import jakarta.validation.Payload;
import java.lang.annotation.*;
/**
* <p>
* 文件检查注解
* </p>
*
* @author 小蚂蚁云团队
* @since 2024-06-16
*/
@Documented
@Constraint(validatedBy = FileValidator.class)
@Target({ElementType.METHOD, ElementType.FIELD, ElementType.PARAMETER})
@Retention(RetentionPolicy.RUNTIME)
public @interface FileValidation {
/**
* 文件错误描述
*
* @return 返回结果
*/
String message() default "File validation failed";
/**
* 分组
*
* @return 返回结果
*/
Class<?>[] groups() default {};
/**
* 有效载荷
*
* @return 返回结果
*/
Class<? extends Payload>[] payload() default {};
/**
* 默认文件大小为1MB
*
* @return 返回结果
*/
long size() default 5 * 1024 * 1024;
/**
* 默认支持的文件后缀
*
* @return 返回结果
*/
String[] allowed() default {"jpg", "png", "jpeg", "gif", "bmp", "doc", "docx", "xls", "xlsx", "ppt", "pptx", "pdf", "txt", "html", "rar", "zip", "gz", "bz2"};
}
xiaomayi-common/xiaomayi-file/src/main/java/com/xiaomayi/file/annotation/FilesValidation.java
+136
View File
@@ -0,0 +1,136 @@
// +======================================================================
// | 小蚂蚁云·企业数字化开发平台 [ 加速数字化转型，构建智能未来 ]
// +----------------------------------------------------------------------
// | 核心价值：赋能开发者 · 服务企业 · 共建生态
// +----------------------------------------------------------------------
// | 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.file.annotation;
import com.xiaomayi.file.validation.FilesValidator;
import jakarta.validation.Constraint;
import jakarta.validation.Payload;
import java.lang.annotation.*;
/**
* <p>
* 文件检查注解
* </p>
*
* @author 小蚂蚁云团队
* @since 2024-06-16
*/
@Documented
@Constraint(validatedBy = FilesValidator.class)
@Target({ElementType.METHOD, ElementType.FIELD, ElementType.PARAMETER})
@Retention(RetentionPolicy.RUNTIME)
public @interface FilesValidation {
/**
* 文件错误描述
*
* @return 返回结果
*/
String message() default "File validation failed";
/**
* 分组
*
* @return 返回结果
*/
Class<?>[] groups() default {};
/**
* 有效载荷
*
* @return 返回结果
*/
Class<? extends Payload>[] payload() default {};
/**
* 默认文件大小为1MB
*
* @return 返回结果
*/
long size() default 5 * 1024 * 1024;
/**
* 设置文件总的大小10M
*
* @return 返回结果
*/
long totalSize() default 10 * 1024 * 1024;
/**
* 默认支持的文件后缀
*
* @return 返回结果
*/
String[] allowed() default {"jpg", "png", "jpeg", "gif", "bmp", "doc", "docx", "xls", "xlsx", "ppt", "pptx", "pdf", "txt", "html", "rar", "zip", "gz", "bz2"};
}
xiaomayi-common/xiaomayi-file/src/main/java/com/xiaomayi/file/aspect/FileAspect.java
+350
View File
@@ -0,0 +1,350 @@
// +======================================================================
// | 小蚂蚁云·企业数字化开发平台 [ 加速数字化转型，构建智能未来 ]
// +----------------------------------------------------------------------
// | 核心价值：赋能开发者 · 服务企业 · 共建生态
// +----------------------------------------------------------------------
// | 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.file.aspect;
import com.alibaba.fastjson2.JSON;
import com.xiaomayi.core.enums.HttpMethod;
import com.xiaomayi.core.utils.R;
import com.xiaomayi.core.utils.ServletUtils;
import com.xiaomayi.core.utils.StringUtils;
import com.xiaomayi.file.annotation.FileLog;
import com.xiaomayi.file.dto.UploadFileDTO;
import com.xiaomayi.file.vo.UploadFileLogVO;
import com.xiaomayi.file.vo.UploadFileVO;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import lombok.extern.slf4j.Slf4j;
import org.aspectj.lang.JoinPoint;
import org.aspectj.lang.annotation.*;
import org.springframework.core.NamedThreadLocal;
import org.springframework.stereotype.Component;
import org.springframework.validation.BindingResult;
import org.springframework.web.multipart.MultipartFile;
import java.util.ArrayList;
import java.util.Collection;
import java.util.List;
import java.util.Map;
/**
* <p>
* 文件上传AOP切面
* </p>
*
* @author 小蚂蚁云团队
* @since 2024-06-16
*/
@Slf4j
@Aspect
@Component
public abstract class FileAspect {
/**
* 计算耗时线程
*/
ThreadLocal<Long> TIME_THREADLOCAL = new NamedThreadLocal<Long>("FileTime");
/**
* 扫描切入点注解
*/
@Pointcut("@annotation(com.xiaomayi.file.annotation.FileLog)")
public void doPointCut() {
}
/**
* 处理请求前执行
*
* @param fileLog 文件日志
*/
@Before("doPointCut() && @annotation(fileLog)")
public void doBefore(FileLog fileLog) {
log.info("发送文件AOP日志处理开始");
// 设置请求开始时间
TIME_THREADLOCAL.set(System.currentTimeMillis());
}
/**
* 处理完请求后执行
*/
@After("doPointCut()")
public void doAfter() {
log.info("发送文件AOP日志处理结束");
}
/**
* 处理完请求后执行
*
* @param point 切点
* @param fileLog 文件日志
* @param jsonResult 响应结果
*/
@AfterReturning(pointcut = "@annotation(fileLog)", returning = "jsonResult")
public void doAfterReturning(JoinPoint point, FileLog fileLog, Object jsonResult) {
log.info("发送文件AOP日志结果已响应");
smsLog(point, fileLog, jsonResult, null);
}
/**
* 拦截异常处理
*
* @param point 切点
* @param fileLog 文件日志
* @param exception 异常处理
*/
@AfterThrowing(value = "@annotation(fileLog)", throwing = "exception")
public void doAfterThrowing(JoinPoint point, FileLog fileLog, Exception exception) {
log.info("发送文件AOP日志处理异常");
smsLog(point, fileLog, null, exception);
}
/**
* 保存文件发送日志
*
* @param point 切点
* @param annotation 日志注解
* @param jsonResult 响应结果
* @param exception 异常处理
*/
private void smsLog(JoinPoint point, FileLog annotation, Object jsonResult, Exception exception) {
// 获取日志标题
String title = annotation.title();
// 实例化文件VO
UploadFileLogVO uploadFileLogVO = new UploadFileLogVO();
// 日志标题
uploadFileLogVO.setTitle(title);
// 日志类型
uploadFileLogVO.setType(annotation.type().ordinal());
// 处理设置注解上的参数
setRequestParam(point, uploadFileLogVO, jsonResult);
// 设置请求耗时
uploadFileLogVO.setConsumeTime(System.currentTimeMillis() - TIME_THREADLOCAL.get());
// 文件日志状态
if (exception != null) {
// 异常处理
uploadFileLogVO.setStatus(1);
uploadFileLogVO.setError(StringUtils.substring(exception.getMessage(), 0, 2000));
} else {
uploadFileLogVO.setStatus(0);
uploadFileLogVO.setError(null);
}
// 响应处理结果
try {
// 实例化文件VO列表
List<UploadFileVO> uploadFileVOList = new ArrayList<>();
// 文件信息
String result = uploadFileLogVO.getResult();
if (StringUtils.isNotEmpty(result)) {
R fileRes = JSON.parseObject(result, R.class);
if (StringUtils.isNotNull(fileRes.getData())) {
if (fileRes.getData() instanceof List<?>) {
uploadFileVOList = JSON.parseArray(fileRes.getData().toString(), UploadFileVO.class);
} else {
UploadFileVO uploadFileVO = JSON.parseObject(fileRes.getData().toString(), UploadFileVO.class);
// 加入列表
uploadFileVOList.add(uploadFileVO);
}
}
}
// 设置本地上传文件列表数据
uploadFileLogVO.setUploadFileVOList(uploadFileVOList);
} catch (Exception e) {
log.error("文件信息解析失败：{}", e.getMessage());
}
// 请求参数处理
try {
UploadFileDTO uploadFileDTO = JSON.parseObject(uploadFileLogVO.getParam(), UploadFileDTO.class);
if (StringUtils.isNotNull(uploadFileDTO)) {
// 业务类型
uploadFileLogVO.setBizType(uploadFileDTO.getBizId());
// 业务ID
uploadFileLogVO.setBizId(uploadFileDTO.getBizId());
// 业务内容
uploadFileLogVO.setBizContent(uploadFileDTO.getBizContent());
}
} catch (Exception e) {
log.error("文件参数解释失败：{}", e.getMessage());
}
// 调用抽象类保存请求地址
if (saveFileLog(uploadFileLogVO)) {
log.info("发送文件AOP日志已存储");
}
}
/**
* 设置请求参数
*
* @param point 切点
* @param smsLogVO 文件日志VO
* @param jsonResult 返回结果
*/
private void setRequestParam(JoinPoint point, UploadFileLogVO smsLogVO, Object jsonResult) {
// 获取所有请求参数
Map<?, ?> paramsMap = ServletUtils.getParamMap(ServletUtils.getRequest());
// 获取请求方式
String requestMethod = ServletUtils.getRequest().getMethod();
// 请求参数判空
if (StringUtils.isEmpty(paramsMap) && (HttpMethod.PUT.name().equals(requestMethod) || HttpMethod.POST.name().equals(requestMethod))) {
// 格式化请求参数
String params = getJSONParam(point.getArgs());
// 设置文件日志参数
smsLogVO.setParam(StringUtils.substring(params, 0, 2000));
} else {
// 设置文件日志参数
smsLogVO.setParam(StringUtils.substring(JSON.toJSONString(paramsMap), 0, 2000));
}
// 设置网络响应
if (StringUtils.isNotNull(jsonResult)) {
smsLogVO.setResult(StringUtils.substring(JSON.toJSONString(jsonResult), 0, 2000));
}
}
/**
* 请求参数转JSON字符串
*
* @param objects 参数对象
* @return 返回结果
*/
private String getJSONParam(Object[] objects) {
// 参数对象判空
if (StringUtils.isEmpty(objects)) {
return "";
}
// 实例化参数列表
List<String> paramList = new ArrayList<>();
// 遍历属性
for (Object obj : objects) {
// 对象判空
if (StringUtils.isNull(obj) || isExcludeObject(obj)) {
continue;
}
// 对象转JSON，排除敏感属性字段
String jsonObj = JSON.toJSONString(obj);
if (StringUtils.isEmpty(jsonObj)) {
continue;
}
// 加入列表
paramList.add(jsonObj);
}
// 参数列表转拼接字符串
String params = StringUtils.join(paramList.toArray(), " ");
// 返回结果
return params;
}
/**
* 判断是否需要排除的对象
*
* @param obj 对象
* @return 返回结果
*/
@SuppressWarnings("rawtypes")
public boolean isExcludeObject(final Object obj) {
// 获取类
Class<?> clazz = obj.getClass();
// 判断是否数组
if (clazz.isArray()) {
return clazz.getComponentType().isAssignableFrom(MultipartFile.class);
}
// 判断是否集合
else if (Collection.class.isAssignableFrom(clazz)) {
Collection collection = (Collection) obj;
for (Object value : collection) {
return value instanceof MultipartFile;
}
}
// 判断是否Map
else if (Map.class.isAssignableFrom(clazz)) {
Map map = (Map) obj;
for (Object value : map.entrySet()) {
Map.Entry entry = (Map.Entry) value;
return entry.getValue() instanceof MultipartFile;
}
}
// 返回结果
return obj instanceof MultipartFile
|| obj instanceof HttpServletRequest
|| obj instanceof HttpServletResponse
|| obj instanceof BindingResult;
}
/**
* 文件日志抽象类
*
* @param uploadFileLogVO 文件日志VO
* @return 返回结果
*/
public abstract boolean saveFileLog(UploadFileLogVO uploadFileLogVO);
}
xiaomayi-common/xiaomayi-file/src/main/java/com/xiaomayi/file/dto/UploadFileDTO.java
+112
View File
@@ -0,0 +1,112 @@
// +======================================================================
// | 小蚂蚁云·企业数字化开发平台 [ 加速数字化转型，构建智能未来 ]
// +----------------------------------------------------------------------
// | 核心价值：赋能开发者 · 服务企业 · 共建生态
// +----------------------------------------------------------------------
// | 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.file.dto;
import jakarta.validation.constraints.NotBlank;
import lombok.Data;
import org.springframework.web.multipart.MultipartFile;
/**
* <p>
* 文件上传DTO
* </p>
*
* @author 小蚂蚁云团队
* @since 2024-06-16
*/
@Data
public class UploadFileDTO {
/**
* 存储目录
*/
@NotBlank(message = "存储目录不能为空")
private String name;
private MultipartFile file;
/**
* 业务类型：1-订单 2-其他
*/
private Integer bizType;
/**
* 业务ID
*/
private Integer bizId;
/**
* 业务内容
*/
private String bizContent;
}
xiaomayi-common/xiaomayi-file/src/main/java/com/xiaomayi/file/enums/FileSource.java
+104
View File
@@ -0,0 +1,104 @@
// +======================================================================
// | 小蚂蚁云·企业数字化开发平台 [ 加速数字化转型，构建智能未来 ]
// +----------------------------------------------------------------------
// | 核心价值：赋能开发者 · 服务企业 · 共建生态
// +----------------------------------------------------------------------
// | 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.file.enums;
/**
* <p>
* 文件来源枚举
* </p>
*
* @author 小蚂蚁云团队
* @since 2024-06-16
*/
public enum FileSource {
/**
* 后台系统
*/
SYSTEM,
/**
* 手机站
*/
WAP,
/**
* APP、小程序
*/
APP,
/**
* 其它
*/
OTHER,
}
xiaomayi-common/xiaomayi-file/src/main/java/com/xiaomayi/file/enums/FileType.java
+99
View File
@@ -0,0 +1,99 @@
// +======================================================================
// | 小蚂蚁云·企业数字化开发平台 [ 加速数字化转型，构建智能未来 ]
// +----------------------------------------------------------------------
// | 核心价值：赋能开发者 · 服务企业 · 共建生态
// +----------------------------------------------------------------------
// | 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.file.enums;
/**
* <p>
* 文件类型枚举
* </p>
*
* @author 小蚂蚁云团队
* @since 2024-06-16
*/
public enum FileType {
/**
* 单个文件上传
*/
FILE,
/**
* 批量上传
*/
FILES,
/**
* 其他
*/
OTHER
}
xiaomayi-common/xiaomayi-file/src/main/java/com/xiaomayi/file/utils/UploadUtils.java
+200
View File
@@ -0,0 +1,200 @@
// +======================================================================
// | 小蚂蚁云·企业数字化开发平台 [ 加速数字化转型，构建智能未来 ]
// +----------------------------------------------------------------------
// | 核心价值：赋能开发者 · 服务企业 · 共建生态
// +----------------------------------------------------------------------
// | 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.file.utils;
import com.xiaomayi.core.config.AppConfig;
import com.xiaomayi.core.constant.AppConstant;
import com.xiaomayi.core.exception.BizException;
import com.xiaomayi.core.utils.CommonUtils;
import com.xiaomayi.core.utils.DateUtils;
import com.xiaomayi.core.utils.StringUtils;
import com.xiaomayi.file.vo.UploadFileVO;
import lombok.extern.slf4j.Slf4j;
import org.apache.commons.io.FilenameUtils;
import org.springframework.stereotype.Component;
import org.springframework.web.multipart.MultipartFile;
import java.io.File;
import java.util.*;
/**
* <p>
* 文件上传工具类
* </p>
*
* @author 小蚂蚁云团队
* @since 2024-01-23
*/
@Slf4j
@Component
public class UploadUtils {
/**
* 上传文件
*
* @param multipartFile 文件
* @param name 存储目录
* @return 返回结果
*/
public UploadFileVO uploadFile(MultipartFile multipartFile, String name) {
try {
log.info(" >>> 文件上传入口... <<< ");
// 上传文件判空
if (multipartFile == null) {
throw new BizException();
}
// 存储目录
String appPath = AppConfig.getProfile();
// 创建文件存放目录
String savePath = name + "/" + DateUtils.dateTime();
// 创建上传文件目录
File file = new File(appPath + savePath);
if (!file.mkdir()) {
file.mkdirs();
}
// 文件原始名称
String originalName = multipartFile.getOriginalFilename();
// 文件类型
String fileType = multipartFile.getContentType();
// 文件大小
long fileSize = multipartFile.getSize();
// 获取文件后缀
String fileExtension = FilenameUtils.getExtension(originalName);
// 自定义上传文件名
String fileName = System.currentTimeMillis() + new Random().nextInt(1000) + "." + fileExtension;
// 目标存储路径
String filePath = savePath + "/" + fileName;
// 保存到一个目标文件中
multipartFile.transferTo(new File(appPath + filePath));
// 文件地址前缀替换,此处加上资源放行前缀：/file,便于静态文件映射访问
filePath = "/" + filePath.replaceAll("\\\\+", "/");
// 实例化上传文件VO
UploadFileVO uploadFileVO = new UploadFileVO();
// 文件原始名称
uploadFileVO.setOriginalName(originalName);
// 文件后缀
uploadFileVO.setFileExtension(fileExtension);
// 文件类型
uploadFileVO.setFileType(fileType);
// 文件大小
uploadFileVO.setFileSize(fileSize);
// 文件名称
uploadFileVO.setFileName(fileName);
// 文件路径
uploadFileVO.setFilePath(filePath);
// 文件地址
uploadFileVO.setFileUrl(CommonUtils.getFileURL(filePath));
log.info(" >>> 文件上传结束... <<< ");
return uploadFileVO;
} catch (Exception e) {
log.error("文件上传异常：{}", e.getMessage());
}
return null;
}
/**
* 批量上传文件
*
* @param multipartFiles 文件对象列表
* @param name 存储目录
* @return 返回结果
*/
public List<UploadFileVO> uploadFiles(MultipartFile[] multipartFiles, String name) {
try {
// 参数判空
if (StringUtils.isEmpty(multipartFiles)) {
throw new BizException();
}
// 实例化上传文件VO列表
List<UploadFileVO> list = new ArrayList<>();
// 遍历文件上传对象
for (MultipartFile file : multipartFiles) {
// 调用文件上传公共方法
UploadFileVO uploadFileVO = uploadFile(file, name);
if (StringUtils.isEmpty(uploadFileVO)) {
continue;
}
// 加入列表
list.add(uploadFileVO);
}
return list;
} catch (Exception e) {
log.error("文件上传异常：{}", e.getMessage());
}
return null;
}
}
xiaomayi-common/xiaomayi-file/src/main/java/com/xiaomayi/file/validation/FileValidator.java
+142
View File
@@ -0,0 +1,142 @@
// +======================================================================
// | 小蚂蚁云·企业数字化开发平台 [ 加速数字化转型，构建智能未来 ]
// +----------------------------------------------------------------------
// | 核心价值：赋能开发者 · 服务企业 · 共建生态
// +----------------------------------------------------------------------
// | 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.file.validation;
import cn.hutool.core.util.StrUtil;
import com.xiaomayi.core.exception.BizException;
import com.xiaomayi.core.utils.FileUtils;
import com.xiaomayi.core.utils.StringUtils;
import com.xiaomayi.file.annotation.FileValidation;
import jakarta.validation.ConstraintValidator;
import jakarta.validation.ConstraintValidatorContext;
import org.springframework.web.multipart.MultipartFile;
import java.util.Arrays;
/**
* <p>
* 文件验证器
* </p>
*
* @author 小蚂蚁云团队
* @since 2024-06-16
*/
public class FileValidator implements ConstraintValidator<FileValidation, MultipartFile> {
/**
* 文件检查注解
*/
private FileValidation fileValidation;
/**
* 重写初始化方法
*
* @param fileValidation 文件检查注解
*/
@Override
public void initialize(FileValidation fileValidation) {
this.fileValidation = fileValidation;
}
/**
* 检查文件是否验证通过
*
* @param file 文件对象
* @param context 验证内容
* @return 返回结果
*/
@Override
public boolean isValid(MultipartFile file, ConstraintValidatorContext context) {
// 文件为空直接返回
if (file == null) {
throw new BizException("上传文件不能为空");
}
// 检查文件大小
long fileSize = fileValidation.size();
if (fileSize != -1 && file.getSize() > fileSize) {
throw new BizException(StrUtil.format("文件大小不得超过最大值：{}", FileUtils.formatFileSize(fileSize)));
}
// 文件名称
String fileName = file.getOriginalFilename();
// 文件后缀
String[] fileExt = fileValidation.allowed();
// 文件后缀名
assert fileName != null;
String extName = fileName.substring(fileName.lastIndexOf('.') + 1);
if (!Arrays.asList(fileExt).contains(extName.toLowerCase())) {
throw new BizException(StrUtil.format("文件上传后缀仅允许：{}", StringUtils.join(fileValidation.allowed(), ",")));
}
return true;
}
}
xiaomayi-common/xiaomayi-file/src/main/java/com/xiaomayi/file/validation/FilesValidator.java
+155
View File
@@ -0,0 +1,155 @@
// +======================================================================
// | 小蚂蚁云·企业数字化开发平台 [ 加速数字化转型，构建智能未来 ]
// +----------------------------------------------------------------------
// | 核心价值：赋能开发者 · 服务企业 · 共建生态
// +----------------------------------------------------------------------
// | 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.file.validation;
import cn.hutool.core.util.StrUtil;
import com.xiaomayi.core.exception.BizException;
import com.xiaomayi.core.utils.FileUtils;
import com.xiaomayi.core.utils.StringUtils;
import com.xiaomayi.file.annotation.FilesValidation;
import jakarta.validation.ConstraintValidator;
import jakarta.validation.ConstraintValidatorContext;
import org.springframework.web.multipart.MultipartFile;
import java.util.Arrays;
/**
* <p>
* 文件验证器
* </p>
*
* @author 小蚂蚁云团队
* @since 2024-06-16
*/
public class FilesValidator implements ConstraintValidator<FilesValidation, MultipartFile[]> {
/**
* 文件检查注解
*/
private FilesValidation fileValidation;
/**
* 重写初始化方法
*
* @param filesValidation 文件检查注解
*/
@Override
public void initialize(FilesValidation filesValidation) {
this.fileValidation = filesValidation;
}
/**
* 检查文件是否验证通过
*
* @param files 文件对象
* @param context 验证内容
* @return 返回结果
*/
@Override
public boolean isValid(MultipartFile[] files, ConstraintValidatorContext context) {
// 上传文件判空
if (StringUtils.isEmpty(files)) {
throw new BizException("上传文件不能为空");
}
// 文件总的大小
long totalSize = 0;
// 遍历上传文件
for (MultipartFile file : files) {
// 检查单个文件大小
long fileSize = fileValidation.size();
if (fileSize != -1 && file.getSize() > fileSize) {
throw new BizException(StrUtil.format("单个文件大小不得超过最大值：{}", FileUtils.formatFileSize(fileSize)));
}
// 文件大小计数器+
totalSize += fileSize;
// 文件名称
String fileName = file.getOriginalFilename();
// 文件后缀
String[] fileExt = fileValidation.allowed();
// 文件后缀名
assert fileName != null;
String extName = fileName.substring(fileName.lastIndexOf('.') + 1);
if (!Arrays.asList(fileExt).contains(extName.toLowerCase())) {
throw new BizException(StrUtil.format("文件上传后缀仅允许：{}", StringUtils.join(fileValidation.allowed(), ",")));
}
}
// 文件大小总值验证
long fileTotalSize = fileValidation.totalSize();
if (totalSize > fileTotalSize) {
throw new BizException(StrUtil.format("文件累计大小不得超过最大值：{}", FileUtils.formatFileSize(fileTotalSize)));
}
return true;
}
}
xiaomayi-common/xiaomayi-file/src/main/java/com/xiaomayi/file/vo/UploadFileLogVO.java
+150
View File
@@ -0,0 +1,150 @@
// +======================================================================
// | 小蚂蚁云·企业数字化开发平台 [ 加速数字化转型，构建智能未来 ]
// +----------------------------------------------------------------------
// | 核心价值：赋能开发者 · 服务企业 · 共建生态
// +----------------------------------------------------------------------
// | 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.file.vo;
import lombok.Data;
import lombok.EqualsAndHashCode;
import java.util.List;
/**
* <p>
* 文件上传VO
* </p>
*
* @author 小蚂蚁云团队
* @since 2024-01-23
*/
@Data
public class UploadFileLogVO {
/**
* 文件标题
*/
private String title;
/**
* 文件类型：0-单个文件 1-多个文件 2-其他
*/
private Integer type;
/**
* 文件参数
*/
private String param;
/**
* 文件内容
*/
private String content;
/**
* 请求结果
*/
private String result;
/**
* 请求耗时
*/
private Long consumeTime;
/**
* 业务类型：1-订单 2-其他
*/
private Integer bizType;
/**
* 业务ID
*/
private Integer bizId;
/**
* 业务内容
*/
private String bizContent;
/**
* 状态：0-未读 1-已读
*/
private Integer status;
/**
* 错误描述
*/
private String error;
/**
* 文件列表
*/
private List<UploadFileVO> uploadFileVOList;
}
xiaomayi-common/xiaomayi-file/src/main/java/com/xiaomayi/file/vo/UploadFileVO.java
+122
View File
@@ -0,0 +1,122 @@
// +======================================================================
// | 小蚂蚁云·企业数字化开发平台 [ 加速数字化转型，构建智能未来 ]
// +----------------------------------------------------------------------
// | 核心价值：赋能开发者 · 服务企业 · 共建生态
// +----------------------------------------------------------------------
// | 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.file.vo;
import lombok.Data;
/**
* <p>
* 文件上传VO
* </p>
*
* @author 小蚂蚁云团队
* @since 2024-01-23
*/
@Data
public class UploadFileVO {
/**
* 文件原始名称
*/
private String originalName;
/**
* 文件后缀
*/
private String fileExtension;
/**
* 文件类型
*/
private String fileType;
/**
* 文件大小(单位：KB)
*/
private Long fileSize;
/**
* 文件名称
*/
private String fileName;
/**
* 文件地址
*/
private String filePath;
/**
* 文件地址
*/
private String fileUrl;
}