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

感謝一直支持的朋友們!

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章