Asp.Net Core Identity 骚断腿的究极魔改实体类

# 前端 2024-05-05 06:26 0 27 来源：云博客

前言

默认的 Identity 实体类型在大多数时候已经基本够用，很多时候也只是稍微在 IdentityUser 类中增加一些自定义数据字段，比如头像。这次，我要向园友隆重介绍我魔改之后的 Identity 实体类，能支持一些特别风骚的操作。当然也完全兼容内置的 UserManager、RoleManager 和 SignInManager，毕竟也是从内置类型继承扩展出来的。

正文

魔改的实体类基于一组我自定义实体接口，这组接口我也实现了一组打包好的基础类型。因为 Identity 系列实体类型已经存在，而 C# 不支持多重继承，所以只能把这些代码在魔改的 Identity 实体类中粘贴几次了。

先来看看这些基本接口吧：

 1 /// <summary> 2 /// 软删除接口 3 /// </summary> 4 public interface ILogicallyDeletable 5  { 6 /// <summary> 7 /// 逻辑删除标记 8 /// </summary> 9 bool IsDeleted { get; set; } 10  } 11  12 /// <summary> 13 /// 活动状态标记接口 14 /// </summary> 15 public interface IActiveControllable 16  { 17 /// <summary> 18 /// 活动状态标记 19 /// </summary> 20 bool? Active { get; set; } 21  } 22  23 /// <summary> 24 /// 乐观并发接口 25 /// </summary> 26 public interface IOptimisticConcurrencySupported 27  { 28 /// <summary> 29 /// 行版本，乐观并发锁 30 /// </summary> 31  [ConcurrencyCheck] 32 string ConcurrencyStamp { get; set; } 33  } 34  35 /// <summary> 36 /// 插入顺序记录接口 37 /// </summary> 38 public interface IStorageOrderRecordable 39  { 40 /// <summary> 41 /// 非自增顺序字段作为主键类型 42 /// 应该在此列建立聚集索引避免随机的字段值导致数据库索引性能下降 43 /// 同时保存数据插入先后的信息 44 /// </summary> 45 long InsertOrder { get; set; } 46  } 47  48 /// <summary> 49 /// 创建时间记录接口 50 /// </summary> 51 public interface ICreationTimeRecordable 52  { 53 /// <summary> 54 /// 实体创建时间 55 /// </summary> 56 DateTimeOffset CreationTime { get; set; } 57  } 58  59 /// <summary> 60 /// 最后修改时间记录接口 61 /// </summary> 62 public interface ILastModificationTimeRecordable 63  { 64 /// <summary> 65 /// 最后一次修改时间 66 /// </summary> 67 DateTimeOffset LastModificationTime { get; set; } 68  } 69  70 /// <summary> 71 /// 创建人id记录接口 72 /// </summary> 73 /// <typeparam name="TIdentityKey">创建人主键类型</typeparam> 74 public interface ICreatorRecordable<TIdentityKey> 75 where TIdentityKey : struct, IEquatable<TIdentityKey> 76  { 77 /// <summary> 78 /// 创建人Id 79 /// </summary> 80 TIdentityKey? CreatorId { get; set; } 81  } 82  83 /// <summary> 84 /// 创建人记录接口 85 /// </summary> 86 /// <typeparam name="TIdentityKey">创建人主键类型</typeparam> 87 /// <typeparam name="TIdentityUser">创建人类型</typeparam> 88 public interface ICreatorRecordable<TIdentityKey, TIdentityUser> : ICreatorRecordable<TIdentityKey> 89 where TIdentityKey : struct , IEquatable<TIdentityKey> 90 where TIdentityUser : IEntity<TIdentityKey> 91  { 92 /// <summary> 93 /// 创建人 94 /// </summary> 95 TIdentityUser Creator { get; set; } 96  } 97  98 /// <summary> 99 /// 上次修改人id记录接口100 /// </summary>101 /// <typeparam name="TIdentityKey">上次修改人主键类型</typeparam>102 public interface ILastModifierRecordable<TIdentityKey>103 where TIdentityKey : struct, IEquatable<TIdentityKey>104  {105 /// <summary>106 /// 上一次修改人Id107 /// </summary>108 TIdentityKey? LastModifierId { get; set; }109  }110 111 /// <summary>112 /// 上次修改人记录接口113 /// </summary>114 /// <typeparam name="TIdentityKey">上次修改人主键类型</typeparam>115 /// <typeparam name="TIdentityUser">上次修改人类型</typeparam>116 public interface ILastModifierRecordable<TIdentityKey, TIdentityUser> : ILastModifierRecordable<TIdentityKey>117 where TIdentityKey : struct, IEquatable<TIdentityKey>118 where TIdentityUser : IEntity<TIdentityKey>119  {120 /// <summary>121 /// 上一次修改人122 /// </summary>123 TIdentityUser LastModifier { get; set; }124 }

