feat(EmitHelper): use cache to reduce dynamic type creation. (#7797)

* doc: 更新用法文档

* doc: 增加提示信息

* refactor: 移除已弃用参数

* refactor: 重命名缓存变量

* feat: 增加缓存防止生成过多动态类型

* doc: 更新示例

* chore: bump version 10.5.0-beta02

* refactor: 增加 readonly 关键字

Author: ArgoZhang

src/BootstrapBlazor.Server/Components/Samples/Table/TablesDynamic.razor.cs

@@ -47,6 +47,8 @@ private void CreateContext()
         DataTableDynamicContext = new DataTableDynamicContext(UserData, (context, col) =>
         {
             var propertyName = col.GetFieldName();
+            // 使用 Text 设置显示名称示例
+            col.Text = FooLocalizer[propertyName];
             if (propertyName == nameof(Foo.DateTime))
             {
                 context.AddRequiredAttribute(nameof(Foo.DateTime));
@@ -56,8 +58,6 @@ private void CreateContext()
             else if (propertyName == nameof(Foo.Name))
             {
                 context.AddRequiredAttribute(nameof(Foo.Name), FooLocalizer["Name.Required"]);
-                // 使用 Text 设置显示名称示例
-                col.Text = FooLocalizer[nameof(Foo.Name)];
             }
             else if (propertyName == nameof(Foo.Count))
             {

src/BootstrapBlazor/BootstrapBlazor.csproj

@@ -1,7 +1,7 @@
 <Project Sdk="Microsoft.NET.Sdk.Razor">
 
   <PropertyGroup>
-    <Version>10.5.0-beta01</Version>
+    <Version>10.5.0-beta02</Version>
   </PropertyGroup>
 
   <ItemGroup>

src/BootstrapBlazor/Dynamic/DataTableDynamicContext.cs

@@ -40,7 +40,7 @@ public class DataTableDynamicContext : DynamicObjectContext
     /// <para lang="zh">负责将 DataRow 与 Items 关联起来方便查找提高效率</para>
     /// <para lang="en">Responsible for associating DataRow with Items to facilitate lookup and improve efficiency</para>
     /// </summary>
-    private ConcurrentDictionary<Guid, (IDynamicObject DynamicObject, DataRow Row)> Caches { get; } = new();
+    private readonly ConcurrentDictionary<Guid, (IDynamicObject DynamicObject, DataRow Row)> _dataCache = new();
 
     /// <summary>
     /// <para lang="zh">添加行回调委托</para>
@@ -90,7 +90,20 @@ public DataTableDynamicContext(DataTable table, Action<DataTableDynamicContext,
         [ExcludeFromCodeCoverage]
         Type CreateType()
         {
-            var dynamicType = EmitHelper.CreateTypeByName($"BootstrapBlazor_{nameof(DataTableDynamicContext)}_{GetHashCode()}", cols, typeof(DataTableDynamicObject), OnColumnCreating);
+            // Emit 生成动态类 (使用缓存)
+            var columnNames = string.Join('|', table.Columns.Cast<DataColumn>().Select(static c => $"{c.ColumnName}:{c.DataType.FullName}"));
+            var cacheKey = $"BootstrapBlazor-{nameof(DataTableDynamicContext)}-{columnNames}";
+            var dynamicType = CacheManager.GetDynamicObjectTypeByName(cacheKey, cols, OnColumnCreating, out var cached);
+
+            // 缓存命中时仍需调用回调以处理列属性
+            if (cached && AddAttributesCallback != null)
+            {
+                foreach (var col in cols)
+                {
+                    AddAttributesCallback?.Invoke(this, col);
+                }
+            }
+
             return dynamicType ?? throw new InvalidOperationException();
         }
     }
@@ -136,7 +149,7 @@ public override IEnumerable<IDynamicObject> GetItems()
 
     private List<IDynamicObject> BuildItems()
     {
-        Caches.Clear();
+        _dataCache.Clear();
         var ret = new List<IDynamicObject>();
         foreach (DataRow row in DataTable.Rows)
         {
@@ -155,7 +168,7 @@ private List<IDynamicObject> BuildItems()
 
                     d.Row = row;
                     d.DynamicObjectPrimaryKey = Guid.NewGuid();
-                    Caches.TryAdd(d.DynamicObjectPrimaryKey, (d, row));
+                    _dataCache.TryAdd(d.DynamicObjectPrimaryKey, (d, row));
                     ret.Add(d);
                 }
             }
@@ -203,7 +216,7 @@ public override async Task AddAsync(IEnumerable<IDynamicObject> selectedItems)
             var indexOfRow = 0;
             var item = selectedItems.FirstOrDefault();
 
-            if (item != null && Caches.TryGetValue(item.DynamicObjectPrimaryKey, out var c))
+            if (item != null && _dataCache.TryGetValue(item.DynamicObjectPrimaryKey, out var c))
             {
                 indexOfRow = DataTable.Rows.IndexOf(c.Row);
             }
@@ -232,7 +245,7 @@ public override async Task AddAsync(IEnumerable<IDynamicObject> selectedItems)
             Items?.Insert(indexOfRow, dynamicObject);
 
             // 缓存更新数据
-            Caches.TryAdd(dynamicObject.DynamicObjectPrimaryKey, (dynamicObject, row));
+            _dataCache.TryAdd(dynamicObject.DynamicObjectPrimaryKey, (dynamicObject, row));
         }
     }
 
@@ -252,15 +265,15 @@ public override async Task<bool> DeleteAsync(IEnumerable<IDynamicObject> items)
             var changed = false;
             foreach (var item in items)
             {
-                if (Caches.TryGetValue(item.DynamicObjectPrimaryKey, out var row))
+                if (_dataCache.TryGetValue(item.DynamicObjectPrimaryKey, out var row))
                 {
                     changed = true;
 
                     // 删除数据源
                     DataTable.Rows.Remove(row.Row);
 
                     // 清理缓存
-                    Caches.TryRemove(item.DynamicObjectPrimaryKey, out _);
+                    _dataCache.TryRemove(item.DynamicObjectPrimaryKey, out _);
 
                     // 清理 Table 组件数据源
                     Items?.Remove(item);
@@ -289,7 +302,7 @@ public override async Task<bool> DeleteAsync(IEnumerable<IDynamicObject> items)
     private Task OnCellValueChanged(IDynamicObject item, ITableColumn column, object? val)
     {
         // 更新内部 DataRow
-        if (Caches.TryGetValue(item.DynamicObjectPrimaryKey, out var cacheItem))
+        if (_dataCache.TryGetValue(item.DynamicObjectPrimaryKey, out var cacheItem))
         {
             cacheItem.Row[column.GetFieldName()] = val;
             Items = null;

src/BootstrapBlazor/Services/CacheManager.cs

@@ -10,6 +10,7 @@
 using System.Globalization;
 using System.Linq.Expressions;
 using System.Reflection;
+using System.Reflection.Emit;
 
 #if NET8_0_OR_GREATER
 using System.Runtime.CompilerServices;
@@ -764,4 +765,18 @@ public static object GetFormatterInvoker(Type type, Func<object, Task<string?>>
 
     private static Func<TType, Task<string?>> InvokeFormatterAsync<TType>(Func<object?, Task<string?>> formatter) => new(v => formatter(v));
     #endregion
+
+    internal static Type? GetDynamicObjectTypeByName(string key, IEnumerable<ITableColumn> cols, Func<ITableColumn, IEnumerable<CustomAttributeBuilder>>? creatingCallback, out bool cached)
+    {
+        var created = false;
+        var type = Instance.GetOrCreate(key, _ =>
+        {
+            created = true;
+            return EmitHelper.CreateTypeByName($"BootstrapBlazor_{nameof(DataTableDynamicContext)}_{key}", cols, typeof(DataTableDynamicObject), creatingCallback);
+        });
+
+        // 是否从缓存中获取到的值
+        cached = !created;
+        return type;
+    }
 }