Marten项目中的Daemon自动化测试体验优化

背景介绍

Marten是一个.NET平台上的PostgreSQL文档数据库和事件存储库。在最新版本中，开发团队对Daemon(守护进程)的自动化测试体验进行了重要改进，特别是针对投影(Projection)和订阅(Subscription)的管理功能。

核心改进内容

1. 投影协调器增强

在自动化测试场景中，经常需要停止和重新启动所有投影和订阅。为此，团队为IProjectionCoordinator接口新增了两个关键方法：

• StartAllAsync() - 启动所有投影和订阅
• StopAllAsync() - 停止所有投影和订阅

这两个方法极大地简化了测试过程中对投影状态的管理，使得测试代码更加简洁明了。

2. 数据重置功能改进

ResetAllData()方法现在会自动处理投影的停止和重启操作。这意味着在测试中重置数据时，不再需要手动管理投影状态，减少了样板代码和维护成本。

3. 事件数据清理修复

修复了IDocumentCleaner.DeleteAllEventDataAsync()方法的一个严重问题 - 该方法之前未能正确删除事件进度(event progression)数据。这个修复确保了在清理事件数据时，相关进度信息也能被正确清除，保证了测试环境的干净状态。

此外，该方法现在还会自动：

• 停止Daemon进程
• 在清理完成后重新启动之前运行的进程

4. 宿主(IHost)扩展方法

为了方便使用，团队为IHost接口添加了几个实用的扩展方法：

• StartAllProjectionsAndSubscriptionsAsync() - 启动所有投影和订阅
• StopAllProjectionsAndSubscriptionsAsync() - 停止所有投影和订阅
• StartDaemonsAndWaitForNonStaleData() - 启动Daemon并等待数据变为最新状态

这些方法封装了常见的测试模式，使得测试代码更加直观和易于维护。

技术价值

这些改进为Marten用户带来了显著的测试便利性：

1. 简化测试代码：减少了管理投影状态的样板代码
2. 提高测试可靠性：修复了事件数据清理的缺陷，确保测试环境一致性
3. 增强可维护性：通过标准化的方法封装常见测试模式
4. 提升开发体验：更直观的API设计降低了学习和使用成本

实际应用场景

假设你正在编写一个测试，需要验证投影的行为：

[Fact]
public async Task test_projection_behavior()
{
    // 传统方式需要手动管理投影状态
    // 新方式只需一行代码
    await theHost.StartAllProjectionsAndSubscriptionsAsync();
    
    // 执行测试操作...
    
    // 重置测试数据时自动处理投影状态
    await theStore.Advanced.ResetAllData();
}

这些改进特别适合：

• 集成测试
• 端到端测试
• 长时间运行的测试套件
• CI/CD流水线中的自动化测试

总结

Marten对Daemon自动化测试体验的改进，体现了项目对开发者体验的持续关注。通过提供更完善的API和修复关键问题，使得基于Marten的应用程序测试更加简单可靠。这些变化将帮助开发团队编写更健壮、更易维护的测试代码，从而提高整体软件质量。