Files
framework/common/README.md
2026-06-20 00:16:23 +08:00

41 lines
1.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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