FreeSql 新的八大騷功能，.NETCore 你必須曉得的 ORM

摘要： 前言 FreeSql 目前版本號 0.5.5，預計明年元旦釋出 1.0.0，切莫小看了版本號，目前單元測試方法1350+，並且每個方法內的涵蓋面又比較廣（不信的話見下圖），每一次版本釋出都作了較多的測試工作。 最近的一段時間，關注我們的人時不時會看見擴充套件包釋出，今天振奮人...

前言

FreeSql 目前版本號 0.5.5，預計明年元旦釋出 1.0.0，切莫小看了版本號，目前單元測試方法1350+，並且每個方法內的涵蓋面又比較廣（不信的話見下圖），每一次版本釋出都作了較多的測試工作。

最近的一段時間，關注我們的人時不時會看見擴充套件包釋出，今天振奮人心的功能主要是核心部分實現（擴充套件包今天當配角）。就不多囉嗦了，咱們直接入主題。

功能一：MapType 型別對映

使用 codefirst 時序列化 json 或 jsonb 資料型別報錯

使用 postgresql + ef 配置資料對映關係，使用 FreeSql 的對映擴充套件時，對於json型別的資料映射出錯。

這是來自 github 上的某個 issue，原因是使用者的實體定義了 string，資料庫型別為 json。FreeSql 本身支援了豐富的型別，不限於 json，但是限定了型別的對映，比如 JToken/JObject/JArray 的實體型別才可以對映至 PostgreSQL 資料庫的 json 型別。另外雖然有 DbType 特性可以設定，但使用範圍有限，不可跨越型別（如使用 string 可使用 DbType="char(100)"）。

還有一些類似要求，如：將 enum 對映到資料庫 varchar 的請求。。。。

到現在，我們已經徹底突破了這個障礙，基本可以做到隨意對映型別。作為新專案開發，我們提供本身的預設型別對映已經非常人性化，提這些需求的人主要還是歷史原因，咱們做程式維護工作的人員還是佔比很高，千怪萬怪只能怪 FreeSql 來得太遲。。。。

目前為 MapType 功能增加了大約 400 個單元測試方法。貼一段 demo 配置方法：

class EnumTestMap {
public Guid id { get; set; }

[Column(MapType = typeof(string))]
public ToStringMapEnum enum_to_string { get; set; }
[Column(MapType = typeof(string))]
public ToStringMapEnum? enumnullable_to_string { get; set; }

[Column(MapType = typeof(int))]
public ToStringMapEnum enum_to_int { get; set; }
[Column(MapType = typeof(int?))]
public ToStringMapEnum? enumnullable_to_int { get; set; }

[Column(MapType = typeof(string))]
public BigInteger biginteger_to_string { get; set; }
[Column(MapType = typeof(string))]
public BigInteger? bigintegernullable_to_string { get; set; }
}
public enum ToStringMapEnum { 中國人, abc, 香港 }

應該不需要解釋了吧？

細看一下，實體內有 BigInteger 型別，這可是資料庫無法表示的型別，現在就是可以使用（沒轍）。但請注意：BigInteger 僅僅是 CURD 方便， Equals == 判斷可以使用，無法使用 + - * / < > 等操作；

預設對映

