前言
PostgreSQL 是世界公認的功能最強大的開源數(shù)據(jù)庫鲫售，除了基礎(chǔ)數(shù)據(jù)類型 int4/int8/varchar/numeric/timestamp 等掠河，還支持 int4[]/int8[]/varchar[]/numeric[]/timestamp[] 數(shù)組類型往毡、hstore 類型（類似 c# Dictionary<string, string>）、gis 類型。
選擇一項技術(shù)一定是可以幫助我們提升效率勉吻，并且使用一定是非常簡便的谭梗，才能讓我們賺取更多時間忘晤，早點下班甚至上班摸魚。這篇文章主要講數(shù)組類型激捏，如何與 FreeSql 打出簡便高效的【組合拳】设塔。
PostgreSQL 可以為每一種類型創(chuàng)建數(shù)組，比如 int4 對應(yīng)的數(shù)組類型是 int4[]远舅、varchar 對應(yīng)的數(shù)據(jù)類型是 varchar[]闰蛔。
PostgreSQL 雖然支持多維數(shù)組，但是不建議使用图柏，因為實際使用中會帶來很多操作麻煩序六，違背了使用簡便的初衷。一維數(shù)組足夠應(yīng)付很多場景蚤吹。
FreeSql 本身已經(jīng)支持五種導(dǎo)航屬性例诀，OneToOne/ManyToOne/OneToMany/ManyToMany/Parent，為它們量身打造了級聯(lián)保存裁着、貪婪加載繁涂、延遲加載、級聯(lián)刪除(遞歸)二驰、CTE遞歸查詢等功能扔罪。
今天 FreeSql 為 PostgreSQL Array 數(shù)組類型提供了第六種新的導(dǎo)航屬性 PgArrayToMany 專屬功能。
數(shù)組映射
FreeSql 支持 int[] 映射 int4[]
string[] 映射 varchar[]
DateTime[] 映射 timestamp[]
class Model
{
public Guid Id { get; set; }
public int[] TypeIds { get; set; }
public Guid[] UserIds { get; set; }
}
等等诸蚕，常用的類型都可以直接用數(shù)組進行映射步势，之后就可以像普通類型一樣進行 CRUD 操作了。
var model = new Model
{
Id = Guid.NewGuid(),
TypeIds = new int[] { 1,2,3 },
UserIds = new Guid[] { Guid.NewGuid(), Guid.NewGuid() }
};
fsql.Insert(model).ExecuteAffrows(); //插入
fsql.Update<Model>().SetSource(model).ExecuteAffrows(); //更新
fsql.Delete(model).ExecuteAffrows(); //刪除
List<Model> list = fsql.Select<Model>().ToList(); //查詢
表達式解析：
fsql.Select<Model>().Where(a => a.TypeIds.Any()).ToSql();
fsql.Select<Model>().Where(a => a.TypeIds.Contains(3)).ToSql();
fsql.Select<Model>().ToSql(a => new
{
NewTypeIds = a.TypeIds.Concat(new int [] { 10, 11, 12 })
});
fsql.Select<Model>().Where(a => a.TypeIds.Length > 0).ToSql();
如果不夠用還可以自定義解析：
[ExpressionCall]
public static class DbFunc {
//必要定義 static + ThreadLocal
static ThreadLocal<ExpressionCallContext> context = new ThreadLocal<ExpressionCallContext>();
public static DateTime FormatDateTime(this DateTime that, string arg1)
{
var up = context.Value;
if (up.DataType == FreeSql.DataType.PostgreSQL) //重寫內(nèi)容
up.Result = $"array_xxx({up.ParsedContent["that"]}, {up.ParsedContent["arg1"]})";
return that;
}
}
var sql1 = fsql.Select<Model>()
.ToSql(a => a.CreateTime.FormatDateTime("xxx"));
//SELECT array_xxx(a."CreateTime", 'xxx') as1
//FROM "Model" a
issues #1145
Feature 特性：對數(shù)組做導(dǎo)航
簡要描述原因：pg 之類的數(shù)據(jù)庫支持數(shù)組類型背犯，但是沒有對數(shù)組做導(dǎo)航支持
使用場景：避免無必要的中間表
class User
{
public int[] RoleIds { get; set; }
public Role[] Roles { get; set; }
}
class Role
{
public int Id { get; set; }
}
解決方案
經(jīng)過多方需求討論之后坏瘩，設(shè)定了【功能目標】如下：（已發(fā)布版本 v3.2.666-preview20220606）
功能名稱：PostgreSQL 【數(shù)組類型】的【導(dǎo)航屬性】專屬功能
public enum TableRefType
{
OneToOne, ManyToOne, OneToMany, ManyToMany,
PgArrayToMany //PgArray 專用導(dǎo)航類型
}
方式一：select * from Role where Id in (RoleIds)
class User
{
public int[] RoleIds { get; set; }
[Navigate(nameof(RoleIds))]
public List<Role> Roles { get; set; }
}
方式二：select * from User where RoleIds @> ARRAY[Id]::int4[]
class Role
{
public int Id { get; set; }
[Navigate(nameof(User.RoleIds))]
public List<User> Users { get; set; }
}
1、支持 LazyLoading 延時加載
2漠魏、支持 IncludeMany倔矾、IncludeByPropertyName 貪婪加載
fsql.Select<User>().IncludeMany(a => a.Roles).ToList();
fsql.Select<User>().IncludeByPropertyName("Roles").ToList();
fsql.Select<Role>().IncludeMany(a => a.Users).ToList();
fsql.Select<Role>().IncludeByPropertyName("Users").ToList();
3、支持 Lambda 子查詢
fsql.Select<User>().Where(a => a.Roles.Any(b => b.RoleName == "管理員")).ToList();
fsql.Select<User>().Where(a => a.Roles.Count() > 0).ToList();
fsql.Select<Role>().Where(a => a.Users.Any(b => b.UserName == "Admin")).ToList();
fsql.Select<Role>().Where(a => a.Users.Count() > 0).ToList();
//... 以及 AsSelect()
4、不支持級聯(lián)保存哪自、級聯(lián)刪除（因機制沖突）
資料補充
至此丰包，F(xiàn)reeSql 支持了六種導(dǎo)航屬性。
FreeSql 五種導(dǎo)航屬性進化過程 OneToOne/ManyToOne/OneToMany/ManyToMany/Parent（文章內(nèi)不包括 PgArrayToMany 介紹）
FreeSql 是 .Net ORM壤巷，能支持 .NetFramework4.0+邑彪、.NetCore、Xamarin胧华、XAUI寄症、Blazor、以及還有說不出來的運行平臺矩动，因為代碼綠色無依賴有巧，支持新平臺非常簡單。目前單元測試數(shù)量：5000+悲没，Nuget下載數(shù)量：180K+篮迎，源碼幾乎每天都有提交。
QQ群：4336577(已滿)示姿、8578575(在線)甜橱、52508226(在線)
FreeSql 主要優(yōu)勢在于易用性上，基本是開箱即用峻凫，在不同數(shù)據(jù)庫之間切換兼容性比較好渗鬼。作者花了大量的時間精力在這個項目，肯請您花半小時了解下項目荧琼，謝謝譬胎。功能特性如下：
- 支持 CodeFirst 對比結(jié)構(gòu)變化遷移；
- 支持 DbFirst 從數(shù)據(jù)庫導(dǎo)入實體類命锄；
- 支持 豐富的表達式函數(shù)堰乔，自定義解析；
- 支持 批量添加脐恩、批量更新镐侯、BulkCopy；
- 支持 導(dǎo)航屬性驶冒，貪婪加載苟翻、延時加載、級聯(lián)保存骗污；
- 支持 讀寫分離崇猫、分表分庫，租戶設(shè)計需忿；
- 支持 MySql/SqlServer/PostgreSQL/Oracle/Sqlite/達夢/神通/人大金倉/翰高/MsAccess诅炉；
FreeSql 使用非常簡單蜡歹，只需要定義一個 IFreeSql 對象即可：
static IFreeSql fsql = new FreeSql.FreeSqlBuilder()
.UseConnectionString(FreeSql.DataType.MySql, connectionString)
.UseAutoSyncStructure(true) //自動同步實體結(jié)構(gòu)到數(shù)據(jù)庫
.Build(); //請務(wù)必定義成 Singleton 單例模式
注意：單例不等于線程不安全，除了事務(wù)涕烧，實際內(nèi)部是有連接池管理 Ado.net IDbConnection 對象月而，請放心大膽使用，不用糾結(jié)線程安全問題议纯。
微軟制造了優(yōu)秀的語言 c#父款，利用語言特性可以做一些非常好用的功能，在 ORM 中使用導(dǎo)航屬性非常適合痹扇。
ManyToOne(N對1) 提供了簡單的多表 join 查詢铛漓；
OneToMany(1對N) 提供了簡單可控的級聯(lián)查詢溯香、級聯(lián)保存功能鲫构；
ManyToMany(多對多) 提供了簡單的多對多過濾查詢、級聯(lián)查詢玫坛、級聯(lián)保存功能结笨；
Parent(父子關(guān)系) 提供了常用的 CTE查詢、刪除湿镀、遞歸功能炕吸；
PgArrayToMany(數(shù)組導(dǎo)航) 提供了 pgsql array 數(shù)組類型級聯(lián)查詢；
希望正在使用的勉痴、善良的您能動一動小手指赫模，把文章轉(zhuǎn)發(fā)一下，讓更多人知道 .NET 有這樣一個好用的 ORM 存在蒸矛。謝謝了Ｆ俾蕖！
FreeSql 開源協(xié)議 MIT https://github.com/dotnetcore/FreeSql雏掠，可以商用斩祭，文檔齊全。QQ群：4336577(已滿)乡话、8578575(在線)摧玫、52508226(在線)
如果你有好的 ORM 實現(xiàn)想法，歡迎給作者留言討論绑青，謝謝觀看诬像！
