Fur.ExtensionPack

Nuget (with prereleases)

介绍

针对Fur基础功能的实用拓展包

安装教程

nuget Install-Package Fur.ExtensionPack

使用说明

1. 审计

对于大部分实体，都需要记录实体进入数据库的相关时间，以及操作人员等，目前此扩展包支持实体创建时间和修改时间的自动管理。

使用

将数据库上下文由继承于AppDbContext更改为继承于AuditingDbContext

    [AppDbContext("Sqlite3ConnectionString")]
    public class FurDbContext : AuditingDbContext<FurDbContext>//<=AppDbContext<FurDbContext>
    {
        public FurDbContext(DbContextOptions<FurDbContext> options) : base(options)
        {

        }
        protected override void SavingChangesEvent(object sender, SavingChangesEventArgs e)
        {

        }

    }

然后，在需要自动管理时间的实体添加ICreationTime以及IUpdateTime接口

 public class Person : Entity,ICreationTime,IUpdateTime
    {
        /// <summary>
        /// 构造函数
        /// </summary>
        public Person()
        {
            //此行已经不需要，由系统自动管理
            CreatedTime = DateTime.Now;
            IsDeleted = false;
        }

        /// <summary>
        /// 姓名
        /// </summary>
        [MaxLength(32)]
        public string Name { get; set; }
        。。。
    }

这样就完成了，此实体新建的时候，将会自动更新创建时间，被更新的时候，写入更新时间，以及在更新的时候，防止创建时间被篡改。

2.修正Mapster的行为

Fur使用Mapster作为Map工具，这是一个非常强大且性能不错的库，然后此库有一些小瑕疵，当子实体列表一并被map作为更新的时候，Mapster是先清空列表，然后再插入列表，这样做是正常的，但是对于EF，它会认为这个子实体被完全修改了，从而为每个子实体生成了全量更新的Sql语句，这对于大型复杂实体来说，对性能的影响是致命性的。要解决这个问题的关键，是让Mapster知道，实体的哪个字段作为主键，并且根据主键去查找对应关系，应此本扩展包提供了一个AdaptToTrack拓展方法能够很方便地进行调用。此功能参考了Mapster.EFCore的实现思路。

public async Task Update(PersonInputDto input)
{
  var person = await _personRepository.Entities.Include(u => u.PersonDetail).Include(u => u.Childrens).Include(u => u.Posts).SingleAsync(u => u.Id == input.Id.Value);
//直接Adapt，会清空Children列表然后插入，EF将会捕捉到所有Children被更新
// input.Adapt(person);
//AdaptToTrack会检测Children的主键(Id)的对应关系，来进行Map，EF只会捕捉到被修改过的更新
   input.AdaptToTrack(person);
   await _personRepository.UpdateAsync(person);

}

3.通用Crud接口

只要将对应接口类继承于CurdService，就可能轻松实现增删改查

    public class StudentService : CrudService<StudentDto, Student>, IDynamicApiController
    {

    }

CurdService所有方法都是虚方法，您可以随意覆写，并且包含了一些配置可以设置：
IsFakeDelete：是否为软删除，告诉Delete接口，删除是软删除还是硬删除，默认值根据传入的实体是否带有[FakeDelete]特性来判断。
IsCalculateCount：调用List接口的时候，是否统计查找到结果数，由于此操作会调用Count来计算，因此可能会延长返回时间，默认为True。
除了CreateAsync，UpdateAsync，Find，List，DeleteAsync的方法覆写外，还支持以下方法覆写：
CreateFilterQuery：此接口时用于生成Where表达式用的，默认使用的是System.Linq.Dynamic.Core，你也可以改成你自己的实现。
CreateEntityQuery：在Update和Get方法的时候，对实体Query进行额外的操作，比如添加Include，Join等操作，请注意传入的Query参数已经添加了Where的筛选条件，应此对应复杂的Include需要Load来分段加载也不用担心性能。
CreateListQuery：在使用List方法的时候，对实体Query进行额外的操作，比如添加Include，Join等操作，请注意传入的Query参数已经添加了Where的筛选条件，应此对应复杂的Include需要Load来分段加载也不用担心性能。

参与贡献

Fork 本仓库
新建 Feat_xxx 分支
提交代码
新建 Pull Request

特技

使用 Readme_XXX.md 来支持不同的语言，例如 Readme_en.md, Readme_zh.md
Gitee 官方博客 blog.gitee.com
你可以 https://gitee.com/explore 这个地址来了解 Gitee 上的优秀开源项目
GVP 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
Gitee 官方提供的使用手册 https://gitee.com/help
Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 https://gitee.com/gitee-stars/

夹卡夹卡酱酱夹卡酱夹卡酱 / Fur.ExtensionPack

Fur.ExtensionPack

介绍

安装教程

使用说明

1. 审计

使用

2.修正Mapster的行为

3.通用Crud接口

参与贡献

特技

简介

发行版

贡献者

近期动态

夹卡夹卡酱酱夹卡酱夹卡酱 / Fur.ExtensionPack .gitee-modal { width: 500px !important; }

Fur.ExtensionPack

介绍

安装教程

使用说明

1. 审计

使用

2.修正Mapster的行为

3.通用Crud接口

参与贡献

特技

简介

发行版

开源评估指数源自 OSS-Compass 评估体系，评估体系围绕以下三个维度对项目展开评估：

贡献者

近期动态

搜索帮助

夹卡夹卡酱酱夹卡酱夹卡酱 / Fur.ExtensionPack