FreeSql

Table of Contents

1、导航属性 ManyToOne/OneToOne
2、导航属性 OneToMany/ManyToMany/PgArrayToMany
3、变异
4、IncludeMany 扩展方法
5、子表ToList
6、IncludeMany 两种方式对比
参考资料

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

中文 | English

1、导航属性 ManyToOne/OneToOne

ManyToOne/OneToOne 导航属性通过 ToList(includeNestedMembers: false) 加载，参数说明：

false: 返回 2级 Join 的导航数据（默认）；

true: 返回所有层级深度 Join 的导航数据（未使用的导航数据不会返回）；

Select<Tag>().Include(a => a.Parent.Parent).ToList(true);

Select<Tag>().Where(a => a.Parent.Parent.Name == "1").ToList();
//这样写，不需要再标记 Include，解析表达式时自动处理

Select<Tag>().LeftJoin(a => a.Parent.Id == a.ParentId && a.Parent.xxx > 0).ToList();
//这样写，给 ManyToOne 增加过滤条件

2、导航属性 OneToMany/ManyToMany/PgArrayToMany

IncludeMany 贪婪加载集合的导航属性，其实是分两次查询，在 ToList 后进行了数据重装。

Select<Tag>().IncludeMany(a => a.Songs).ToList();

Select<Tag>().IncludeMany(a => a.Songs, then => then.Where(song => song.xxx > 0)).ToList();
//这样写，给 OneToMany/ManyToMany 增加过滤条件

IncludeMany 有第二个参数，可以进行二次查询前的修饰工作。

Select<Tag>().IncludeMany(a => a.Songs, 
    then => then.Where(song => song.User == "admin")).ToList();

其实在 then 那里，还可以继续进行向下 Include/IncludeMany。只要你喜欢，向下 100 层也没问题。

IncludeByPropertyName 可以实现动态 Include/IncludeMany

3、变异

没有配置导航关系，也可以贪婪加载。

Select<Tag>().IncludeMany(a => a.TestManys.Where(b => b.TagId == a.Id));

只查询每项子集合的前几条数据，避免像EfCore加载所有数据导致IO性能低下（比如某商品下有2000条评论）。

Select<Tag>().IncludeMany(a => a.TestManys.Take(10));

子集合返回部分字段，避免字段过多的问题。

Select<Tag>().IncludeMany(a => a.TestManys.Select(b => new TestMany { Title = b.Title ... }));

4、IncludeMany 扩展方法

当主数据已存在内存中，子数据怎么加载？所以我们增加了 List<T> 扩展方法，示例如下：

new List<Song>(new[] { song1, song2, song3 })
    .IncludeMany(fsql, a => a.Tags);

new List<Song>(new[] { song1, song2, song3 })
    .IncludeByPropertyName(
        orm: fsql, 
        property: "Tags", 
        where: "ParentId=Code", 
        take: 5, 
        select: "id,name",
        then => then.IncludeByPropertyName("Parent")
    );
//v3.2.605+

5、子表ToList

//最多执行3次 SQL
fsql.Select<Topic>().ToList(a => new
{
    all = a,
    list1 = fsql.Select<T2>().ToList(),
    list2 = fsql.Select<T2>().Where(b => b.TopicId == a.Id).ToList()
});

//分组之后，最多执行3次 SQL
fsql.Select<Topic>()
    .GroupBy(a => new { a.Author })
    .WithTempQuery(a => new { Author = a.Key.Author, Count = a.Count() })
    .ToList(a => new {
        a.Author, a.Count,
        list1 = fsql.Select<T2>().ToList(),
        list2 = fsql.Select<T2>().Where(b => b.Author == a.Author).ToList()
    });

6、IncludeMany 两种方式对比

方式一（IncludeMany 扩展方法）：

var list = fsql.Select<SysModule>()
    .Page(1, 10)
    .ToList(a => new { Id = a.Id }) //查询数据 id
    .Select(a => new SysModule { Id = a.Id }).ToList() //内存操作
    .IncludeMany(fsql, a => a.Permissions, then => then.Include(a => a.Button));

SELECT a."Id" as1 
FROM "SysModule" a 
limit 0,10

SELECT a."Id", a."SysModuleId", a."SysModuleButtonId", a."Status", 
a__Button."Id" as5, a__Button."Name", a__Button."EventName", a__Button."EnCode", a__Button."Icon", a__Button."Sort", a__Button."CreateTime" 
FROM "SysModulePermission" a 
LEFT JOIN "SysModuleButton" a__Button ON a__Button."Id" = a."SysModuleButtonId" 
WHERE ((a."SysModuleId") in ('menu1','menu2'))

方式二（直接 IncludeMany + ToList）：

var list = fsql.Select<SysModule>()
    .IncludeMany(m => m.Permissions, then => then.Include(a => a.Button))
    .Page(1, 10)
    .ToList();

SELECT a."Id", a."ParentId", a."Name", a."Icon", a."UrlAddress", a."IsShow", a."Sort", a."Description", a."CreateTime" 
FROM "SysModule" a 
limit 0,10

SELECT a."Id", a."SysModuleId", a."SysModuleButtonId", a."Status", 
a__Button."Id" as5, a__Button."Name", a__Button."EventName", a__Button."EnCode", a__Button."Icon", a__Button."Sort", a__Button."CreateTime" 
FROM "SysModulePermission" a 
LEFT JOIN "SysModuleButton" a__Button ON a__Button."Id" = a."SysModuleButtonId" 
WHERE ((a."SysModuleId") in ('menu1','menu2'))

案例：查询 Vod 表，分类1、分类2、分类3 各10条数据

class Vod {
    public Guid Id { get; set; }
    public int TypeId { get; set; }
}

//定义临时类，也可以是 Dto 类
class Dto {
    public int TypeId { get; set; }
    public List<Vod> Vods { get; set; }
}

var dto = new [] { 1,2,3 }.Select(a => new Dto { TypeId = a }).ToList();
dto.IncludeMany(fsql, d => d.Vods.Take(10).Where(vod => vod.TypeId == d.TypeId));

//执行后，dto 每个元素.Vods 将只有 10条记录

1、导航属性 ManyToOne/OneToOne

2、导航属性 OneToMany/ManyToMany/PgArrayToMany

3、变异

4、IncludeMany 扩展方法

5、子表ToList

6、IncludeMany 两种方式对比

参考资料

Basic

使用指南

学习与交流

信息