View Code

这些基本接口每一个都对应了一个基本功能。还有一个稍微复杂的树形数据结构接口：

 1 /// <summary> 2 /// 树形数据接口 3 /// </summary> 4 /// <typeparam name="T">节点数据类型</typeparam> 5 public interface ITree<T> 6  { 7 /// <summary> 8 /// 父节点 9 /// </summary>10 T Parent { get; set; }11 12 /// <summary>13 /// 子节点集合14 /// </summary>15 IList<T> Children { get; set; }16 17 /// <summary>18 /// 节点深度，根的深度为019 /// </summary>20 int Depth { get; }21 22 /// <summary>23 /// 是否是根节点24 /// </summary>25 bool IsRoot { get; }26 27 /// <summary>28 /// 是否是叶节点29 /// </summary>30 bool IsLeaf { get; }31 32 /// <summary>33 /// 是否有子节点34 /// </summary>35 bool HasChildren { get; }36 37 /// <summary>38 /// 节点路径（UNIX路径格式，以“/”分隔）39 /// </summary>40 string Path { get; }41 }

View Code

然后是打包接口，主要是把基本接口打包到一个统一接口，方便批量使用：

 1 /// <summary> 2 /// 实体接口 3 /// </summary> 4 public interface IEntity {} 5  6 /// <summary> 7 /// 泛型实体接口，约束Id属性 8 /// </summary> 9 public interface IEntity<TKey> : IEntity10 where TKey : IEquatable<TKey>11  {12 TKey Id { get; set; }13  }14 15 /// <summary>16 /// 领域实体接口，主要是整合各个小接口17 /// </summary>18 public interface IDomainEntity : IEntity19  , ILogicallyDeletable20  , ICreationTimeRecordable21  , ILastModificationTimeRecordable22  , INotifyPropertyChanged23  , INotifyPropertyChangedExtension24  , IPropertyChangeTrackable25  {}26 27 /// <summary>28 /// 泛型领域实体接口29 /// </summary>30 public interface IDomainEntity<TKey> : IEntity<TKey>31  , IDomainEntity32 where TKey : struct, IEquatable<TKey>33 {}

View Code

树形数据结构也有一套：

 1 /// <summary> 2 /// 树形实体接口 3 /// </summary> 4 /// <typeparam name="T">实体类型</typeparam> 5 public interface ITreeEntity<T> : IEntity, ITree<T> 6  { 7  } 8  9 /// <summary>10 /// 树形实体接口11 /// </summary>12 /// <typeparam name="TKey">主键类型</typeparam>13 /// <typeparam name="TEntity">实体类型</typeparam>14 public interface ITreeEntity<TKey, TEntity> : ITreeEntity<TEntity>, IEntity<TKey>15 where TKey : IEquatable<TKey>16 where TEntity : ITreeEntity<TKey, TEntity>17  {18  }19 20 /// <summary>21 /// 树形领域实体接口22 /// </summary>23 /// <typeparam name="T">数据类型</typeparam>24 public interface IDomainTreeEntity<T> :25  IDomainEntity26 , ITreeEntity<T>27  {28  }29 30 /// <summary>31 /// 树形领域实体接口32 /// </summary>33 /// <typeparam name="TKey">主键类型</typeparam>34 /// <typeparam name="TEntity">树形实体类型</typeparam>35 public interface IDomainTreeEntity<TKey, TEntity> :36 IDomainTreeEntity<TEntity>37 , IDomainEntity<TKey>38 , ITreeEntity<TKey, TEntity>39 40 where TKey : struct, IEquatable<TKey>41 where TEntity : IDomainTreeEntity<TKey, TEntity>42  {43 TKey? ParentId { get; set; }44 }

