FreeSql 新功能介绍:贪婪加载五种方法
前言
FreeSql 在经过6个月的开发和朋友们的工作实践,不断的改进创新,目前拥有1500个左右单元测试方法,且每个方法内又复盖不同的测试面。
今天介绍 FreeSql 各种贪婪加载的姿势,作下总结。本节内容对应的还有【延时加载】,贪婪加载和他本该在一起介绍,开发项目的过程中应该双管齐下,才能写出高质量的程序。有关延时加载,日后有空再单独编写。
FreeSql是一个功能强大的NETStandard库,用于对象关系映射程序(O/RM),便于开发人员能够使用 .NETStandard 对象来处理数据库,不必经常编写大部分数据访问代码。
- [√] 支持 CodeFirst 迁移;
- [√] 支持 DbFirst 从数据库导入实体类,支持三种模板生成器;
- [√] 采用 ExpressionTree 高性能读取数据;
- [√] 支持深入的类型映射,比如pgsql的数组类型,堪称匠心制作;
- [√] 支持丰富的表达式函数;
- [√] 支持导航属性查询,和延时加载;
- [√] 支持同步/异步数据库操作方法,丰富多彩的链式查询方法;
- [√] 支持读写分离、分表分库,租户设计;
- [√] 支持多种数据库,MySql/SqlServer/PostgreSQL/Oracle/Sqlite;
贪婪方法一: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 查询后会增长),以 主表优先查,直到查到相同的字段。
如:
A, B, C 都有 id,Dto { id, a1, a2, b1, b2 },A.id 被映射。也可以指定 id = C.id 映射。
还可以在 dto 可以直接映射一个导航属性。
对头,通过映射某对象,也可以实现贪婪加载,这个功能是在数据库查询前映射的,而不是查回所有数据再重组。
贪婪方法二:导航属性 ManyToOne/OneToOne
ManyToOne/OneToOne 导航属性通过 ToList() 加载,这个方法有一个参数:includeNestedMembers。
参数说明:
false: 返回 2级 Join 的数据;
true: 返回所有层级深度 Join 的导航数据;
如果查询中已经使用了 a.Parent.Parent 类似表达式,则可以无需 LeftJoin 等操作。
如:
class Tag {
[Column(IsIdentity = true)]
public int Id { get; set; }
public string Name { get; set; }
public int? Parent_id { get; set; }
public virtual Tag Parent { get; set; }
}
Select<Tag>().Where(a => a.Parent.Name == "1").ToList();
//这样写,不需要再标记 Join,解析表达式时自动处理成 LeftJoin
如果导航属性没有使用,又想加载,可使用 Include 方法。(不好理解可跳过,也许只能在使用中体会)
Select<Tag>().Include(a => a.Parent).ToList();
贪婪方法三:导航属性 ManyToMany
IncludeMany 贪婪加载集合的导航属性,其实是分两次查询,在 ToList 后进行了数据重装。
class Song {
[Column(IsIdentity = true)]
public int Id { get; set; }
public string Title { get; set; }
public virtual ICollection<Tag> Tags { get; set; }
}
class Song_tag {
public int Song_id { get; set; }
public virtual Song Song { get; set; }
public int Tag_id { get; set; }
public virtual Tag Tag { get; set; }
}
Select<Tag>().IncludeMany(a => a.Songs).ToList();
//这是 ManyToMany 关系的贪婪加载
IncludeMany 有第二个参数,可以进行第二次查询前的修饰工作。
Select<Tag>().IncludeMany(a => a.Songs,
then => then.Where(song => song.User == "admin")).ToList();
然后,其实在 then 那里,还可以继续进行向下 Include/IncludeMany。只要你喜欢,向下 100 层都没问题。
贪婪方法四:导航属性 OneToMany
大体与 ManyToMany 用法相同,只是它没有通过中间表查询数据。
贪婪方法五:变异属性 OneToMany
变异的 IncludeMany,即使选择的不是导航属性,也可以贪婪加载。适合一些些老项目,导航属性配置不规则的,也可以一对多贪婪加载。
为了方便理解,我创建了下面两个类,他们没有配置导航关系。你可能会问为啥不配置?我这样是为了直观理解、这样是为了直观理解、这样是为了直观理解!!
class Order {
public Guid id { get; set; }
public string xxx { get; set; }
public List<OrderDetail> Details { get; set; }
}
class OrderDetail{
public Guid id { get; set; }
public string detailTestField { get; set; }
public Guid OrderId { get; set; }
}
Select<Order>().IncludeMany(a => a.Details.Where(b => b.OrderId == a.Id)).ToList();
OK,这样查询 order 时,会把 details 也查询回来。
完结
我们有考虑在 then 那里实现 limit(5) 功能,场景是只查询每个子记录的前5条回来(待实现)。
开源地址:https://github.com/2881099/FreeSql
感谢一直支持的朋友们!