在ABPZERO中,扩展实体的方法。

内容

  1. 介绍

  2. 扩展的抽象实体

    1. 将新属性添加给用户

    2. 添加迁移

    3. 在界面上显示地址

    4. 在用户编辑/添加功能中添加地址

  3. 扩展的非抽象类实体

    1. 获得版本的派生实体

    2. 添加迁移

    3. 在界面上添加价格

    4. 在创建/编辑版本功能中加入价格

  4. 源代码


介绍

本教程是一步一步指南以了解如何添加新的属性,对现有的实体,从数据库层和 UI 层。

在 AspNet ZERO中的Tenant、User和Role的实体都算 抽象的,另一些则不。有一些差异。所以,我们分离它分成两个部分。

扩展抽象实体

我们用User实体作为例子。我们想要将address 属性添加到实体中。

将新属性添加到用户

打开 Authorization\Users\User.cs (在.CORE类库中) 并添加新的属性 ︰

public class User : AbpUser<Tenant, User>
{
    //...existing code

    public virtual string Address { get; set; }
}

在这里,我们隐藏了其他代码仅仅为了显示简单的用户类。
然后您可以添加地址属性的属性。

添加迁移

由于我们添加新的属性,我们数据库架构已更改。不论我们改变我们的实体,我们应添加新的数据库迁移。打开控制台软件包管理器并编写新的迁移代码 ︰

Add-Migration "Added_Address_To_User"

得到一个迁移类:

public partial class Added_Address_To_User : DbMigration
{
    public override void Up()
    {
        AddColumn("dbo.AbpUsers", "Address", c => c.String());
    }
        
    public override void Down()
    {
        DropColumn("dbo.AbpUsers", "Address");
    }
}

然后更新数据库:

Update-Database

然后打开数据库中的“AbpUsers”表,可以看到一个新的“Address”字段:


在ABPZERO中,扩展实体的方法。
image

便于测试,我们添加了一些用户数据。

在UI界面上显示address字段

从Authorization\Users\UserAppService.cs (in .Application 类库中)
获取用户列表。
他的返回dto为“UserListDto ”。所以我们要修改他。

[AutoMapFrom(typeof(User))]
public class UserListDto : EntityDto<long>, IPassivable, IHasCreationTime
{
    //...existing code

    public string Address { get; set; }
}

UserListDto 是通过automapper自动映射的,所以不需要修改UserAppService.GetUsers方法.
然后我们去ui层,路径Web\App\common\views\users\index.js 添加name属性为“address” 的值。

然后运行项目,然后打开用户列表:


在ABPZERO中,扩展实体的方法。
44

上面的例子是通过SPA来演示的。如果要使用MPA,操作也是类似的,只要打开WEB项目中的Web\Areas\Mpa\Views\Users\index.js,添加字段就可以。

在添加和编辑页面上添加address

客户端使用 UserAppService.GetUserForEdit方法来编辑窗体上显示用户信息。它返回GetUserForEditOutput对象,其中包含一个UserEditDto对象,包括用户属性。所以,我们应该将地址添加到 UserEditDto,以允许客户端上创建更新地址属性更改 ︰

public class UserEditDto : IValidate, IPassivable
{
    //...existing code

    public string Address { get; set; }
}

然后打开路径"Web\App\common\views\users\createOrEditModal.cshtml"
添加以下代码

<div class="form-group form-md-line-input form-md-floating-label no-hint">
    <input type="text" name="Address" class="form-control" ng-class="{'edited':vm.user.address}" ng-model="vm.user.address">
    <label>@L("Address")</label>
</div>

然后运行项目:

在ABPZERO中,扩展实体的方法。
image

此处我们没有使用本地化文本,如果要启用的话,Core类库中\Localization\ExtendEntitiesDemo中的XML文件打开。

拓展非抽象实体

我们拿Edition实体作为示例

获得Edition的派生实体

由于 Edition不是抽象对象,我们无法给他添加新属性。但是我们可以使用OOP模式中的
继承和组合(inheritance or composition)。

我们使用简单的继承,创建一个新类MyEdition继承Edition。

public class MyEdition : Edition
{
    public virtual int Price { get; set; }
}

添加迁移

添加迁移

