Ivy Wallet 数据层重构：汇率同步功能的设计与实现

概述

在金融类应用开发中，汇率同步功能是核心模块之一。Ivy Wallet 项目近期对其汇率同步机制进行了架构升级，从传统的Action类模式迁移到了更现代的Repository和UseCase模式。本文将深入分析这一重构过程的技术细节与设计思路。

重构背景

原代码中的汇率同步功能采用了一个名为SyncExchangeRatesAct的类实现，这种设计存在几个明显问题：

1. 业务逻辑与数据访问耦合度过高
2. 缺乏清晰的层级划分
3. 错误处理不够规范
4. 测试覆盖率不足

新架构通过分层设计解决了这些问题，使代码更易于维护和扩展。

架构设计

新架构采用典型的三层设计模式：

1. 数据源层(DataSource)

• 远程数据源：通过Ktor实现HTTP请求获取最新汇率
• 本地数据源：使用Room数据库持久化汇率数据

2. 仓储层(Repository)

ExchangeRatesRepository作为中间层，具有以下职责：

• 协调远程和本地数据源
• 数据格式转换
• 提供统一的数据访问接口
• 处理汇率覆盖(override)逻辑

3. 用例层(UseCase)

SyncExchangeRatesUseCase专注于业务逻辑：

• 决定何时需要同步
• 处理同步流程
• 错误恢复机制

关键技术实现

类型安全设计

新实现强调类型安全，主要体现在：

1. 定义明确的领域模型
2. 使用密封类(sealed class)表示不同状态
3. 数据转换时进行严格的类型检查

错误处理机制

采用Arrow库的Either类型实现类型化错误处理：

• 定义业务可能出现的所有错误类型
• 每个函数都明确声明可能返回的错误
• 避免使用异常控制流程

测试策略

全面的测试覆盖包括：

1. 单元测试：验证各组件独立功能
2. 集成测试：验证组件间协作
3. 采用Given-When-Then模式编写测试用例

迁移过程

从旧架构迁移到新架构的关键步骤：

1. 逐步替换旧代码的引用点
2. 确保功能一致性
3. 验证性能表现
4. 最终移除旧代码

总结

通过这次重构，Ivy Wallet的汇率同步功能获得了以下改进：

1. 代码结构更清晰，职责分离更明确
2. 错误处理更规范，可维护性提高
3. 测试覆盖率显著提升
4. 为未来扩展奠定良好基础

这种架构模式不仅适用于汇率同步功能，也可以作为项目中其他类似功能重构的参考模板。