csharp	MySql	SqlServer	PostgreSQL	Oracle	Sqlite
bool , bool?	bit(1)	bit	bool	number(1)	boolean
sbyte , sbyte?	tinyint(3)	smallint	int2	number(4)	smallint
short , short?	smallint(6)	smallint	int2	number(6)	smallint
int , int?	int(11)	int	int4	number(11)	integer
long , long?	bigint(20)	bigint	int8	number(21)	integer
byte , byte?	tinyint(3) unsigned	tinyint	int2	number(3)	int2
ushort , ushort?	smallint(5) unsigned	int	int4	number(5)	unsigned
uint , uint?	int(10) unsigned	bigint	int8	number(10)	decimal(10,0)
ulong , ulong?	bigint(20) unsigned	decimal(20,0)	numeric(20,0)	number(20)	decimal(21,0)
double , double?	double	float	float8	float(126)	double
float , float?	float	real	float4	float(63)	float
decimal , decimal?	decimal(10,2)	decimal(10,2)	numeric(10,2)	number(10,2)	decimal(10,2)
Guid , Guid?	char(36)	uniqueidentifier	uuid	char(36 CHAR)	character(36)
TimeSpan , TimeSpan?	time	time	time	interval day(2) to second(6)	bigint
DateTime , DateTime?	datetime	datetime	timestamp	timestamp(6)	datetime
DateTimeOffset , DateTimeOffset?	-	-	datetimeoffset	timestamp(6) with local time zone	-
Enum , Enum?	enum	int	int4	number(16)	mediumint
FlagsEnum , FlagsEnum?	set	bigint	int8	number(32)	bigint
byte[]	varbinary(255)	varbinary(255)	bytea	blob	blob
string	varchar(255)	nvarchar(255)	varchar(255)	nvarchar2(255)	nvarchar(255)
MygisPoint	point	-	-	-	-
MygisLineString	linestring	-	-	-	-
MygisPolygon	polygon	-	-	-	-
MygisMultiPoint	multipoint	-	-	-	-
MygisMultiLineString	multilinestring	-	-	-	-
MygisMultiPolygon	multipolygon	-	-	-	-
BitArray	-	-	varbit(64)	-	-
NpgsqlPoint , NpgsqlPoint?	-	-	point	-	-
NpgsqlLine , NpgsqlLine?	-	-	line	-	-
NpgsqlLSeg , NpgsqlLSeg?	-	-	lseg	-	-
NpgsqlBox , NpgsqlBox?	-	-	box	-	-
NpgsqlPath , NpgsqlPath?	-	-	path	-	-
NpgsqlPolygon , NpgsqlPolygon?	-	-	polygon	-	-
NpgsqlCircle , NpgsqlCircle?	-	-	circle	-	-
(IPAddress Address, int Subnet) , (IPAddress Address, int Subnet)?	-	-	cidr	-	-
IPAddress	-	-	inet	-	-
PhysicalAddress	-	-	macaddr	-	-
NpgsqlRange<int> , NpgsqlRange<int>?	-	-	int4range	-	-
NpgsqlRange<long> , NpgsqlRange<long>?	-	-	int8range	-	-
NpgsqlRange<decimal> , NpgsqlRange<decimal>?	-	-	numrange	-	-
NpgsqlRange<DateTime> , NpgsqlRange<DateTime>?	-	-	tsrange	-	-
PostgisPoint	-	-	geometry	-	-
PostgisLineString	-	-	geometry	-	-
PostgisPolygon	-	-	geometry	-	-
PostgisMultiPoint	-	-	geometry	-	-
PostgisMultiLineString	-	-	geometry	-	-
PostgisMultiPolygon	-	-	geometry	-	-
PostgisGeometry	-	-	geometry	-	-
PostgisGeometryCollection	-	-	geometry	-	-
Dictionary<string, string>	-	-	hstore	-	-
JToken	-	-	jsonb	-	-
JObject	-	-	jsonb	-	-
JArray	-	-	jsonb	-	-
陣列	-	-	以上所有型別都支援	-	-

以上型別和長度是預設值，可手工設定，如 string 屬性可指定 [Column(DbType = "varchar(max)")]

功能二：唯一鍵（Unique）

class AddUniquesInfo {

public Guid id { get; set; }
[Column(Unique = "uk_phone")]
public string phone { get; set; }

[Column(Unique = "uk_group_index")]
public string group { get; set; }
[Column(Unique = "uk_group_index")]
public int index { get; set; }

[Column(Unique = "uk_group_index222")]
public string index22 { get; set; }
}

Unique 指定相同的標識，代表聯合唯一鍵，現已支援遷移。

功能三：弱型別（實體）

之前在操作實體時，必須傳統泛型引數，現在可以實現弱型別實體的操作。以 Repository 為例：

var repos = fsql.GetGuidRepository<object>();
repos.AsType(typeof(AddUpdateInfo));

var item = new AddUpdateInfo();
repos.Insert(item);

item.Clicks += 1;
repos.InsertOrUpdate(item);

var item2 = repos.Find(item.Id) as AddUpdateInfo;
Assert.Equal(item.Clicks, item2.Clicks);

repos.DataFilter.Apply("xxx", a => (a as AddUpdateInfo).Clicks == 11);
Assert.Null(repos.Find(item.Id));

然後呢，DbContext 也支援同樣的操作。

dotnet add package FreeSql.DbContext

功能四：ToList & Mapper

現在支援 ToList(a => new Dto()) 這樣的簡單資料對映。

什麼意思？即 Dto 只要有屬性名與實體屬性相同，就會根據匹配到的欄位查詢（不是查詢所有欄位回來再對映）。

然後這個騷操作，還支援多表查詢的對映，怎麼解決多表存在相同名字的欄位問題呢？優先順序規則，它會依次序匹配 LeftJoin/InnerJoin/RightJoin 的實體。

功能五：ToList(true) 貪婪載入

以前 .ToList() 會載入兩級Join物件；

現在 ISelect.ToList(includeNestedMembers: true) 貪婪載入所有 LeftJoin/InnerJoin/RightJoin 導航資料，不論物件的層級；

