前言
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
感謝一直支持的朋友們!