當前位置：首頁 > 编程资源 > 编程问答 >内容正文

编程问答

[开源] FreeSql AOP 功能模块 - FreeSql

發布時間：2023/12/4 编程问答 57 豆豆

生活随笔收集整理的這篇文章主要介紹了 [开源] FreeSql AOP 功能模块 - FreeSql 小編覺得挺不錯的,現在分享給大家,幫大家做個參考.

FreeSql 是一個功能強大的 .NETStandard 庫，用于對象關系映射程序(O/RM)，支持 .NETCore 2.1+ 或 .NETFramework 4.6.1+（QQ群：4336577）。

據了解，用戶使用很少問問題，編碼過程中，因業務阻塞，情有可原；因框架使用問題阻塞，得不償失。我們的口號：做 .net 最方便的 ORM！愿每一位開發者嘴角上揚?！

整體功能

IFreeSql 是核心，提供原始用法；
FreeSql.DbContext 是擴展包，提供面向對象的用法（像EF）；
FreeSql.Repository 也是擴展包，提供倉儲+工作單元用法（實際上和 DbContext 是一個擴展包）；
FreeSql.Connection.Extensions 也是擴展包，提供像 Dapper 一樣的用法；

源碼地址：https://github.com/2881099/FreeSql，可從這里鏈向上面介紹的各個倉庫。

fsql= new FreeSql.FreeSqlBuilder()
.UseConnectionString(FreeSql.DataType.Sqlite, @"Data Source=|DataDirectory|\document.db;Attachs=xxxtb.db;Pooling=true;Max Pool Size=10")
.UseAutoSyncStructure(true)
.Build();

今天上場的是 AOP 已有的功能介紹，未來為會根據用戶需求不斷增強。

審計 CRUD

馬云說過，996是修福報。對于多數程序員來說，加班是好事。。。起碼不是閑人，不會下崗。

當如果因為某個 sql 騷操作耗時很高，沒有一個相關的審計功能，排查起來可以說無從下手，福報與你緊緊相隨（哈哈）。

FreeSql 支持簡單的類似功能：

fsql.Aop.CurdAfter = (s, e) => {
if (e.ElapsedMilliseconds > 200) {

}
};

是的，只需要一個事件，就可以對全局起到作用。

除了 CurdAfter，還有一個 CurdBefore （在執行 sql 之前觸發）。

審計遷移腳本

FreeSql 自帶遷移功能，那么遷移的 SQL 語句長啥樣，你可能會好奇。

比如創建表時；
比如添加字段時；
比如修改表名、修改字段名時；
又比如字段類型更改之后時；

這些操作在 FreeSql.CodeFirst 實現下基本不需要理會，而且我們只推薦在開發環境使用自動遷移的功能，正式環境可使用其他工具替代此操作。

但我們仍然可能需要對項目做完整的日志記錄。

fsql.Aop.SyncStructureBefore、fsql.Aop.SyncStructureAfter 這兩個事件將排上用場。

自定義實體特性

比如項目內已經使用了其它 orm，如 efcore，這樣意味著實體中可能存在 [Key]，但它與 FreeSql [Column(IsPrimary = true] 不同。

Q： FreeSql 實體特性為啥這么別扭？

A：為了考慮一致性用法，全部封裝在 ColumnAttribute 下，這樣用戶使用起來，不用到處 using 或者回憶特性應該用哪個名字，如自增 [Column(IsIdentity = true)] 即可。

FreeSql 提供 AOP 自定義特性功能，實現與多個 orm 共同擁有一套實體特性，可避免重復定義特性。

fsql.Aop.ConfigEntity = (s, e) => {
var attr = e.EntityType.GetCustomAttributes(
typeof(System.ComponentModel.DataAnnotations.Schema.TableAttribute), false).FirstOrDefault()
as System.ComponentModel.DataAnnotations.Schema.TableAttribute;
if (attr != null)
e.ModifyResult.Name = attr.Name;
};

fsql.Aop.ConfigEntityProperty = (s, e) => {
if (e.Property.GetCustomAttributes(
typeof(System.ComponentModel.DataAnnotations.KeyAttribute), false).Any())
e.ModifyResult.IsPrimary = true;
};

就這樣，FreeSql 的實體特性就可以和 EFCore 那樣設定了。其他自增、樂觀鎖等，依葫蘆畫瓢便是。

自定義表達式

FreeSql 內部表達式支持非常豐富，對各大數據庫的兼容度也做得很好。

有關表達式支持到的程度，可點擊查看詳細wiki：https://github.com/2881099/FreeSql/wiki/%E8%A1%A8%E8%BE%BE%E5%BC%8F%E5%87%BD%E6%95%B0

即便如此豐富，也仍然無法滿足用戶需求，FreeSql 對外開放了自定義表達式解析接口：

fsql.Aop.ParseExpression = (s, e) => {
if (e.Expression.NodeType == Call && e.Expression.Name == "get_Item")
e.Result = "1111";
};

這個解析有點復雜，當 e.Expression 很復雜的時候，我們還提供了 e.FreeParse 方法，使用它相當于調用 FreeSql 內置表達式解析引擎，輔助您進行解析。

Aop.Where

FreeSql 提供的 ISelect、IDelete、IUpdate 三大對象，都可以使用 .Where(lambda) 操作，也可以是 .Where(sql) 操作。

Aop.Where 的定位是可攔截 Where 條件。

fsql.Aop.Where = (s, e) => {
if (e.Parameter[0]?.ToString() == "1")
e.IsCancel = true;
};

Aop.ToList

監控 ToList 返回的的數據，用于攔截重新裝飾。

所有通過 FreeSql.Select 查詢返回的時候，都可以在這個事件上進行重新裝飾。

下載地址：https://github.com/2881099/FreeSql

優勢：5種數據庫支持徹底，1500+單元測試，文檔功能齊全

歡迎更多人加入我們陣營！我們一起做 .NETCore 最方便的 ORM！

創作挑戰賽新人創作獎勵來咯，堅持創作打卡瓜分現金大獎

總結

以上是生活随笔為你收集整理的[开源] FreeSql AOP 功能模块 - FreeSql的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。