FastCloner 项目中的全局类型忽略功能解析

FastCloner 项目中的全局类型忽略功能解析

FastCloner Fast deep cloning library for .NET 8+. Zero-config, works out of the box. 项目地址: https://gitcode.com/gh_mirrors/fa/FastCloner

在对象克隆操作中，事件处理程序的克隆往往会导致难以追踪的bug，特别是当使用代码生成工具时，开发者可能无法直接修改生成的代码来添加忽略标记。FastCloner 3.3.6版本引入的全局类型忽略功能为解决这类问题提供了优雅的解决方案。

问题背景

在.NET开发中，我们经常会遇到需要深度克隆对象的场景。FastCloner作为一款高性能的对象克隆库，能够自动处理大多数类型的克隆操作。然而，某些特定类型的成员（如事件处理程序）在克隆时可能会引发问题：

1. 事件处理程序克隆后可能导致意外的多播委托
2. 使用Fody等代码生成工具生成的类成员无法直接添加忽略属性
3. 特别是INotifyPropertyChanged接口的PropertyChanged事件，几乎在所有情况下都不需要被克隆

解决方案

FastCloner 3.3.6版本新增了全局类型忽略机制，通过以下API实现：

// 忽略单个类型
FastCloner.IgnoreType(typeof(PropertyChangedEventHandler));

// 批量忽略多个类型
FastCloner.IgnoreTypes(new[] { typeof(Type1), typeof(Type2) });

// 检查类型是否被忽略
bool isIgnored = FastCloner.IsTypeIgnored(typeof(SomeType));

// 获取当前所有被忽略的类型
HashSet<Type> ignoredTypes = FastCloner.GetIgnoredTypes();

// 清除所有已忽略的类型设置
FastCloner.ClearIgnoredTypes();

实现原理

该功能的实现涉及以下关键技术点：

1. 运行时动态修改：表达式编译器被修改以支持运行时动态调整忽略类型列表
2. 缓存机制：当忽略类型列表发生变化时，相关缓存会被自动清除
3. 线程安全：所有操作都考虑了多线程环境下的安全性

最佳实践

1. 初始化时机：建议在应用程序启动时一次性配置所有需要忽略的类型
2. 性能考量：频繁修改忽略列表会导致缓存失效，影响性能
3. 典型用例：对于PropertyChanged事件，建议在程序启动时添加以下代码：

FastCloner.IgnoreType(typeof(PropertyChangedEventHandler));

4. 代码生成场景：特别适用于处理Fody等工具生成的代码，开发者无需修改生成的代码即可控制克隆行为

注意事项

1. 虽然支持运行时动态修改忽略列表，但频繁操作会影响性能
2. 清除忽略类型列表会同时清除FastCloner的缓存，导致后续克隆操作需要重新编译表达式树
3. 对于特定场景下需要克隆的事件，仍可使用[FastClonerIgnore]属性进行精细控制

这项功能的加入使得FastCloner在处理现代.NET开发中的各种复杂场景时更加灵活和强大，特别是解决了代码生成工具带来的特殊挑战。

FastCloner Fast deep cloning library for .NET 8+. Zero-config, works out of the box. 项目地址: https://gitcode.com/gh_mirrors/fa/FastCloner