View Code

最后还有几个特别用处的接口：

 1 /// <summary> 2 /// 跟踪属性的变更 3 /// </summary> 4 public interface IPropertyChangeTrackable 5  { 6 /// <summary> 7 /// 判断指定的属性或任意属性是否被变更过 8 /// </summary> 9 /// <param name="names">指定要判断的属性名数组，如果为空(null)或空数组则表示判断任意属性</param>10 /// <returns>11 /// <para>如果指定的<paramref name="names"/>参数有值，当只有参数中指定的属性发生过更改则返回真(True)，否则返回假(False)</para>12 /// <para>如果指定的<paramref name="names"/>参数为空(null)或空数组，当实体中任意属性发生过更改则返回真(True)，否则返回假(False)</para>13 /// </returns>14 bool HasChanges(params string[] names);15 16 /// <summary>17 /// 获取实体中发生过变更的属性集18 /// </summary>19 /// <returns>如果实体没有属性发生过变更，则返回空白字典，否则返回被变更过的属性键值对</returns>20 IDictionary<string, object> GetChanges();21 22 /// <summary>23 /// 重置指定的属性或任意属性变更状态（为未变更）24 /// </summary>25 /// <param name="names">指定要重置的属性名数组，如果为空(null)或空数组则表示重置所有属性的变更状态（为未变更）</param>26 void ResetPropertyChangeStatus(params string[] names);27  }28 29 /// <summary>30 /// 多对多导航实体接口31 /// </summary>32 /// <typeparam name="TIdentityKey">身份实体主键类型</typeparam>33 /// <typeparam name="TIdentityUser">身份实体类型</typeparam>34 public interface IManyToManyReferenceEntity<TIdentityKey, TIdentityUser> : IManyToManyReferenceEntity<TIdentityKey>35 , ICreatorRecordable<TIdentityKey, TIdentityUser>36 where TIdentityKey : struct, IEquatable<TIdentityKey>37 where TIdentityUser : IEntity<TIdentityKey>38  {39  }40 41 /// <summary>42 /// 多对多导航实体接口43 /// </summary>44 /// <typeparam name="TIdentityKey">身份实体主键类型</typeparam>45 public interface IManyToManyReferenceEntity<TIdentityKey> : IManyToManyReferenceEntity46 , ICreatorRecordable<TIdentityKey>47 where TIdentityKey : struct, IEquatable<TIdentityKey>48  {49  }50 51 /// <summary>52 /// 多对多导航实体接口53 /// </summary>54 public interface IManyToManyReferenceEntity : IEntity55  , ICreationTimeRecordable56  {57 }

View Code

