内容
-
介绍
-
扩展的抽象实体
-
将新属性添加给用户
-
添加迁移
-
在界面上显示地址
-
在用户编辑/添加功能中添加地址
-
-
扩展的非抽象类实体
-
获得版本的派生实体
-
添加迁移
-
在界面上添加价格
-
在创建/编辑版本功能中加入价格
-
-
源代码
介绍
本教程是一步一步指南以了解如何添加新的属性,对现有的实体,从数据库层和 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”字段:
便于测试,我们添加了一些用户数据。
在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” 的值。
然后运行项目,然后打开用户列表:
上面的例子是通过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>
然后运行项目:
此处我们没有使用本地化文本,如果要启用的话,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”看到的新字段:
然后我们可以看到现有的标准版的价格被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\''
}
然后运行项目: