根目录 > nflg-wms-common
nflg-wms-common - 公共模块
模块职责
公共基础模块，不包含任何业务逻辑，不可独立启动。为所有其他模块提供：
- 通用 POJO 定义（QO/VO/DTO）
- 常量定义
- 异常类
- 工具类
- 函数式接口
关键依赖
- Hutool (工具库)
- Sa-Token Core (权限 Token 核心)
- MyBatis-Plus Core (分页等核心功能)
- Jackson (JSON 序列化)
- EEC (Excel 导出)
- OkHttp (HTTP 客户端)
- TinyPinyin (拼音转换)
- Spring Data MongoDB (文档型数据模型)
关键目录说明
| 路径 |
说明 |
constant/ |
业务常量/枚举 |
exception/ |
异常类 |
function/ |
函数式接口 |
pojo/ |
公共 POJO 容器 |
pojo/qo/ |
查询/请求对象 (Query Object) |
pojo/vo/ |
视图对象 (View Object) |
pojo/dto/ |
数据传输对象 (Data Transfer Object) |
pojo/document/ |
MongoDB 文档模型 |
util/ |
工具类 |
常量/枚举清单
| 类 |
说明 |
OrderState |
订单状态枚举 |
UserState |
用户状态枚举 |
UserType |
用户类型枚举 |
BarCodeType |
条码类型枚举 |
OperationType |
操作类型枚举 |
AduitLogType |
审计日志类型枚举 |
InventoryCheckTaskState |
盘点任务状态枚举 |
BarCodeProcessStage |
条码处理阶段枚举 |
异常类清单
| 类 |
说明 |
NflgException |
通用业务异常 |
DataAlertException |
数据告警异常 |
SAPException |
SAP 集成异常 |
函数式接口清单
| 类 |
说明 |
BranchHandleFunction |
分支处理函数 |
ThrowExceptionFunction |
抛异常函数 |
ThrowBusinessExceptionFunction |
抛业务异常函数 |
TrueHandleFunction |
真值处理函数 |
工具类清单
| 类 |
说明 |
MultilingualUtil |
多语言工具 |
ZipUtils |
压缩工具 |
StringUtil |
字符串工具 |
DateTimeUtil |
日期时间工具 |
Base62Util |
Base62 编码工具 |
BeanUtil |
Bean 拷贝工具 |
BomUtil |
BOM 工具 |
EecExcelUtil |
EEC Excel 工具 |
NumberUtil |
数字工具 |
PageUtil |
分页工具 |
UserUtil |
用户工具 |
VUtil |
校验/断言工具 |
数据模型
核心 POJO
ApiResult<T> - 统一 API 响应包装PageData<T> - 分页数据包装
MongoDB 文档
InMaterialScanRecord - 入库物料扫码记录OutMaterialScanRecord - 出库物料扫码记录InventoryCheckTaskScanRecord - 盘点任务扫码记录PackageMaterialScanRecord - 包装物料扫码记录SrmMaterialReceiptScanCodes - SRM 物料收货扫码记录SrmMaterialReceiptNoScanCodes - SRM 物料收货非扫码记录
测试
无独立测试文件。
相关文件清单
src/main/java/com/nflg/wms/common/ - 全部源码pom.xml - 模块依赖定义
变更记录 (Changelog)
| 时间 |
操作 |
说明 |
| 2026-05-23 14:28:57 |
更新 |
补充完整工具类清单（3->12 个），增加常量/枚举/异常/函数式接口独立清单表格 |
| 2026-05-23 14:16:58 |
初始化 |
首次生成模块文档 |