這一節我們說說資料庫遷移(Migration)。
我們之前用的DBFirst建立了實體類,但當初這麼做的原因是為了節省時間。現在我們通過建立的實體類和DbContext類利用EF的Code First資料庫遷移反過來建立資料庫。ABP模板預設開啟了遷移,並且新增了一下下面的Configuration類:
namespace Noah.ChargeStation.Migrations { internal sealed class Configuration : DbMigrationsConfiguration<ChargeStation.EntityFramework.ChargeStationDbContext> { public Configuration() { AutomaticMigrationsEnabled = false; ContextKey = "ChargeStation"; } /// <summary> /// 新增種子資料,比如預設管理員等資料 /// </summary> /// <param name="context">當前資料庫上下文子類</param> protected override void Seed(ChargeStation.EntityFramework.ChargeStationDbContext context) { context.DisableAllFilters(); new InitialDataBuilder(context).Build(); } } }
namespace Noah.ChargeStation.Migrations.SeedData { public class DefaultTenantRoleAndUserBuilder { private readonly ChargeStationDbContext _context; public DefaultTenantRoleAndUserBuilder(ChargeStationDbContext context) { _context = context; } public void Build() { CreateUserAndRoles(); } private void CreateUserAndRoles() { //Admin role for tenancy owner var adminRoleForTenancyOwner = _context.Roles.FirstOrDefault(r => r.TenantId == null && r.Name == "Admin"); if (adminRoleForTenancyOwner == null) { adminRoleForTenancyOwner = _context.Roles.Add(new Role { Name = "Admin", DisplayName = "Admin", IsStatic = true }); _context.SaveChanges(); } //Admin user for tenancy owner var adminUserForTenancyOwner = _context.Users.FirstOrDefault(u => u.TenantId == null && u.UserName == "admin"); if (adminUserForTenancyOwner == null) { adminUserForTenancyOwner = _context.Users.Add( new User { TenantId = null, UserName = "admin", Name = "System", Surname = "Administrator", EmailAddress = "admin@aspnetboilerplate.com", IsEmailConfirmed = true, Password = "AM4OLBpptxBYmM79lGOX9egzZk3vIQU3d/gFCJzaBjAPXzYIK3tQ2N7X4fcrHtElTw==" //123qwe }); _context.SaveChanges(); _context.UserRoles.Add(new UserRole(adminUserForTenancyOwner.Id, adminRoleForTenancyOwner.Id)); _context.SaveChanges(); } //Default tenant var defaultTenant = _context.Tenants.FirstOrDefault(t => t.TenancyName == "Default"); if (defaultTenant == null) { defaultTenant = _context.Tenants.Add(new Tenant { TenancyName = "Default", Name = "Default" }); _context.SaveChanges(); } //Admin role for 'Default' tenant var adminRoleForDefaultTenant = _context.Roles.FirstOrDefault(r => r.TenantId == defaultTenant.Id && r.Name == "Admin"); if (adminRoleForDefaultTenant == null) { adminRoleForDefaultTenant = _context.Roles.Add(new Role { TenantId = defaultTenant.Id, Name = "Admin", DisplayName = "Admin", IsStatic = true }); _context.SaveChanges(); } //Admin for 'Default' tenant var adminUserForDefaultTenant = _context.Users.FirstOrDefault(u => u.TenantId == defaultTenant.Id && u.UserName == "admin"); if (adminUserForDefaultTenant == null) { adminUserForDefaultTenant = _context.Users.Add( new User { TenantId = defaultTenant.Id, UserName = "admin", Name = "System", Surname = "Administrator", EmailAddress = "admin@aspnetboilerplate.com", IsEmailConfirmed = true, Password = "AM4OLBpptxBYmM79lGOX9egzZk3vIQU3d/gFCJzaBjAPXzYIK3tQ2N7X4fcrHtElTw==" //123qwe }); _context.SaveChanges(); _context.UserRoles.Add(new UserRole(adminUserForDefaultTenant.Id, adminRoleForDefaultTenant.Id)); _context.SaveChanges(); } } } }
在Seed方法中,新增了租戶,角色和使用者資料。現在,我來建立初始化遷移。開啟包管理器控制檯,輸入下面的命令:
此處特別注意,紅色方框中一定不要忘了選擇EF專案,否則不會有下面出現的命令“Add-Migration”,”InitialData”是生成檔案的字尾名(也是檔案中類的名字),也可以取其他名字。
可以看到生成的檔案一個以cs結尾,這裡面的程式碼是建立資料庫中表的,另一個以Designer.cs結尾,記錄的是資料庫遷移的版本記錄,最後一個以.resx檔案是資原始檔,暫且不需要考慮。
剛才我們只是建立了建立資料庫所需要的類,但還沒有建立資料庫。為了建立資料庫,需要在包管理控制檯執行以下命令:
PM> Update-Database
該命令完成了這次資料庫的遷移,建立了資料庫並填充了種子資料。
當我們改變實體類時,可以使用Add-Migration命令建立新的遷移類和Update-Database命令更新資料庫。
至此,資料庫遷移完成。下一次我們說說《定義倉儲》。