FreeSql （三十二）Aop

FreeSql AOP 已有的功能介紹，將來爲會根據用戶需求不斷加強。

審計 CRUD

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

當若是由於某個 sql 騷操做耗時很高，沒有一個相關的審計功能，排查起來能夠說無從下手，福報與你牢牢相隨（哈哈）。

FreeSql 支持簡單的相似功能：

fsql.Aop.CurdAfter += (s, e) => {
	if (e.ElapsedMilliseconds > 200) {
		//記錄日誌
		//發送短信給負責人
	}
};

是的，只須要一個事件，就能夠對全局起到做用。

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

審計屬性值

實現插入/更新時統一處理某些值，好比某屬性的雪花算法值、建立時間值、甚至是業務值。

fsql.Aop.AuditValue += (s, e) => {
    if (e.Column.CsType == typeof(long) 
        && e.Property.GetCustomAttribute<SnowflakeAttribute>(false) != null
        && e.Value?.ToString() == 0)
        e.Value = new Snowflake().GetId();
};

class Order {
    [Snowflake]
    public long Id { get; set; }
    //...
}

當屬性的類型是 long，而且標記了 [Snowflake]，而且當前值是 0，那麼在插入/更新時它的值將設置爲雪花id值。

說明：SnowflakeAttribute 是使用者您來定義，new Snowflake().GetId() 也是由使用者您來實現

若是命名規範，能夠在 aop 裏判斷，if (e.Property.Name == "createtime") e.Value = DateTime.Now;

審計遷移腳本

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 內置表達式解析引擎，輔助您進行解析。

系列文章導航

• （一）入門

• （二）自動遷移實體

• （三）實體特性

• （四）實體特性 Fluent Api

• （五）插入數據

• （六）批量插入數據

• （七）插入數據時忽略列

• （八）插入數據時指定列

• （九）刪除數據

• （十）更新數據

• （十一）更新數據 Where

• （十二）更新數據時指定列

• （十三）更新數據時忽略列

• （十四）批量更新數據

• （十五）查詢數據

• （十六）分頁查詢

• （十七）聯表查詢

• （十八）導航屬性

• （十九）多表查詢

• （二十）多表查詢 WhereCascade

• （二十一）查詢返回數據

• （二十二）Dto 映射查詢

• （二十三）分組、聚合

• （二十四）Linq To Sql 語法使用介紹

• （二十五）延時加載

• （二十六）貪婪加載 Include、IncludeMany、Dto、ToList

• （二十七）將已寫好的 SQL 語句，與實體類映射進行二次查詢

• （二十八）事務

• （二十九）Lambda 表達式

• （三十）讀寫分離

• （三十一）分區分表

• （三十二）Aop

• （三十三）CodeFirst 類型映射

• （三十四）CodeFirst 遷移說明

• （三十五）CodeFirst 自定義特性