由于我们添加一个新的实体类,我们数据库架构已更改。不论我们改变我们的实体,我们应添加新的数据库迁移。打开控制台软件包管理器并编写新的迁移代码 ︰

Add-Migration "Added_MyEdition_Entity"

这将创建一个新的实体框架迁移类,如下所示 ︰

public partial class Added_MyEdition_Entity : DbMigration
{
    public override void Up()
    {
        AlterTableAnnotations(
            "dbo.AbpEditions",
            c => new
            {
                Id = c.Int(nullable: false, identity: true),
                Name = c.String(nullable: false, maxLength: 32),
                DisplayName = c.String(nullable: false, maxLength: 64),
                IsDeleted = c.Boolean(nullable: false),
                DeleterUserId = c.Long(),
                DeletionTime = c.DateTime(),
                LastModificationTime = c.DateTime(),
                LastModifierUserId = c.Long(),
                CreationTime = c.DateTime(nullable: false),
                CreatorUserId = c.Long(),
                Price = c.Int(),
                Discriminator = c.String(nullable: false, maxLength: 128),
            },
            annotations: new Dictionary<string, AnnotationValues>
            {
                {
                    "DynamicFilter_MyEdition_SoftDelete",
                    new AnnotationValues(oldValue: null, newValue: "EntityFramework.DynamicFilters.DynamicFilterDefinition")
                },
            });

        AddColumn("dbo.AbpEditions", "Price", c => c.Int(nullable: false, defaultValue: 0));
        AddColumn("dbo.AbpEditions", "Discriminator", c => c.String(nullable: false, maxLength: 128, defaultValue: "MyEdition"));
    }

    public override void Down()
    {
        //...other code
    }
}

实际上,AbpEditions 迁移中,添加两个新字段:

  • Price: 这个是我们添加到MyEdition中的价格字段
  • Discriminator: EF实体框架来区别Edition和MyEdition的区别(自动创建的继承)

在更新数据库之前,我们需要改下默认的迁移代码:

AddColumn("dbo.AbpEditions", "Price", c => c.Int());
AddColumn("dbo.AbpEditions", "Discriminator", c => c.String(nullable: false, maxLength: 128));

修改为:

AddColumn("dbo.AbpEditions", "Price", c => c.Int(nullable: false, defaultValue: 0));
AddColumn("dbo.AbpEditions", "Discriminator", c => c.String(nullable: false, maxLength: 128, defaultValue: "MyEdition"));

这样做的目的是为了让MyEdition替换为现有的Edition实体。

Update-Database

打开表“AbpEditions”看到的新字段:

在ABPZERO中,扩展实体的方法。
image

然后我们可以看到现有的标准版的价格被MyEdition修改为0。

有关迁移的最后一件事情就是 Seed Code 中。我们需要进行修改EntityFramework\Migrations\Seed\DefaultEditionCreator.cs:

defaultEdition = new Edition { Name = EditionManager.DefaultEditionName, DisplayName = EditionManager.DefaultEditionName };

修改为

defaultEdition = new MyEdition { Name = EditionManager.DefaultEditionName, DisplayName = EditionManager.DefaultEditionName };

因此,我们创建新数据库的时候,会创建MyEdition实体。

在UI界面上显示价格

从application类库中打开Editions\EditionAppService.cs ,调用getlist方法。
返回值是:EditionListDto (ABPZERO只会用DTO进行客户端之间的通信)。

所以我们的需要把价格属性添加到“EditionListDto”中:

[AutoMapFrom(typeof(Edition), typeof(MyEdition))]
public class EditionListDto : EntityDto, IHasCreationTime
{
    //...existing code

    public int Price { get; set; }
}

然后就是automapper自动映射,不用进行处理。

然后打开WEB类库中的“Web\App\host\views\editions\index.js”,添加name属性为“Price”:

{
    name: app.localize('EditionName'),
    field: 'displayName'
},
{
    name: app.localize('Price'),
    field: 'price'
},
{
    name: app.localize('CreationTime'),
    field: 'creationTime',
    cellFilter: 'momentFormat: \'L\''
}

然后运行项目:


在ABPZERO中,扩展实体的方法。
image
上一篇:[ABP框架]动态web Api的拦截用法。


下一篇:[ABP开源项目]--vue+vuex+vue-router+EF的权限管理系统