liurunyu
2025-07-14 90c02e0ad08c054e1f44476a3e9e16b947c1fd8c
README.md
@@ -58,6 +58,47 @@
- **工具集**: Hutool 5.8.22
- **日志框架**: Log4j2 2.20.0
## ID生成器使用说明
系统使用自定义的IDLongGenerator来生成唯一的Long型ID,确保在分布式环境下的ID唯一性。
### IDLongGenerator特性
- **格式**: `年月日时分秒` + `3位自增序列` + `2位系统后缀`
- **长度**: 19位数字(如:20231218104504069**00**)
- **并发性**: 支持同一秒内生成1000个不同ID
- **分布式**: 通过后缀区分不同子系统,避免ID冲突
### 使用方式
```java
// 依赖注入
@Autowired
private IDLongGenerator idLongGenerator;
// 生成ID
Long id = idLongGenerator.generate();
```
### 应用场景
- **管理卡创建**: createManagementCard方法中使用IDLongGenerator生成管理卡ID
- **实体主键**: 所有业务实体的主键ID生成
- **订单号**: 业务流水号生成
- **日志记录**: 操作记录的唯一标识
### 配置说明
系统启动时会自动设置ID后缀,不同的服务模块使用不同的后缀来避免ID冲突:
```xml
<!-- web.xml或Spring配置 -->
<context-param>
    <param-name>idSuffix</param-name>
    <param-value>01</param-value> <!-- 不同服务使用不同后缀 -->
</context-param>
```
## 开发环境搭建
### 前置条件