update

28810
2020-04-06 20:02:51 +08:00
parent 33e2e12a8e
commit 1e1605ce3d

@@ -1,73 +1,19 @@
## 1、Dto 映射查询
## 1、导航属性 ManyToOne
```csharp
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>();
Select<Tag>().Limit(10).ToList(a => new TestDto { id = a.Id, name = a.Title });
//相当于先映射 TestDto再映射 a.Id, a.Title
//注意v0.11.6 以前的版本是只映射 a.Id, a.Title
//注意v0.11.20 如果 new 本实体,则不附加所有字段
fsql.Select<Song>().ToList(a => new DTO { xxx = a.ext })
//情况1附加所有映射再额外映射 ext返回 List<DTO>
fsql.Select<Song>().ToList(a => new Song { id = a.id })
//情况2只查询 id返回 List<Song>
fsql.Select<Song>().ToList(a => new { id = a.id })
//情况3只查询 id返回 List<匿名对象>
fsql.Select<Song>().ToList(a => new DTO(a.id))
//情况4只查询 id返回 List<DTO>
fsql.Select<Song>().ToList(a => new DTO(a.id) { xxx = a.ext })
//情况5查询 id, ext返回 List<DTO>
fsql.Select<Song>().ToList(a => new Song(a.id))
//情况6查询 id返回 List<Song>
fsql.Select<Song>().ToList(a => new Song(a.id) { xxx = a.ext })
//情况7查询 id, ext返回 List<Song>
```
这种映射支持单表/多表,在查询数据之前映射(不是先查询所有字段再到内存映射)
查找规则,查找属性名,会循环内部对象 _tablesjoin 查询后会增长),以 主表优先查,直到查到相同的字段。
如:
A, B, C 都有 idDto { id, a1, a2, b1, b2 }A.id 被映射。也可以指定 id = C.id 映射。
> 友情提醒:在 dto 可以直接映射一个导航属性
## 2、导航属性 ManyToOne/OneToOne
ManyToOne/OneToOne 导航属性通过 ToList() 加载这个方法有一个参数includeNestedMembers。
参数说明:
ManyToOne 导航属性通过 ToList() 加载includeNestedMembers 参数说明:
false: 返回 2级 Join 的数据;
true: 返回所有层级深度 Join 的导航数据;
如果查询中已经使用了 a.Parent.Parent 类似表达式,则可以无需 LeftJoin 等操作。
如:
```csharp
Select<Tag>().Include(a => a.Parent).ToList();
Select<Tag>().Where(a => a.Parent.Name == "1").ToList();
//这样写,不需要再标记 Join解析表达式时自动处理成 LeftJoin
```
如果导航属性没有使用,又想加载,可使用 Include 方法。
```csharp
Select<Tag>().Include(a => a.Parent).ToList();
```
## 3、导航属性 OneToMany/ManyToMany
## 2、导航属性 OneToMany/ManyToMany
IncludeMany 贪婪加载集合的导航属性,其实是分两次查询,在 ToList 后进行了数据重装。
@@ -76,8 +22,6 @@ Select<Tag>().IncludeMany(a => a.Songs).ToList();
//这是 ManyToMany 关系的贪婪加载
```
> OneToMany 的使用方法相同
IncludeMany 有第二个参数,可以进行二次查询前的修饰工作。
```csharp
@@ -87,16 +31,14 @@ Select<Tag>().IncludeMany(a => a.Songs,
然后,其实在 then 那里,还可以继续进行向下 Include/IncludeMany。只要你喜欢向下 100 层都没问题。
## 4、变异
## 3、变异
变异的 IncludeMany,即使选择的不是导航属性,也可以贪婪加载。
变异的 IncludeMany 使用的集合属性未配置导航,也可以贪婪加载。
```csharp
Select<Tag>().IncludeMany(a => a.TestManys.Where(b => b.TagId == a.Id));
```
> 支持联合键关系指定
只查询每项子集合的前几条数据避免像EfCore加载所有数据导致IO性能低下比如某商品下有2000条评论
```csharp
@@ -109,9 +51,9 @@ Select<Tag>().IncludeMany(a => a.TestManys.Take(10));
Select<Tag>().IncludeMany(a => a.TestManys.Select(b => new TestMany { Title = b.Title ... }));
```
## 5、IncludeMany 扩展方法
## 4、IncludeMany 扩展方法
前面介绍 ISelect 中进行贪婪加载集合属性数据,主数据与子数据查询必须在一个代码逻辑内完成
前面介绍 ISelect 中进行贪婪加载集合属性数据,并且只能使用 IncludeMany + ToList() 组合(不能使用指定字段查询)
当主数据已存在内存中,子数据怎么加载?所以我们增加了 List\<T\> 扩展方法,示例如下:
@@ -119,9 +61,9 @@ Select<Tag>().IncludeMany(a => a.TestManys.Select(b => new TestMany { Title = b.
new List<Song>(new[] { song1, song2, song3 }).IncludeMany(fsql, a => a.Tags);
```
是一个扩展方法IncludeMany方法名与 ISelect.IncludeMany 同名,参数基本一致(除了需要额外传递 IFreeSql 对象参数),功能也一致(包括前面提到的变异)。
这个扩展方法IncludeMany参数基本一致除了需要额外传递 IFreeSql功能也一致包括前面提到的变异
## 6、IncludeMany 两种方式对比
## 5、IncludeMany 两种方式对比
方式一IncludeMany 扩展方法):