abp vnext扩展实体

对于模块的实体属性，都是在模块中定义好的，无法更改模块内部代码。我们可以通过扩展实体来向模块实体增加属性。

Extra Properties

Extra properties是一种存储实体的一些额外数据但不用更改实体的方式. 实体应该实现 IHasExtraProperties 接口. 所有预构建模块定义的聚合根实体都实现了 IHasExtraProperties 接口,所以你可以在这些实体中存储额外的属性.
示例:

//SET AN EXTRA PROPERTY
var user = await _identityUserRepository.GetAsync(userId);
user.SetProperty("Title", "My custom title value!");
await _identityUserRepository.UpdateAsync(user);

//GET AN EXTRA PROPERTY
var user = await _identityUserRepository.GetAsync(userId);
return user.GetProperty<string>("Title");

这种方法开箱即用并且非常简单,你可以使用不同的属性名称(如这里的Title)在同一时间存储多个属性.
对于EF Core额外的属性被格式化成单个 JSON 字符值串存储在数据库中. 对于MongoDB它们做为单独的字段存储.

实体扩展 (EF Core)

如上所述,实体所有的额外属性都作为单个JSON对象存储在数据库表中. 它不适用复杂的场景,特别是在你需要的时候.

使用额外属性创建索引和外键.
使用额外属性编写SQL或LINQ(例如根据属性值搜索).
创建你自己的实体映射到相同的表,但在实体中定义一个额外属性做为常规属性

为了解决上面的问题,用于EF Core的ABP框架实体扩展系统允许你使用上面定义相同的额外属性API,但将所需的属性存储在单独的数据库表字段中.

假设你想要添加 SocialSecurityNumber 到身份模块的 IdentityUser 实体. 你可以使用 ObjectExtensionManager 类:
扩展实体，在项目Project.EntityFrameworkCore的ProjectEfCoreEntityExtensionMappings文件中添加如下代码

ObjectExtensionManager.Instance
    .MapEfCoreProperty<IdentityUser, string>(
        "SocialSecurityNumber",
        (entityBuilder, propertyBuilder) =>
        {
            propertyBuilder.HasMaxLength(32);
        }
    );

扩展DTO，在项目Project.Application.Contracts的ProjectDtoExtensions文件中添加如下代码

ObjectExtensionManager.Instance
    .AddOrUpdateProperty<string>(
        new[] {
            typeof(IdentityUserDto),
            typeof(IdentityUserCreateDto),
            typeof(IdentityUserUpdateDto),
            typeof(ProfileDto),
            typeof(UpdateProfileDto)
        }, "SocialSecurityNumber"
    )
    .AddOrUpdateProperty<Guid>(
        new[] {
            typeof(IdentityUserDto),
            typeof(IdentityUserCreateDto),
            typeof(IdentityUserUpdateDto),
            typeof(ProfileDto),
            typeof(UpdateProfileDto)
        }, "IdentityInfo"
    );

然后就是添加迁移更新数据库了：
Add-Migration Added_AppUser_Properties
运行 Update-Database 或着运行DbMigrator项目来更新

最后编辑于：2021.05.14 17:18:56