refactor(model): 重构模型类包结构并优化序列化处理

重构模型类包结构,将模型类按功能模块划分到不同的子包中。优化序列化处理,为VO类添加serialVersionUID并实现Serializable接口。移除部分冗余的serialVersionUID字段,简化模型类代码。同时修复UITools中空值处理的问题,并更新pom版本至0.0.100-SNAPSHOT。

- 将模型类按功能模块划分到ds子包中
- 为VO类添加序列化支持
- 移除冗余的serialVersionUID字段
- 修复UITools空值处理问题
- 更新项目版本号
This commit is contained in:
2025-10-09 18:27:48 +08:00
parent 51b8c16798
commit c4eec0a9dd
457 changed files with 8426 additions and 3669 deletions

View File

@@ -0,0 +1,106 @@
# 受影响组件分析报告
## 1. 概述
本报告是任务T6 "分析并处理受影响的依赖组件" 的执行结果旨在分析Server模块Service缓存从实体对象调整为VO对象后受到影响的所有依赖组件并提供相应的处理方案。
## 2. 受影响组件列表
经过全面分析以下是受Service泛型参数调整和缓存策略变更影响的主要组件
### 2.1 WebSocket相关组件
1. **WebSocketServerCallbackManager**
- 核心依赖组件通过反射调用Service方法
- 影响位置:`invokerFindAllMethod``invokerFindByIdMethod``invokerSaveMethod``createNewEntity`等方法
- 影响程度:高
2. **WebSocketServerTaskManager**
- 处理WebSocket任务的管理器
- 影响位置处理Tasker的messageHandler和propertyHandler
- 影响程度:中
### 2.2 Service基类和接口
1. **EntityService**
- 所有Service的基类
- 影响位置:`findAll`等返回VO对象的方法
- 影响程度:高
2. **IEntityService**
- 实体服务接口
- 影响位置:接口定义和方法签名
- 影响程度:中
3. **QueryService**
- 查询服务接口
- 影响位置返回VO对象的方法
- 影响程度:高
4. **VoableService**
- VO对象转换服务接口
- 影响位置:`updateByVo`方法
- 影响程度:高
### 2.3 缓存相关组件
1. **@CacheConfig和@Cacheable注解**
- 缓存配置和缓存方法注解
- 影响位置Service类中的缓存方法
- 影响程度:中
### 2.4 实体类
1. **所有实现Voable接口的实体类**
- 需要实现`toVo()`方法进行实体到VO的转换
- 影响程度:高
## 3. 依赖组件影响分析
### 3.1 WebSocketServerCallbackManager
**主要影响:**
- 需要处理Service接口泛型参数变化
- 需要支持实体对象到VO对象的自动转换
- 需要正确识别和创建实体类型实例
**现有实现:**
- 已在`invokerFindAllMethod`中实现了实体对象到VO对象的转换
- 已在`send`方法中对Voable类型数据进行toVo转换
- 已实现了多种查找实体类型的方法
**问题分析:**
-`createNewEntity`方法中,通过分析接口的泛型参数来获取实体类型的逻辑较为复杂
- 对Spring代理类的处理需要确保能够正确获取原始类的泛型参数
### 3.2 Service类实现
**主要影响:**
- 需要同时实现多个接口IEntityService、QueryService、VoableService
- 需要确保缓存注解的键值表达式仍然有效
- 需要实现updateByVo方法进行VO到实体的转换
**现有实现:**
- 所有Service类均已实现VoableService接口
- 已正确调整泛型参数
- 已实现updateByVo方法
**问题分析:**
- 确保所有Service类的updateByVo方法正确处理了所有字段和关联实体
- 确保缓存键的表达式仍然能够正确工作
## 4. 兼容性分析
### 4.1 向前兼容性
- **客户端兼容性:** 客户端通过WebSocket获取的数据现在是VO对象而不是实体对象但由于VO对象包含了客户端所需的所有字段因此客户端代码无需修改
- **现有API兼容性** REST API接口返回的数据结构保持不变因此第三方集成不受影响
### 4.2 向后兼容性
- **数据存储:** 实体对象的存储结构未发生变化,数据库兼容性得到保证
- **缓存数据:** 缓存的数据从实体对象变为VO对象可能需要清理现有缓存
## 5. 结论
经过分析Service缓存从实体对象调整为VO对象的变更对系统的核心组件产生了一定影响但这些影响主要集中在服务层内部对客户端和外部系统的影响较小。WebSocketServerCallbackManager已经实现了必要的转换逻辑保证了系统的正常运行。为了确保系统的稳定性和性能建议进行彻底的测试和Redis缓存清理。