FreeSql (二十六)贪婪加载 Include、IncludeMany、Dto、ToList

贪婪加载顾名思议就是把全部要加载的东西一次性读取。html

本节内容为了配合【延时加载】而诞生,贪婪加载和他本该在一块儿介绍,开发项目的过程当中应该左右开弓,才能写出高质量的程序。sql

Dto 映射查询

Select<Tag>().Limit(10).ToList(a => new TestDto { id = a.Id, name = a.Title });
Select<Tag>().Limit(10).ToList(a => new TestDto());
Select<Tag>().Limit(10).ToList(a => new TestDto { });
Select<Tag>().Limit(10).ToList(a => new TestDto() { });
Select<Tag>().Limit(10).ToList<TestDto>();

这种映射支持单表/多表。性能

查找规则,查找属性名,会循环内部对象 _tables(join 查询后会增加),以 主表优先查,直到查到相同的字段。code

如:sqlite

A, B, C 都有 id,Dto { id, a1, a2, b1, b2 },A.id 被映射。也能够指定 id = C.id 映射。htm

友情提醒:在 dto 能够直接映射一个导航属性对象

导航属性 ManyToOne/OneToOne

ManyToOne/OneToOne 导航属性经过 ToList() 加载,这个方法有一个参数:includeNestedMembers。blog

参数说明:事务

false: 返回 2级 Join 的数据;内存

true: 返回全部层级深度 Join 的导航数据;

若是查询中已经使用了 a.Parent.Parent 相似表达式,则能够无需 LeftJoin 等操做。

如:

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

若是导航属性没有使用,又想加载,可以使用 Include 方法。

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

导航属性 OneToMany/ManyToMany

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

Select<Tag>().IncludeMany(a => a.Songs).ToList();
//这是 ManyToMany 关系的贪婪加载

OneToMany 的使用方法相同

IncludeMany 有第二个参数,能够进行二次查询前的修饰工做。

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

而后,其实在 then 那里,还能够继续进行向下 Include/IncludeMany。只要你喜欢,向下 100 层都没问题。

变异

变异的 IncludeMany,即便选择的不是导航属性,也能够贪婪加载。

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

支持联合键关系指定

好比 EFCore include 吧,如何只查询每项子集合的前几条数据,它只能够加载全部致使IO性能低下(若是某些子集合,有100条,200条),FreeSql 能够解决这个问题。

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

IncludeMany 扩展方法

前面介绍 ISelect 中进行贪婪加载集合属性数据,主数据与子数据查询必须在一个代码逻辑内完成。

当主数据已存在内存中,子数据怎么加载?因此咱们增长了 List<T> 扩展方法,示例以下:

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

这是一个扩展方法(IncludeMany),方法名与 ISelect.IncludeMany 同名,参数基本一致(除了须要额外传递 IFreeSql 对象参数),功能也一致(包括前面提到的变异)。

系列文章导航