MartenDB 事件记录类型掩码规则支持解析

事件掩码功能概述

MartenDB 作为.NET生态中强大的事件溯源和文档数据库解决方案，提供了对敏感信息进行掩码处理的功能。这项功能允许开发者在存储或查询事件数据时，自动将特定字段（如用户姓名、身份证号等）替换为掩码值（如"****"），从而保护敏感信息不被泄露。

记录类型带来的挑战

在C# 9.0引入记录(record)类型后，越来越多的开发者选择使用不可变记录类型来表示事件数据。记录类型提供了简洁的语法和值语义，特别适合表示事件这种不可变数据。然而，MartenDB原有的掩码规则实现基于Action委托，这种设计假设事件对象是可变的，可以直接修改其属性。

当开发者尝试为记录类型事件添加掩码规则时，会遇到编译错误，因为记录类型不支持直接修改属性。例如以下代码无法工作：

options.Events.AddMaskingRuleForProtectedInformation<User>(x => x with { FullName = "****" });

解决方案设计

为解决这一问题，MartenDB社区提出了增加Func委托支持的方案。具体实现包括：

1. 新增FuncMasker类，专门处理不可变类型的掩码操作
2. 为EventGraph添加新的AddMaskingRuleForProtectedInformation重载方法
3. 保持与现有Action委托方案的兼容性

核心实现逻辑是：当检测到事件数据是记录类型时，使用Func委托创建新的不可变对象并替换原始数据，而非直接修改原有对象。

技术实现细节

FuncMasker类的关键实现如下：

internal class FuncMasker<T> : IMasker where T : notnull
{
    private readonly Func<T,T> _masking;

    public FuncMasker(Func<T,T> masking)
    {
        _masking = masking;
    }

    public bool TryMask(IEvent @event)
    {
        if (@event is IEvent<T> e)
        {
            e.Data = _masking(e.Data);
            return true;
        }
        return false;
    }
}

新增的方法重载简单明了：

public void AddMaskingRuleForProtectedInformation<T>(Func<T, T> func)
{
    ArgumentNullException.ThrowIfNull(func);
    _maskers.Add(new FuncMasker<T>(func));
}

使用示例

开发者现在可以这样为记录类型事件定义掩码规则：

// 定义记录类型事件
public record UserEvent(Guid Id, string FullName, string Email);

// 配置掩码规则
options.Events.AddMaskingRuleForProtectedInformation<UserEvent>(x => 
    x with { 
        FullName = "****", 
        Email = "****@****.***" 
    });

最佳实践建议

1. 对于可变类(class)类型事件，继续使用Action委托方案
2. 对于不可变记录(record)类型事件，使用新的Func委托方案
3. 在掩码规则中，建议同时处理所有相关敏感字段
4. 考虑为不同的事件类型定义不同的掩码策略

总结

这一改进使MartenDB能够更好地支持现代C#开发实践，特别是不可变数据模型。它展示了如何在不破坏现有功能的情况下扩展框架能力，同时也体现了MartenDB社区对开发者需求的快速响应。随着.NET生态中不可变数据模型的普及，这类改进将变得越来越重要。