Files
CN_Gather/tools
hongawen 7a8071c9d7 feat(report): 优化报告生成工具中的文档处理功能
- 在Docx4jUtil中添加enableUpdateFieldsOnOpen方法,确保Word打开时自动刷新页码等域
- 移除ItemAnchorAssembler中不必要的导入包,精简代码结构
- 重构谐波数据处理逻辑,添加谐波衍生值计算功能
- 实现固定占位符替换机制,支持谐波电压和功率表的动态填充
- 优化表格结构分离逻辑,使用空段落而非可见标题分隔多表
- 增强错误范围处理,移除单位后缀并优化谐波电流计算逻辑
- 添加全面的单元测试验证各种谐波检测场景的功能正确性
2026-07-07 22:49:46 +08:00
..
2025-11-04 14:35:16 +08:00

Tools 工具模块

这是CN_Gather项目的工具集合模块用于管理各种通用工具。每个工具作为独立的子模块拥有完整的MVC架构。

架构设计

tools/
├── report-generator/          # 报告生成工具
├── data-generator/           # 数据生成工具(未来扩展)
└── file-processor/          # 文件处理工具(未来扩展)

子模块说明

1. report-generator报告生成工具

  • 功能: 通用的文档模板处理和报告生成
  • 技术栈: Apache POI, docx4j
  • 特性:
    • 占位符替换
    • 书签定位插入
    • 动态表格生成
    • 多文档合并
    • 样式管理

2. data-generator数据生成工具

  • 功能: MySQL数据生成、测试数据构造
  • 状态: 待开发

3. file-processor文件处理工具

  • 功能: 文件转换、批量处理等
  • 状态: 待开发

设计原则

  1. 独立性: 每个工具子模块独立部署和使用
  2. 通用性: 脱离具体业务逻辑,提供纯技术能力
  3. 可扩展: 支持插件化扩展和自定义处理器
  4. 易集成: 提供简洁的API接口

使用方式

每个工具模块都提供HTTP接口和Java API两种使用方式

  • HTTP接口适合微服务架构跨语言调用
  • Java API适合同项目内直接依赖调用

模块间依赖

tools模块作为独立的工具集合尽量减少对其他业务模块的依赖主要依赖

  • 基础的Spring Boot框架
  • 通用工具库hutool等
  • 各工具特定的技术栈依赖