FreeSql （三十二）Aop

时间 2019-11-05 标签 freesql 三十二 aop

FreeSql AOP 已有的功能介绍，将来为会根据用户需求不断加强。html

审计 CRUD

马云说过，996是修福报。对于多数程序员来讲，加班是好事。。。起码不是闲人，不会下岗。git

当若是由于某个 sql 骚操做耗时很高，没有一个相关的审计功能，排查起来能够说无从下手，福报与你牢牢相随（哈哈）。程序员

FreeSql 支持简单的相似功能：github

fsql.Aop.CurdAfter = (s, e) => {
    if (e.ElapsedMilliseconds > 200) {
        //记录日志
        //发送短信给负责人
    }
};

是的，只须要一个事件，就能够对全局起到做用。算法

除了 CurdAfter，还有一个 CurdBefore （在执行 sql 以前触发）。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 内置表达式解析引擎，辅助您进行解析。

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 查询返回的时候，均可以在这个事件上进行从新装饰。