如何构建适配多组件键值结构的通用Survey字典类框架？

你的思路完全可行，而且这正是实现这类通用字典框架的标准做法！通过将核心逻辑抽象为泛型基类，外部组件只需要基于基类指定自己的键值类型即可，完美避免重复开发。下面我来一步步给你拆解改造方案：

首先把原来的sealed Survey类改成泛型基类，把Key和Value作为泛型参数，同时把核心的存储、写入逻辑保留在基类中。注意要去掉sealed修饰符，让外部组件可以继承：

// 放在Common DLL中的泛型基类
public class SurveyBase<TKey, TValue>
{
    #region Private/Protected Objects
    protected Dictionary<TKey, TValue> survey;
    private int maxLines = 50000;

    protected SurveyBase()
    {
        survey = new Dictionary<TKey, TValue>();
    }

    private bool AllowLogging => survey.Count < maxLines; // 原代码逻辑疑似反了，这里按"未达上限则允许写入"调整，可根据实际需求修改
    #endregion

    // 核心写入逻辑，统一保留在基类中
    protected void WriteData(TKey key, TValue value)
    {
        if (AllowLogging)
        {
            if (!survey.ContainsKey(key))
                survey.Add(key, value);
            else
                survey[key] = value;
        }
    }

    // 其他核心方法（如读取、清理数据等）也可统一放在基类中
}

为了向后兼容，原来的Survey可以作为泛型基类的一个子类，指定原来的SurveyKey和SurveyValue：

// 原有Survey的兼容实现，放在Common DLL中
public sealed class Survey : SurveyBase<SurveyKey, SurveyValue>
{
    public Survey() : base() { }

    // 对外暴露WriteData方法（保持原有调用方式）
    public new void WriteData(SurveyKey key, SurveyValue value)
    {
        base.WriteData(key, value);
    }
}

// 原有的SurveyValue和SurveyKey保持不变，放在Common DLL中
public sealed class SurveyValue
{
    public SurveyValue(int? value = null, string detail = null)
    {
        Detail = detail;
        Value = value;
    }
    public string Detail { get; private set; }
    public int? Value { get; private set; }
}

public sealed class SurveyKey : Tuple<string, string, string, string>
{
    public SurveyKey(string Signal, string SignalType, string Name, string OverallType) 
        : base(Signal, SignalType, Name, OverallType) { }
    public string Signal => Item1;
    public string SignalType => Item2;
    public string Name => Item3;
    public string OverallType => Item4;
}

现在外部组件只需要基于SurveyBase子类化，指定自己的键值类型即可：

组件1：5元组Key + 三元结构Value #

首先定义组件1的Key和Value类：

// 组件1自定义的5元组Key
public sealed class Component1SurveyKey : Tuple<string, string, string, string, int>
{
    public Component1SurveyKey(string signal, string signalType, string name, string overallType, int version)
        : base(signal, signalType, name, overallType, version) { }

    public string Signal => Item1;
    public string SignalType => Item2;
    public string Name => Item3;
    public string OverallType => Item4;
    public int Version => Item5;
}

// 组件1自定义的三元结构Value
public sealed class Component1SurveyValue
{
    public Component1SurveyValue(int? value = null, string detail = null, DateTime timestamp = default)
    {
        Value = value;
        Detail = detail;
        Timestamp = timestamp;
    }
    public int? Value { get; private set; }
    public string Detail { get; private set; }
    public DateTime Timestamp { get; private set; }
}

// 组件1的Survey实现
public sealed class Component1Survey : SurveyBase<Component1SurveyKey, Component1SurveyValue>
{
    public Component1Survey() : base() { }

    public void WriteData(Component1SurveyKey key, Component1SurveyValue value)
    {
        base.WriteData(key, value);
    }
}

组件2：(string, int, string)3元组Key + 原有SurveyValue #

组件2可以直接用.NET内置值元组作为Key，不需要自定义类——因为值元组已经默认实现了正确的相等性和哈希码：

// 组件2的Survey实现，直接用(string, int, string)作为Key，复用原有SurveyValue
public sealed class Component2Survey : SurveyBase<(string Signal, int Id, string Category), SurveyValue>
{
    public Component2Survey() : base() { }

    public void WriteData((string Signal, int Id, string Category) key, SurveyValue value)
    {
        base.WriteData(key, value);
    }
}

• TKey的相等性：确保你的Key类型（不管是自定义类还是元组）正确实现了Equals和GetHashCode。继承Tuple或使用.NET内置值元组时，这一点已经自动满足；如果是自定义类，记得重写这两个方法，否则字典无法正确识别重复键。
• 访问权限控制：基类中的survey字典我改成了protected，如果不需要子类直接操作字典，可以改成private，只通过基类提供的方法来操作，更安全。
• 扩展灵活性：如果后续组件需要特殊逻辑，可以在子类中重写基类的virtual方法，或者添加自己的扩展方法，完全不会影响Common DLL中的核心逻辑。

这个方案完美实现了你的需求：核心功能全部保留在Common DLL中，外部组件只需要定义自己的键值类型，子类化泛型基类即可，彻底避免重复开发！

内容的提问来源于stack exchange，提问作者Allan L