Table 关联数据自动加载功能,解决 N+1 查询问题。

何时使用

• 当表格中某列需要显示关联数据(如通过用户ID显示用户名)时
• 当需要批量加载关联数据以避免 N+1 查询问题时
• 当需要在多个表格间共享关联数据缓存时
• 当需要灵活控制关联数据的加载和渲染逻辑时

功能特性

• 批量加载: 自动收集所有需要加载的关联ID,一次性批量加载,避免 N+1 查询
• 自动去重: 智能去重,相同ID只加载一次
• 零反射: 使用委托方式访问字段值,性能最优
• 共享缓存: 支持跨表格共享关联数据缓存
• 三种用法: 支持 C# 类、Razor 组件、特性标注三种开发方式

使用方式

方式1: C# 类继承 RelationComponentBase

创建一个类继承 RelationComponentBase<TItem, TData>:

public class UserNameRelation : RelationComponentBase<Order, int>
{
    protected override Task OnLoadBatch(IEnumerable<int> userIds)
    {
        // 批量加载用户数据
        return Task.CompletedTask;
    }
    
    protected override RenderFragment RenderContent(int userId, Order order)
    {
        // 渲染内容
        return builder => builder.AddContent(0, "用户名");
    }
}

在 Table 中使用:

<PropertyColumn Property="c=>c.UserId" Title="用户">
    <UserNameRelation />
</PropertyColumn>

方式2: Razor 组件

创建 Razor 文件继承 RelationComponentBase<TItem, TData>:

@inherits RelationComponentBase<Employee, int>

@if (departments.TryGetValue(CurrentFieldValue, out var dept))
{
    <Tag>@dept.Name</Tag>
}

@code {
    protected override Task OnLoadBatch(IEnumerable<int> ids) 
    { 
        return Task.CompletedTask; 
    }
}

方式3: 特性标注

在实体类属性上添加 [RelationColumn] 特性:

public class Product
{
    [RelationColumn(typeof(CategoryNameRelation))]
    public int CategoryId { get; set; }
}