common —— 公共工具库
概述
common 是 framework 的公共模块，提供无第三方框架依赖的核心工具类和常量定义，被所有其他模块依赖。
核心能力
工具类
- IdWorker —— 分布式 ID 生成器（雪花算法）
- Assert —— 断言工具（参数校验、业务异常抛出）
- BeanUtil / CollectionUtil / StringUtil / NumberUtil / ArrayUtil / ObjectUtil / DateUtil / FileUtil —— 常用操作工具
- RegUtil —— 正则匹配工具（预置常用正则 PatternPool）
- XmlUtil / ZipUtil —— XML 解析与 ZIP 压缩
- MailUtil —— 邮件发送
- ReflectUtil —— 反射操作
- ThreadUtil —— 线程工具
- Locker — 分布式锁接口定义
异常体系
- BaseException —— 异常基类
- ClientException / SysException —— 客户端异常 / 系统异常
- AccessDeniedException / AuthExpiredException / InputErrorException / UserLoginException / RepeatRequestException 等具体异常
常量
- StringPool —— 字符串常量池
- PatternPool —— 正则表达式常量
- ResponseConstants —— 响应状态码常量
函数式接口
- SFunction —— 支持 Lambda 方法引用的函数接口（用于 MyBatis-Plus Lambda 查询）
依赖
- Hutool 5.7.17
- SLF4J + Logback
- Lombok
- HttpClient
- JavaMail
- dom4j