功能六：WhereDynamic 動態條件

支援傳入動態物件如：主鍵值 | new[]{主鍵值1,主鍵值2} | TEntity1 | new[]{TEntity1,TEntity2} | new{id=1}。

也就是說 WhereDynaimc 方法輸入型別為 object，是不是很方便？還支援聯合主鍵呢。

功能七：IAdo.Query 多個結果集

var result = fsql.Ado.Query<T1, T2>("select * from t1; select * from t2");

功能八：開發環境之利器：MVC 中介軟體 FreeSql.AdminLTE

大約是前一段時間的某一天（廢話），因為使用 FreeSql 的某專案需要做一個簡單的後臺功能，以便錄入或管理資料。在實施的過程中好懷念當初 dotnetGen 生成器的味道，用它產生 curd 基本功能幾乎是秒做；

FreeSql.AdminLTE，是的就是它，前段時間釋出過一次。

它是 FreeSql 衍生出來的 .NETCore MVC 中介軟體、中介軟體、中介軟體（重複三遍）擴充套件包，基於 AdminLTE 前端框架動態產生實體的增刪查改介面；

輸入：實體1、實體2、實體3

輸出：後臺管理的功能

只需要傳入實體，就可以形成 curd 的管理功能，是不是有些騷啊~~~

先發一張執行後的圖片嚐個鮮：

這是根據實體產生 curd 介面的 mvc 中介軟體，開發時預覽資料好方便啊。看完預覽圖不由得再感嘆一次 FreeSql 的易用性，那句口號：做 .NETCore 最方便的 ORM！ 沒有說錯。。。作者多次提及：“我們是日式簡約風格，沒那麼複雜的用法”，也驗證了這一點。。

新增/修改

中件間產生的介面包括新增、修改資料的功能，普通實體的根據屬性的型別與 Html5 UI 一一對映；

比較特殊的對映規則：

c# 型別	Html5
布林	複選框
列舉	下拉選擇
日期	日期控制元件
ManyToOne 導航屬性	下拉選擇
ManyToMany 導航屬性	多選器

等等。。。

什麼情況會產生【上傳檔案】控制元件？

有興趣的可以瞭解原始碼，目前沒有開放在外部配置。

查詢/過濾

中件間為每個實體提供了分頁列表查詢，每頁為20條資料；

除此外，還提供了過濾條件的支援，規則是根據導航屬性（ManyToOne、ManyToMany）。比如【文章實體】，內含有【分類id】+【分類物件】，則【文章】列表頁會出現按【分類】篩選的UI，詳見上面的 demo 示意圖，或者下載對應的 demo 版本執行；

刪除

中件間為每個實體提供了批量刪除的功能；

測試 demo

我們習慣用 sqlite 做測試庫，測試完畢直接刪除目錄，不留垃圾資料，所以下面的 demo 不需要修改任何地方，執行時自動建庫、建表；

提供 .net core 2.1、2.2 兩種環境的測試 demo 下載：

Demo for dotnet 2.1.zip 、 Demo for dotnet 2.2.zip

第一步：

dotnet restore

第二步：

dotnet run

思考

一番驚喜過後，你應該會考慮實用性，這樣做有什麼價值，可用於什麼樣的場景？

這個擴充套件包簡單的輸入，產生巨量的功能反饋。目前來說它是死板的，對外提供的擴充套件性幾乎為零，這樣也就限定了它的應用場景。

不合適的場景

1、它不可替代我們自身開發的後臺管理系統；

2、它不適合擺放在公網正式環境，存在資料安全問題；

3、歡迎補充。。。；

談談定位

目前的定位是這樣的，在開發環境中使用，查閱預覽實體資料，同時也比較方便的管理測試資料。

一段擁有無比力量的小段程式碼，也是中介軟體介面的功能開啟：

//可以配置子目錄訪問，如：/testadmin/
app.UseFreeAdminLTE("/",
typeof(Entities.Song),
typeof(Entities.Tag));

觀後抽獎

我們一直在釋出純技術乾貨的分享文章，FreeSql 已經基本完成 .NETCore 最方便的 ORM 使命，我們正在籌備生態的建立，比如 ABP 中如何使用 FreeSql 的實現，需要各種各樣的擴充套件包，好多好多工作量。有沒有大神願意無償參與做這件事情，好吧。。應該沒有人！！如果你回心轉意了，歡迎聯絡我們。

歡迎持續關注我們，做 .NETCore 最方便的 ORM ！

（QQ群：4336577）

github： https://github.com/2881099/FreeSql

說好的抽獎呢？？？