|  |  |  | 
|---|
|  |  |  | - **工具集**: 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> | 
|---|
|  |  |  | ``` | 
|---|
|  |  |  |  | 
|---|
|  |  |  | ## 开发环境搭建 | 
|---|
|  |  |  |  | 
|---|
|  |  |  | ### 前置条件 | 
|---|