refactor(model): 重构模型类包结构并优化序列化处理
重构模型类包结构,将模型类按功能模块划分到不同的子包中。优化序列化处理,为VO类添加serialVersionUID并实现Serializable接口。移除部分冗余的serialVersionUID字段,简化模型类代码。同时修复UITools中空值处理的问题,并更新pom版本至0.0.100-SNAPSHOT。 - 将模型类按功能模块划分到ds子包中 - 为VO类添加序列化支持 - 移除冗余的serialVersionUID字段 - 修复UITools空值处理问题 - 更新项目版本号
This commit is contained in:
@@ -1,414 +1,402 @@
|
||||
# Server模块Service缓存调整为Vo对象拆分任务文档
|
||||
# 6A工作流 - TASK阶段文档
|
||||
|
||||
## 1. 任务拆分列表
|
||||
## 任务名称:Server模块Service缓存调整为Vo对象
|
||||
|
||||
### 1.1 任务1: 分析现有Service类结构和依赖关系
|
||||
## 1. 任务完成状态概述
|
||||
|
||||
**输入契约**:
|
||||
- 项目代码库访问权限
|
||||
- server模块中注解了@CacheConfig的Service类列表
|
||||
- WebSocketServerHandler、WebSocketServerTaskManager、WebSocketServerCallbackManager代码
|
||||
**总体状态**: 进行中
|
||||
|
||||
**输出契约**:
|
||||
- 详细的Service类结构分析报告
|
||||
- Service类之间的依赖关系图
|
||||
- Service类与其他组件(Controller、Repository、WebSocket服务等)的依赖关系分析
|
||||
| 任务ID | 任务名称 | 状态 | 负责人 | 备注 |
|
||||
|--------|----------|------|--------|------|
|
||||
| T1 | 分析Service类结构 | 已完成 | - | 已确定需要修改的Service类和接口 |
|
||||
| T2 | 设计数据转换机制 | 已完成 | - | 已设计实体类与Vo类的转换方案 |
|
||||
| T3 | 设计缓存策略 | 已完成 | - | 已确定缓存Vo对象的策略 |
|
||||
| T4 | 修改CompanyFileTypeService类 | 已完成 | - | 已完成泛型调整和方法实现 |
|
||||
| T5 | 批量修改其他Service类 | 进行中 | - | 需要按照CompanyFileTypeService模式修改其他Service类 |
|
||||
| T6 | 处理WebSocket服务组件 | 未开始 | - | 需要分析并修改WebSocketServerHandler等类 |
|
||||
| T7 | 清理Redis缓存 | 未开始 | - | 需要开发清理工具/脚本 |
|
||||
| T8 | 编写测试用例 | 未开始 | - | 需要编写单元测试和集成测试 |
|
||||
| T9 | 更新相关文档 | 进行中 | - | 正在按照6A工作流更新文档 |
|
||||
| T10 | 分析并修改WebSocket服务组件 | 未开始 | - | 需分析WebSocketServerHandler等类的类型处理逻辑 |
|
||||
|
||||
**实现约束**:
|
||||
- 使用搜索工具分析代码结构
|
||||
- 记录每个Service类的IEntityService泛型参数(Model类型)和QueryService泛型参数(Vo类型)以及VoableService泛型参数
|
||||
- 记录Service类中的特殊方法和缓存配置
|
||||
- 特别关注WebSocketServerCallbackManager中与IEntityService接口的交互逻辑
|
||||
## 2. 任务拆分列表
|
||||
|
||||
**依赖关系**:
|
||||
- 前置任务:无
|
||||
- 后置任务:任务2、任务3、任务4
|
||||
### T1: 分析Service类结构
|
||||
|
||||
### 1.2 任务2: 设计实体类和VO类之间的转换机制
|
||||
**输入契约**:
|
||||
- server模块源代码目录结构
|
||||
- Service类文件
|
||||
|
||||
**输入契约**:
|
||||
- 实体类和VO类的结构定义
|
||||
- 现有VoableService接口的实现方式
|
||||
**输出契约**:
|
||||
- 需要修改的Service类列表
|
||||
- 每个Service类对应的实体类和Vo类
|
||||
- 每个Service类实现的接口列表
|
||||
|
||||
**输出契约**:
|
||||
- 详细的数据转换方案
|
||||
- 转换工具类或方法的设计
|
||||
- 转换异常处理策略
|
||||
**实现约束**:
|
||||
- 仅分析注解了@CacheConfig的Service类
|
||||
- 分析范围限定在server模块
|
||||
|
||||
**实现约束**:
|
||||
- 充分利用现有的转换机制
|
||||
- 确保转换的安全性和效率
|
||||
- 考虑空值处理和数据验证
|
||||
**依赖关系**:
|
||||
- 无前置依赖
|
||||
- 后置任务: T2、T3
|
||||
|
||||
**依赖关系**:
|
||||
- 前置任务:任务1
|
||||
- 后置任务:任务4
|
||||
**详细描述**:
|
||||
1. 查找server模块中所有注解了@CacheConfig的Service类
|
||||
2. 分析每个Service类实现的接口及其泛型参数
|
||||
3. 确定每个Service类对应的实体类和Vo类
|
||||
4. 创建需要修改的Service类列表
|
||||
|
||||
### 1.3 任务3: 设计缓存策略
|
||||
### T2: 设计数据转换机制
|
||||
|
||||
**输入契约**:
|
||||
- Service类结构分析报告
|
||||
- Redis配置信息
|
||||
- 现有缓存键命名规则
|
||||
**输入契约**:
|
||||
- T1的分析结果
|
||||
- 实体类和Vo类的定义
|
||||
- 现有Voable接口和VoableService接口的定义
|
||||
|
||||
**输出契约**:
|
||||
- 使用VO替代实体类进行缓存的策略文档
|
||||
- 缓存键设计方案
|
||||
- 缓存序列化与反序列化机制
|
||||
- 缓存失效策略
|
||||
**输出契约**:
|
||||
- 实体类实现Voable接口的方案
|
||||
- Service类中实现数据转换的方法
|
||||
|
||||
**实现约束**:
|
||||
- 确保缓存键的唯一性和可读性
|
||||
- 考虑缓存大小和性能优化
|
||||
- 确保缓存与数据库数据一致性
|
||||
**实现约束**:
|
||||
- 遵循现有的代码规范和模式
|
||||
- 确保转换过程不丢失数据
|
||||
|
||||
**依赖关系**:
|
||||
- 前置任务:任务1
|
||||
- 后置任务:任务4
|
||||
**依赖关系**:
|
||||
- 前置任务: T1
|
||||
- 后置任务: T3、T4
|
||||
|
||||
### 1.4 任务4: 修改单个Service类的泛型参数和方法实现
|
||||
**详细描述**:
|
||||
1. 设计实体类实现Voable接口的方案,包括toVo方法的实现
|
||||
2. 设计Service类中findById、findAll等方法的实现,确保正确进行数据转换
|
||||
3. 设计VoableService接口中updateByVo和createByVo方法的实现
|
||||
|
||||
**输入契约**:
|
||||
- 选定的Service类文件路径
|
||||
- 转换机制设计文档
|
||||
- 缓存策略设计方案
|
||||
- 接口契约定义
|
||||
### T3: 设计缓存策略
|
||||
|
||||
**输出契约**:
|
||||
- 修改后的Service类代码
|
||||
- 针对该Service类的单元测试用例
|
||||
- 修改验证报告
|
||||
**输入契约**:
|
||||
- T1的分析结果
|
||||
- 现有缓存配置和注解
|
||||
- 数据转换机制设计
|
||||
|
||||
**实现约束**:
|
||||
- Service类继承IEntityService接口,泛型类型为Model(实体类)
|
||||
- Service类继承QueryService接口,泛型类型为Vo(视图对象)
|
||||
- 严格按照接口契约修改方法签名
|
||||
- 正确实现数据转换逻辑
|
||||
- 确保缓存注解的正确性
|
||||
- 应用新的缓存策略
|
||||
**输出契约**:
|
||||
- 缓存Vo对象的策略文档
|
||||
- 缓存键表达式的调整方案
|
||||
- 缓存注解的优化建议
|
||||
|
||||
**依赖关系**:
|
||||
- 前置任务:任务2、任务3
|
||||
- 后置任务:任务5、任务6
|
||||
**实现约束**:
|
||||
- 确保缓存的是Vo对象而非实体类对象
|
||||
- 保持缓存键表达式的有效性
|
||||
- 避免缓存穿透、缓存雪崩等问题
|
||||
|
||||
### 1.5 任务5: 批量修改所有注解了@CacheConfig的Service类
|
||||
**依赖关系**:
|
||||
- 前置任务: T1、T2
|
||||
- 后置任务: T4、T5
|
||||
|
||||
**输入契约**:
|
||||
- 所有需要修改的Service类列表
|
||||
- 单个Service类修改的成功案例
|
||||
- 转换机制设计文档
|
||||
- 缓存策略设计方案
|
||||
**详细描述**:
|
||||
1. 分析现有缓存配置和注解
|
||||
2. 设计缓存Vo对象的策略,包括缓存注解的使用方式
|
||||
3. 评估缓存键表达式是否需要调整
|
||||
4. 提供缓存优化建议
|
||||
|
||||
**输出契约**:
|
||||
- 所有修改后的Service类代码
|
||||
- 批量修改执行报告
|
||||
### T4: 修改CompanyFileTypeService类
|
||||
|
||||
**实现约束**:
|
||||
- Service类继承IEntityService接口,泛型类型为Model(实体类)
|
||||
- Service类继承QueryService接口,泛型类型为Vo(视图对象)
|
||||
- 确保每个Service类的修改一致性
|
||||
- 记录修改过程中的问题和解决方法
|
||||
- 验证修改后的代码编译通过
|
||||
- 统一应用缓存策略
|
||||
**输入契约**:
|
||||
- T1、T2、T3的输出结果
|
||||
- CompanyFileTypeService类源码
|
||||
- CompanyFileType和CompanyFileTypeVo类源码
|
||||
- CompanyFileTypeRepository接口
|
||||
|
||||
**依赖关系**:
|
||||
- 前置任务:任务4
|
||||
- 后置任务:任务6、任务7、任务8、任务10
|
||||
**输出契约**:
|
||||
- 修改后的CompanyFileTypeService类源码
|
||||
- 验证测试结果
|
||||
|
||||
### 1.6 任务6: 分析并处理受影响的依赖组件
|
||||
|
||||
**输入契约**:
|
||||
- 修改后的Service类接口定义
|
||||
- 系统依赖关系分析报告
|
||||
- WebSocketServerHandler、WebSocketServerTaskManager、WebSocketServerCallbackManager代码
|
||||
|
||||
**输出契约**:
|
||||
- 受影响组件列表
|
||||
- 依赖组件修改方案
|
||||
- 修改后的依赖组件代码
|
||||
- WebSocket服务兼容性分析报告
|
||||
|
||||
**实现约束**:
|
||||
- 尽量减少对其他组件的影响
|
||||
- 确保依赖组件能够正确调用新的Service接口
|
||||
- 特别关注WebSocket服务组件的兼容性处理
|
||||
- 验证依赖修改的正确性
|
||||
|
||||
**依赖关系**:
|
||||
- 前置任务:任务5
|
||||
- 后置任务:任务9
|
||||
|
||||
### 1.7 任务7: 清理Redis缓存
|
||||
|
||||
**输入契约**:
|
||||
- Redis连接信息
|
||||
- 缓存键前缀或模式
|
||||
|
||||
**输出契约**:
|
||||
- 缓存清理记录
|
||||
- Redis缓存状态报告
|
||||
|
||||
**实现约束**:
|
||||
- 安全清除相关缓存数据,避免误删
|
||||
- 记录清理的缓存键数量
|
||||
- 确保清理后不影响系统运行
|
||||
|
||||
**依赖关系**:
|
||||
- 前置任务:任务5
|
||||
- 后置任务:任务9
|
||||
|
||||
### 1.8 任务8: 编写测试用例并验证修改
|
||||
|
||||
**输入契约**:
|
||||
- 修改后的所有Service类代码
|
||||
- 项目测试框架配置
|
||||
- 缓存策略设计方案
|
||||
- 修改后的WebSocket服务组件
|
||||
|
||||
**输出契约**:
|
||||
- 完整的单元测试和集成测试用例
|
||||
- WebSocket服务测试用例
|
||||
- 测试执行报告
|
||||
- 问题修复记录
|
||||
|
||||
**实现约束**:
|
||||
- 覆盖所有修改的Service类和方法
|
||||
- 测试数据转换的正确性
|
||||
- 测试缓存功能的正常运行
|
||||
- 确保测试覆盖率达到合理水平
|
||||
- 特别验证VO缓存的有效性
|
||||
- 包含WebSocket服务的兼容性测试
|
||||
|
||||
**依赖关系**:
|
||||
- 前置任务:任务5、任务10
|
||||
- 后置任务:任务9
|
||||
|
||||
### 1.9 任务9: 更新相关文档并总结
|
||||
|
||||
**输入契约**:
|
||||
- 所有任务的执行结果
|
||||
- 项目文档规范
|
||||
- 缓存清理记录
|
||||
- WebSocket服务修改记录
|
||||
|
||||
**输出契约**:
|
||||
- 更新后的项目文档
|
||||
- 任务总结报告
|
||||
- TODO列表(如果有未完成的工作)
|
||||
|
||||
**实现约束**:
|
||||
- 确保文档与代码的一致性
|
||||
- 提供清晰的修改说明和总结
|
||||
- 记录接口泛型修改和缓存策略变更的相关信息
|
||||
- 记录WebSocket服务相关的设计和实现说明
|
||||
- 记录经验教训和改进建议
|
||||
|
||||
**依赖关系**:
|
||||
- 前置任务:任务6、任务7、任务8
|
||||
- 后置任务:无
|
||||
|
||||
### 1.10 任务10: 分析并修改WebSocket服务组件
|
||||
|
||||
**输入契约**:
|
||||
- WebSocketServerHandler、WebSocketServerTaskManager、WebSocketServerCallbackManager代码
|
||||
- 任务5的修改结果
|
||||
- 任务1的Service类结构分析报告
|
||||
|
||||
**输出契约**:
|
||||
- WebSocket服务与IEntityService接口交互分析报告
|
||||
- 潜在问题和风险清单
|
||||
- 修改后的WebSocketServerCallbackManager代码
|
||||
- WebSocket服务测试用例
|
||||
|
||||
**实现约束**:
|
||||
- 重点分析WebSocketServerCallbackManager中的类型处理逻辑
|
||||
- 特别关注createNewEntity、findEntityTypeInInterfaces、invokerFindByIdMethod、invokerFindAllMethod等依赖泛型参数的方法
|
||||
- 确保WebSocket服务能够正确处理IEntityService<Model>到QueryService<Vo>的泛型关系
|
||||
- 添加类型安全检查
|
||||
**实现约束**:
|
||||
- 按照设计文档修改接口泛型参数
|
||||
- 实现所有必要的方法
|
||||
- 确保缓存注解正确使用
|
||||
- 遵循代码规范
|
||||
|
||||
**依赖关系**:
|
||||
- 前置任务:任务5
|
||||
- 后置任务:任务8
|
||||
**依赖关系**:
|
||||
- 前置任务: T1、T2、T3
|
||||
- 后置任务: T5、T9
|
||||
|
||||
## 2. 任务依赖图
|
||||
**详细描述**:
|
||||
1. 修改CompanyFileTypeService类实现的接口,添加QueryService<CompanyFileTypeVo>和VoableService<CompanyFileType, CompanyFileTypeVo>
|
||||
2. 实现findById、findAll等QueryService接口方法,确保返回Vo对象
|
||||
3. 确保findById方法标注@Cacheable注解
|
||||
4. 实现VoableService接口的updateByVo和createByVo方法
|
||||
5. 编写验证测试,确保修改后的方法正常工作
|
||||
|
||||
### T5: 批量修改其他Service类
|
||||
|
||||
**输入契约**:
|
||||
- T1的分析结果
|
||||
- T4的修改方案和验证结果
|
||||
- 其他Service类源码
|
||||
- 对应的实体类和Vo类源码
|
||||
|
||||
**输出契约**:
|
||||
- 所有修改后的Service类源码
|
||||
- 批量修改的执行报告
|
||||
- 验证测试结果
|
||||
|
||||
**实现约束**:
|
||||
- 按照CompanyFileTypeService的模式修改其他Service类
|
||||
- 确保所有方法实现正确
|
||||
- 遵循代码规范
|
||||
- 逐个验证修改结果
|
||||
|
||||
**依赖关系**:
|
||||
- 前置任务: T1、T4
|
||||
- 后置任务: T7、T8、T9
|
||||
|
||||
**详细描述**:
|
||||
1. 按照CompanyFileTypeService的模式,批量修改其他Service类
|
||||
2. 每个Service类修改完成后进行验证测试
|
||||
3. 记录批量修改过程中的问题和解决方案
|
||||
4. 生成批量修改执行报告
|
||||
|
||||
**待修改的Service类**:
|
||||
- CompanyCustomerFileTypeService
|
||||
- CompanyExtendInfoService
|
||||
- CompanyFileTypeLocalService
|
||||
- CompanyVendorFileTypeService
|
||||
- CustomerInfoService
|
||||
- CustomerTypeService
|
||||
- EmployeeService
|
||||
- ProjectCostService
|
||||
- ProjectFileTypeService
|
||||
- ProjectQuotationService
|
||||
- ...其他注解了@CacheConfig的Service类
|
||||
|
||||
### T6: 处理WebSocket服务组件
|
||||
|
||||
**输入契约**:
|
||||
- WebSocketServerCallbackManager类源码
|
||||
- WebSocketServerHandler类源码
|
||||
- WebSocketServerTaskManager类源码
|
||||
- 其他WebSocket相关组件
|
||||
|
||||
**输出契约**:
|
||||
- 修改后的WebSocket组件源码
|
||||
- 验证测试结果
|
||||
|
||||
**实现约束**:
|
||||
- 确保WebSocket服务能够适配新的接口定义
|
||||
- 保持现有WebSocket功能正常
|
||||
- 遵循代码规范
|
||||
|
||||
**依赖关系**:
|
||||
- 前置任务: T5
|
||||
- 后置任务: T8、T9
|
||||
|
||||
**详细描述**:
|
||||
1. 分析WebSocketServerCallbackManager类中的类型处理逻辑
|
||||
2. 分析createNewEntity、findEntityTypeInInterfaces等方法的实现
|
||||
3. 修改相关方法,确保能够正确处理Service类的新泛型参数
|
||||
4. 验证修改后的WebSocket服务功能正常
|
||||
|
||||
### T7: 清理Redis缓存
|
||||
|
||||
**输入契约**:
|
||||
- Redis缓存配置信息
|
||||
- 现有缓存数据结构
|
||||
|
||||
**输出契约**:
|
||||
- Redis缓存清理工具/脚本
|
||||
- 缓存清理执行报告
|
||||
- 验证结果
|
||||
|
||||
**实现约束**:
|
||||
- 确保清理所有旧的实体类缓存数据
|
||||
- 避免影响系统正常运行
|
||||
- 记录清理过程和结果
|
||||
|
||||
**依赖关系**:
|
||||
- 前置任务: T5
|
||||
- 后置任务: T8、T9
|
||||
|
||||
**详细描述**:
|
||||
1. 开发Redis缓存清理工具或脚本
|
||||
2. 执行缓存清理操作,清除所有旧的实体类缓存数据
|
||||
3. 验证缓存清理结果
|
||||
4. 生成缓存清理执行报告
|
||||
|
||||
### T8: 编写测试用例
|
||||
|
||||
**输入契约**:
|
||||
- 所有修改后的Service类源码
|
||||
- WebSocket组件源码
|
||||
- 设计文档
|
||||
|
||||
**输出契约**:
|
||||
- 单元测试用例
|
||||
- 集成测试用例
|
||||
- 测试执行报告
|
||||
|
||||
**实现约束**:
|
||||
- 覆盖所有修改的功能点
|
||||
- 包含边界条件和异常情况测试
|
||||
- 确保测试通过率达到100%
|
||||
|
||||
**依赖关系**:
|
||||
- 前置任务: T5、T6、T7
|
||||
- 后置任务: T9
|
||||
|
||||
**详细描述**:
|
||||
1. 为每个修改后的Service类编写单元测试用例
|
||||
2. 编写集成测试用例,验证不同组件之间的交互
|
||||
3. 包含边界条件和异常情况的测试
|
||||
4. 执行测试并生成测试执行报告
|
||||
|
||||
### T9: 更新相关文档
|
||||
|
||||
**输入契约**:
|
||||
- 所有修改的代码
|
||||
- 设计文档
|
||||
- 测试报告
|
||||
- 项目文档规范
|
||||
|
||||
**输出契约**:
|
||||
- 更新后的项目文档
|
||||
- 设计文档
|
||||
- 用户手册(如需)
|
||||
|
||||
**实现约束**:
|
||||
- 确保文档与代码的一致性
|
||||
- 遵循项目文档规范
|
||||
- 保持文档的清晰和准确性
|
||||
|
||||
**依赖关系**:
|
||||
- 前置任务: T4、T5、T6、T7、T8
|
||||
- 后置任务: T10
|
||||
|
||||
**详细描述**:
|
||||
1. 更新项目架构文档,反映Service类的修改
|
||||
2. 更新接口文档,确保与实际实现一致
|
||||
3. 更新用户手册(如需)
|
||||
4. 确保所有文档的格式和内容符合项目规范
|
||||
|
||||
### T10: 分析并修改WebSocket服务组件
|
||||
|
||||
**输入契约**:
|
||||
- WebSocketServerHandler类源码
|
||||
- WebSocketServerTaskManager类源码
|
||||
- 其他WebSocket相关组件
|
||||
- Service类的修改方案
|
||||
|
||||
**输出契约**:
|
||||
- 修改后的WebSocket组件源码
|
||||
- 验证测试结果
|
||||
|
||||
**实现约束**:
|
||||
- 确保WebSocket服务能够正确处理Vo对象
|
||||
- 保持现有WebSocket功能正常
|
||||
- 遵循代码规范
|
||||
|
||||
**依赖关系**:
|
||||
- 前置任务: T9
|
||||
- 后置任务: 无
|
||||
|
||||
**详细描述**:
|
||||
1. 分析WebSocketServerHandler类中的类型处理逻辑
|
||||
2. 分析WebSocketServerHandler类与IEntityService接口的泛型关系
|
||||
3. 修改相关方法,确保能够正确处理Vo对象的序列化和反序列化
|
||||
4. 验证修改后的WebSocket服务功能正常
|
||||
|
||||
## 3. 任务依赖图
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
subgraph 任务拆分
|
||||
T1[任务1: 分析现有Service类结构]
|
||||
T2[任务2: 设计转换机制]
|
||||
T3[任务3: 设计缓存策略]
|
||||
T4[任务4: 修改单个Service类]
|
||||
T5[任务5: 批量修改Service类]
|
||||
T6[任务6: 处理依赖组件]
|
||||
T7[任务7: 清理Redis缓存]
|
||||
T8[任务8: 编写测试用例]
|
||||
T9[任务9: 更新文档并总结]
|
||||
T10[任务10: 分析并修改WebSocket服务组件]
|
||||
end
|
||||
|
||||
T1 --> T2
|
||||
T1 --> T3
|
||||
T2 --> T4
|
||||
graph TD
|
||||
T1[分析Service类结构] --> T2[设计数据转换机制]
|
||||
T1 --> T3[设计缓存策略]
|
||||
T2 --> T4[修改CompanyFileTypeService类]
|
||||
T3 --> T4
|
||||
T4 --> T5
|
||||
T5 --> T6
|
||||
T5 --> T7
|
||||
T5 --> T8
|
||||
T5 --> T10
|
||||
T10 --> T8
|
||||
T4 --> T5[批量修改其他Service类]
|
||||
T5 --> T6[处理WebSocket服务组件]
|
||||
T5 --> T7[清理Redis缓存]
|
||||
T6 --> T8[编写测试用例]
|
||||
T7 --> T8
|
||||
T4 --> T9[更新相关文档]
|
||||
T5 --> T9
|
||||
T6 --> T9
|
||||
T7 --> T9
|
||||
T8 --> T9
|
||||
T9 --> T10[分析并修改WebSocket服务组件]
|
||||
```
|
||||
|
||||
## 3. 子任务详细描述
|
||||
## 4. 详细执行步骤
|
||||
|
||||
### 3.1 任务1: 分析现有Service类结构和依赖关系
|
||||
### T1: 分析Service类结构
|
||||
1. 搜索server模块中所有注解了@CacheConfig的Service类
|
||||
2. 对每个Service类,分析其实现的接口和泛型参数
|
||||
3. 确定每个Service类对应的实体类和Vo类
|
||||
4. 创建需要修改的Service类列表
|
||||
|
||||
1. **执行步骤**:
|
||||
- 使用搜索工具查找所有注解了@CacheConfig的Service类
|
||||
- 分析每个Service类实现的接口和泛型参数
|
||||
- 记录每个Service类中的缓存配置和方法实现
|
||||
- 分析Service类与Repository、Controller等组件的依赖关系
|
||||
### T2: 设计数据转换机制
|
||||
1. 设计实体类实现Voable接口的方案
|
||||
2. 设计Service类中findById、findAll等方法的实现
|
||||
3. 设计VoableService接口中updateByVo和createByVo方法的实现
|
||||
|
||||
2. **关键交付物**:
|
||||
- Service类结构分析表
|
||||
- Service依赖关系图
|
||||
- 缓存配置分析报告
|
||||
### T3: 设计缓存策略
|
||||
1. 分析现有缓存配置和注解
|
||||
2. 设计缓存Vo对象的策略
|
||||
3. 评估缓存键表达式是否需要调整
|
||||
4. 提供缓存优化建议
|
||||
|
||||
### 3.2 任务2: 设计实体类和VO类之间的转换机制
|
||||
### T4: 修改CompanyFileTypeService类
|
||||
1. 修改接口实现声明:`implements IEntityService<CompanyFileType>, QueryService<CompanyFileTypeVo>, VoableService<CompanyFileType, CompanyFileTypeVo>`
|
||||
2. 实现QueryService接口方法findById,确保返回Vo对象并添加@Cacheable注解
|
||||
3. 实现QueryService接口方法findAll,确保返回Vo对象的Page
|
||||
4. 实现VoableService接口的updateByVo和createByVo方法
|
||||
5. 编写验证测试
|
||||
|
||||
1. **执行步骤**:
|
||||
- 分析实体类和VO类的结构差异
|
||||
- 研究现有的VoableService接口的实现方式
|
||||
- 设计实体类到VO类的转换方法
|
||||
- 设计VO类到实体类的转换方法
|
||||
- 设计转换异常处理策略
|
||||
### T5: 批量修改其他Service类
|
||||
1. 按照CompanyFileTypeService的模式,批量修改其他Service类
|
||||
2. 每个Service类修改完成后进行验证测试
|
||||
3. 记录批量修改过程中的问题和解决方案
|
||||
4. 生成批量修改执行报告
|
||||
|
||||
2. **关键交付物**:
|
||||
- 数据转换方案文档
|
||||
- 转换工具类设计
|
||||
- 异常处理规范
|
||||
### T6: 处理WebSocket服务组件
|
||||
1. 分析WebSocketServerCallbackManager类中的类型处理逻辑
|
||||
2. 分析createNewEntity、findEntityTypeInInterfaces等方法的实现
|
||||
3. 修改相关方法,确保能够正确处理Service类的新泛型参数
|
||||
4. 验证修改后的WebSocket服务功能正常
|
||||
|
||||
### 3.3 任务3: 设计缓存策略
|
||||
### T7: 清理Redis缓存
|
||||
1. 开发Redis缓存清理工具或脚本
|
||||
2. 执行缓存清理操作
|
||||
3. 验证缓存清理结果
|
||||
4. 生成缓存清理执行报告
|
||||
|
||||
1. **执行步骤**:
|
||||
- 分析现有缓存配置和使用方式
|
||||
- 设计使用VO替代实体类的缓存键命名规则
|
||||
- 确定缓存序列化与反序列化方案
|
||||
- 制定缓存失效和更新策略
|
||||
- 考虑缓存预热和批量加载机制
|
||||
### T8: 编写测试用例
|
||||
1. 为每个修改后的Service类编写单元测试用例
|
||||
2. 编写集成测试用例
|
||||
3. 包含边界条件和异常情况的测试
|
||||
4. 执行测试并生成测试执行报告
|
||||
|
||||
2. **关键交付物**:
|
||||
- 缓存策略设计文档
|
||||
- 缓存键命名规则
|
||||
- 缓存序列化实现方案
|
||||
### T9: 更新相关文档
|
||||
1. 更新项目架构文档
|
||||
2. 更新接口文档
|
||||
3. 更新用户手册(如需)
|
||||
4. 确保所有文档的格式和内容符合项目规范
|
||||
|
||||
### 3.4 任务4: 修改单个Service类的泛型参数和方法实现
|
||||
### T10: 分析并修改WebSocket服务组件
|
||||
1. 分析WebSocketServerHandler类中的类型处理逻辑
|
||||
2. 分析WebSocketServerHandler类与IEntityService接口的泛型关系
|
||||
3. 修改相关方法,确保能够正确处理Vo对象的序列化和反序列化
|
||||
4. 验证修改后的WebSocket服务功能正常
|
||||
|
||||
1. **执行步骤**:
|
||||
- 选择一个典型的Service类作为试点
|
||||
- 确保IEntityService泛型参数为Model(实体类)
|
||||
- 确保QueryService泛型参数为Vo(视图对象)
|
||||
- 逐一修改实现的接口方法,添加数据转换逻辑
|
||||
- 应用新的缓存策略和缓存键
|
||||
- 验证修改后的代码能够编译通过
|
||||
- 编写单元测试验证功能正确性
|
||||
## 5. 关键交付物
|
||||
|
||||
2. **关键交付物**:
|
||||
- 修改后的Service类代码
|
||||
- 单元测试用例
|
||||
- 功能验证报告
|
||||
|
||||
### 3.5 任务5: 批量修改所有注解了@CacheConfig的Service类
|
||||
|
||||
1. **执行步骤**:
|
||||
- 基于任务4的成功经验,制定批量修改计划
|
||||
- 逐一修改每个注解了@CacheConfig的Service类
|
||||
- 确保每个Service类的IEntityService泛型参数为Model(实体类)
|
||||
- 确保每个Service类的QueryService泛型参数为Vo(视图对象)
|
||||
- 对每个Service类应用相同的转换机制和缓存策略
|
||||
- 记录修改过程中的问题和解决方法
|
||||
- 执行编译检查确保所有修改正确
|
||||
|
||||
2. **关键交付物**:
|
||||
- 所有修改后的Service类代码
|
||||
- 批量修改执行日志
|
||||
- 编译验证报告
|
||||
|
||||
### 3.6 任务6: 分析并处理受影响的依赖组件
|
||||
|
||||
1. **执行步骤**:
|
||||
- 使用搜索工具查找所有调用修改后Service类的组件
|
||||
- 分析这些组件如何使用Service类的方法
|
||||
- 根据需要修改这些组件,使其适应新的接口定义
|
||||
- 验证修改后的组件能够正确与Service类交互
|
||||
|
||||
2. **关键交付物**:
|
||||
- 受影响组件列表
|
||||
- 修改后的组件代码
|
||||
- 依赖验证报告
|
||||
|
||||
### 3.7 任务7: 清理Redis缓存
|
||||
|
||||
1. **执行步骤**:
|
||||
- 确认需要清理的缓存键前缀或模式
|
||||
- 编写Redis缓存清理脚本或工具
|
||||
- 执行缓存清理操作
|
||||
- 验证缓存清理结果
|
||||
- 记录清理过程和结果
|
||||
|
||||
2. **关键交付物**:
|
||||
- 缓存清理记录
|
||||
- Redis缓存状态报告
|
||||
|
||||
### 3.8 任务8: 编写测试用例并验证修改
|
||||
|
||||
1. **执行步骤**:
|
||||
- 为每个修改后的Service类编写单元测试
|
||||
- 编写集成测试验证Service类与其他组件的交互
|
||||
- 测试数据转换的正确性和性能
|
||||
- 特别测试IEntityService<Model>和QueryService<Vo>的交互逻辑
|
||||
- 特别测试缓存功能的正常运行,包括Vo对象的缓存和读取
|
||||
- 执行所有测试并分析结果
|
||||
|
||||
2. **关键交付物**:
|
||||
- 完整的测试用例集
|
||||
- 测试执行报告
|
||||
- 问题修复记录
|
||||
|
||||
### 3.9 任务9: 更新相关文档并总结
|
||||
|
||||
1. **执行步骤**:
|
||||
- 更新项目中的相关技术文档,记录IEntityService<Model>和QueryService<Vo>的泛型关系以及缓存策略变更
|
||||
- 编写任务总结报告
|
||||
- 创建TODO列表记录未完成的工作或改进建议
|
||||
- 归档所有任务文档
|
||||
|
||||
2. **关键交付物**:
|
||||
- 更新后的项目文档(包含IEntityService<Model>和QueryService<Vo>的泛型关系说明)
|
||||
- 任务总结报告
|
||||
- TODO列表
|
||||
|
||||
### 3.10 任务10: 分析并修改WebSocket服务组件
|
||||
|
||||
1. **执行步骤**:
|
||||
- 分析WebSocketServerHandler、WebSocketServerTaskManager、WebSocketServerCallbackManager的代码
|
||||
- 重点研究WebSocketServerCallbackManager中与IEntityService接口和QueryService接口交互的方法,特别是createNewEntity、findEntityTypeInInterfaces等依赖泛型参数的方法
|
||||
- 分析invokerFindByIdMethod、invokerFindAllMethod等方法的实现逻辑
|
||||
- 识别可能受到IEntityService<Model>和QueryService<Vo>泛型关系影响的代码部分
|
||||
- 设计WebSocket服务组件的修改方案
|
||||
- 修改WebSocketServerCallbackManager中的类型处理逻辑,使其适应IEntityService<Model>到QueryService<Vo>的泛型关系
|
||||
- 添加类型安全检查,确保能够正确处理Model和Vo类型
|
||||
- 编写测试用例验证修改后的WebSocket服务组件
|
||||
|
||||
2. **关键交付物**:
|
||||
- WebSocket服务与IEntityService<Model>和QueryService<Vo>接口交互分析报告
|
||||
- 潜在问题和风险清单
|
||||
- 修改后的WebSocketServerCallbackManager代码
|
||||
- WebSocket服务测试用例
|
||||
- 验证报告
|
||||
|
||||
通过以上任务拆分,我们可以系统地完成IEntityService接口泛型的修改任务,确保每个步骤都有明确的目标、交付物和依赖关系,从而提高任务执行的效率和质量。
|
||||
| 交付物名称 | 描述 | 负责人 | 完成日期 |
|
||||
|------------|------|--------|----------|
|
||||
| Service类修改列表 | 需要修改的Service类清单 | - | - |
|
||||
| 数据转换方案文档 | 实体类与Vo类的转换方案 | - | - |
|
||||
| 缓存策略文档 | 缓存Vo对象的策略和配置 | - | - |
|
||||
| 修改后的Service类源码 | 所有修改完成的Service类 | - | - |
|
||||
| WebSocket组件修改 | 修改后的WebSocket相关组件 | - | - |
|
||||
| Redis缓存清理工具/脚本 | 用于清理旧缓存数据的工具或脚本 | - | - |
|
||||
| 测试用例集 | 单元测试和集成测试用例 | - | - |
|
||||
| 测试执行报告 | 测试结果和问题记录 | - | - |
|
||||
| 更新后的项目文档 | 反映修改后的项目文档 | - | - |
|
||||
| 最终验收报告 | 项目完成情况的总结报告 | - | - |
|
||||
Reference in New Issue
Block a user