# 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