至此，基本上用到的接口就定义好了，接下来就是魔改 Identity 实体类，这里以 IdentityRole 为例，其他的可以到我的项目中查看，大同小异：

 1 public class ApplicationRole : ApplicationRole<int, ApplicationUser, ApplicationRole, ApplicationUserRole, ApplicationRoleClaim> 2  , IStorageOrderRecordable 3  { 4 public ApplicationRole() { } 5 public ApplicationRole(string roleName) => Name = roleName; 6  7 public virtual long InsertOrder { get; set; } 8  } 9  10 public abstract class ApplicationRole<TKey, TIdentityUser, TIdentityRole, TUserRole, TRoleClaim> : IdentityRole<TKey> 11 , IDomainTreeEntity<TKey, TIdentityRole> 12  , IOptimisticConcurrencySupported 13 , ICreatorRecordable<TKey, TIdentityUser> 14 , ILastModifierRecordable<TKey, TIdentityUser> 15 where TKey : struct, IEquatable<TKey> 16 where TIdentityUser : IEntity<TKey> 17 where TUserRole : ApplicationUserRole<TKey, TIdentityUser, TIdentityRole> 18 where TRoleClaim : ApplicationRoleClaim<TKey, TIdentityUser, TIdentityRole> 19 where TIdentityRole : ApplicationRole<TKey, TIdentityUser, TIdentityRole, TUserRole, TRoleClaim> 20  { 21 #region 重写基类属性使属性变更通知事件生效 22  23 public override TKey Id { get => base.Id; set => base.Id = value; } 24 public override string ConcurrencyStamp { get => base.ConcurrencyStamp; set => base.ConcurrencyStamp = value; } 25 public override string Name { get => base.Name; set => base.Name = value; } 26 public override string NormalizedName { get => base.NormalizedName; set => base.NormalizedName = value; } 27  28 #endregion 29  30 public string Description { get; set; } 31  32 /// <summary> 33 /// 需要使用.Include(r => r.UserRoles).ThenInclude(ur => ur.Role)预加载或启用延迟加载 34 /// </summary> 35  [NotMapped] 36 public virtual IEnumerable<TIdentityUser> Users => UserRoles?.Select(ur => ur.User); 37  38 #region 导航属性 39  40 public virtual List<TUserRole> UserRoles { get; set; } = new List<TUserRole>(); 41  42 public virtual List<TRoleClaim> RoleClaims { get; set; } = new List<TRoleClaim>(); 43  44 #endregion 45  46 #region IDomainTreeEntity成员 47  48 public virtual TKey? ParentId { get; set; } 49  50 #endregion 51  52 #region IEntity成员 53  54 public virtual bool? Active { get; set; } = true; 55 public virtual bool IsDeleted { get; set; } 56 public virtual DateTimeOffset CreationTime { get; set; } = DateTimeOffset.Now; 57 public virtual DateTimeOffset LastModificationTime { get; set; } = DateTimeOffset.Now; 58  59 #endregion 60  61 #region IDomainEntity成员 62  63 public virtual TKey? CreatorId { get; set; } 64 public virtual TIdentityUser Creator { get; set; } 65 public virtual TKey? LastModifierId { get; set; } 66 public virtual TIdentityUser LastModifier { get; set; } 67  68 #endregion 69  70 #region ITree成员 71  72 public virtual TIdentityRole Parent { get; set; } 73  74 public virtual IList<TIdentityRole> Children { get; set; } 75  76  [DoNotNotify, NotMapped] 77 public virtual int Depth => Parent?.Depth + 1 ?? 0; 78  79  [DoNotNotify, NotMapped] 80 public virtual bool IsRoot => Parent == null; 81  82  [DoNotNotify, NotMapped] 83 public virtual bool IsLeaf => Children?.Count == 0; 84  85  [DoNotNotify, NotMapped] 86 public virtual bool HasChildren => !IsLeaf; 87  88  [DoNotNotify, NotMapped] 89 public virtual string Path => Parent == null ? Id.ToString() : $@"{Parent.Path}/{Id}"; 90  91 #endregion 92  93 #region IPropertyChangeTrackable成员 94  95 private static readonly object Locker = new object(); 96 private static readonly Dictionary<Type, string[]> PropertyNamesDictionary = new Dictionary<Type, string[]>(); 97  98 private readonly BitArray _propertyChangeMask; 99 100 /// <summary>101 /// 全局属性变更通知事件处理器102 /// </summary>103 public static PropertyChangedEventHandler PublicPropertyChangedEventHandler { get; set; }104 105 /// <summary>106 /// 初始化用于跟踪属性变更所需的属性信息107 /// </summary>108 protected ApplicationRole()109  {110 //判断类型是否已经加入字典111 //将未加入的类型添加进去（一般为该类对象首次初始化时）112 var type = this.GetType();113 if (!PropertyNamesDictionary.ContainsKey(type))114  {115 lock (Locker)116  {117 if (!PropertyNamesDictionary.ContainsKey(type))118  {119  PropertyNamesDictionary.Add(type, type.GetProperties()120 .OrderBy(property => property.Name)121 .Select(property => property.Name).ToArray());122  }123  }124  }125 126 //初始化属性变更掩码127 _propertyChangeMask = new BitArray(PropertyNamesDictionary[type].Length, false);128 129 //注册全局属性变更事件处理器130 if (PublicPropertyChangedEventHandler != null)131  {132 PropertyChanged += PublicPropertyChangedEventHandler;133  }134  }135 136 /// <summary>137 /// 属性变更事件138 /// </summary>139 public event PropertyChangedEventHandler PropertyChanged;140 public event PropertyChangedExtensionEventHandler PropertyChangedExtension;141 142 /// <summary>143 /// 内部属性变更事件处理器144 /// </summary>145 /// <param name="propertyName">属性名</param>146 /// <param name="oldValue">旧值</param>147 /// <param name="newValue">新值</param>148 protected virtual void OnPropertyChanged(string propertyName, object oldValue, object newValue)149  {150 //Perform property validation151 152 _propertyChangeMask[Array.IndexOf(PropertyNamesDictionary[this.GetType()], propertyName)] = true;153 154 PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propertyName));155 PropertyChangedExtension?.Invoke(this, new PropertyChangedExtensionEventArgs(propertyName, oldValue, newValue));156  }157 158 /// <summary>159 /// 判断指定的属性或任意属性是否被变更过（<see cref="IPropertyChangeTrackable"/>接口的实现）160 /// </summary>161 /// <param name="names">指定要判断的属性名数组，如果为空(null)或空数组则表示判断任意属性。</param>162 /// <returns>163 /// <para>如果指定的<paramref name="names"/>参数有值，当只有参数中指定的属性发生过更改则返回真(True)，否则返回假(False)；</para>164 /// <para>如果指定的<paramref name="names"/>参数为空(null)或空数组，当实体中任意属性发生过更改则返回真(True)，否则返回假(False)。</para>165 /// </returns>166 public bool HasChanges(params string[] names)167  {168 if (!(names?.Length > 0))169  {170 foreach (bool mask in _propertyChangeMask)171  {172 if (mask == true)173  {174 return true;175  }176  }177 178 return false;179  }180 181 var type = this.GetType();182 foreach (var name in names)183  {184 var index = Array.IndexOf(PropertyNamesDictionary[type], name);185 if (index >= 0 && _propertyChangeMask[index] == true)186  {187 return true;188  }189  }190 191 return false;192  }193 194 /// <summary>195 /// 获取实体中发生过变更的属性集（<see cref="IPropertyChangeTrackable"/>接口的实现）196 /// </summary>197 /// <returns>如果实体没有属性发生过变更，则返回空白字典，否则返回被变更过的属性键值对</returns>198 public IDictionary<string, object> GetChanges()199  {200 Dictionary<string, object> changeDictionary = new Dictionary<string, object>();201 var type = this.GetType();202 for (int i = 0; i < _propertyChangeMask.Length; i++)203  {204 if (_propertyChangeMask[i] == true)205  {206  changeDictionary.Add(PropertyNamesDictionary[type][i],207 type.GetProperty(PropertyNamesDictionary[type][i])?.GetValue(this));208  }209  }210 211 return changeDictionary;212  }213 214 /// <summary>215 /// 重置指定的属性或任意属性变更状态（为未变更）（<see cref="IPropertyChangeTrackable"/>接口的实现）216 /// </summary>217 /// <param name="names">指定要重置的属性名数组，如果为空(null)或空数组则表示重置所有属性的变更状态（为未变更）</param>218 public void ResetPropertyChangeStatus(params string[] names)219  {220 if (names?.Length > 0)221  {222 var type = this.GetType();223 foreach (var name in names)224  {225 var index = Array.IndexOf(PropertyNamesDictionary[type], name);226 if (index >= 0)227  {228 _propertyChangeMask[index] = false;229  }230  }231  }232 else233  {234 _propertyChangeMask.SetAll(false);235  }236  }237 238 #endregion239 }

View Code

可以看到我在为 IdentityRole 添加接口实现的时候添加的是 IDomainTreeEntity 接口。在这里我把 Role 改成了树形数据类型，也就是说一个角色可以是另一个角色的子角色，构成树状关系。当然如果就当作普通的 Role 来使用也没有任何问题，这个扩展完全不会破坏任何内置功能，没有任何侵入性，按需选用就好，至于能发挥什么作用，完全看脑洞有多大 (●‘?‘●)

然而，这还不是全部，不然就对不起魔改的名号了。现在看见的代码还不是最终形态。因为使用了 PropertyChanged.Fody 这个库，所有的实体都可以向外发送属性变更通知，至于能发挥什么作用，还是看脑洞。

代码最终形态预览（此处使用了 ILSpy 反编译引擎的 Nuget 包，详情见我之前的博客C# 编译器和反编译器，你要哪个（歪头）？我全都要（捏拳）！）：