abp(net core)+easyui+efcore倉儲系統——領域層建立實體(三)
abp(net core)+easyui+efcore倉儲系統目錄
abp(net core)+easyui+efcore倉儲系統——ABP總體介紹(一）
abp(net core)+easyui+efcore倉儲系統——解決方案介紹(二)
在上二篇文章中我們簡單介紹了一下ABP.TPLMS系統的概況，已經對ABP的體系結構以及專案結構有了一個初步的瞭解。在這一篇文章中我們主要和領域層打交道，主要是建立實體與進行遷移。接下來我們開始建立Module實體。
一、建立Module實體
實體是DDD（領域驅動設計）的核心概念之一。Eirc Evans是這樣描述的實體的：“它根本上不是通過屬性定義的，而是通過一系列連續性和標識定義的”。因此，實體都有Id屬性並且都儲存到資料庫中。一個實體一般會對映到資料庫的一張表。現在我們來完成以下任務：在領域層建立一個Entitys資料夾，並在這個資料夾中建立Module實體類。
1. 在Visual Studio 2017的“解決方案資源管理器”中，右鍵單擊“ABP.TPLMS.Core”專案。 選擇“新增” > “新建資料夾”。如下圖。
2．將資料夾命名為“Entitys”。
3． 右鍵單擊“Entitys”資料夾，然後選擇“新增” > “類”。 將類命名為 Module，然後選擇“新增”。如下圖。
4.ABP中所有的實體類都繼承自Entity，而Entity實現了IEntity介面；而IEntity介面是一個泛型介面，通過泛型指定主鍵Id型別，預設的Entity的主鍵型別是int型別。如下圖。
5.建立Module類，肯定需要儲存建立時間，可以通過實現審計模組中的IHasCreationTime來實現這種通用功能。如下圖。
6. abp中實體是派生於Entity類，先看一下我們在Core層新建的Module類。程式碼如下：
using Abp.Domain.Entities;
using Abp.Domain.Entities.Auditing;
using Abp.Timing;
using System;
using System.Collections.Generic;
using System.ComponentModel.DataAnnotations;
using System.Text;
namespace ABP.TPLMS.Entitys
{
public class Module:Entity, IHasCreationTime
{
public const int MaxLength = 255;
public Module()
{
this.DisplayName = string.Empty;
this.Name = string.Empty;
this.Url = string.Empty;
this.HotKey = string.Empty;
this.ParentId = 0;
this.IconName = string.Empty;
this.Status = 0;
this.ParentName = string.Empty;
this.RequiredPermissionName = string.Empty;
this.RequiresAuthentication = false;
this.SortNo = 0;
CreationTime = Clock.Now;
}
[Required]
[StringLength(MaxLength)]
public string DisplayName { get; set; }
[Required]
[StringLength(MaxLength)]
public string Name { get; set; }
[Required]
[StringLength(MaxLength)]
public string Url { get; set; }
[StringLength(MaxLength)]
public string HotKey { get; set; }
public int ParentId { get; set; }
public bool RequiresAuthentication { get; set; }
public bool IsAutoExpand { get; set; }
[StringLength(MaxLength)]
public string IconName { get; set; }
public int Status { get; set; }
[Required]
[StringLength(MaxLength)]
public string ParentName { get; set; }
[StringLength(MaxLength)]
public string RequiredPermissionName { get; set; }
public int SortNo { get; set; }
public DateTime CreationTime { get; set; }
}
}
在上面的Module實體類中的一些屬性上我們定義了[Required]、[MaxLength]等特性用來進行輸入校驗的。
上面的Module實體類，沒有新增Id屬性，為什麼呢？因為Module繼承自Entity類，Entity類已經定義Id，它是該Entity類的主鍵。因此，所有繼承Entity類的實體類的主鍵名都是Id。
Id（主鍵）的型別是可以更改的，預設是int(int32)。如果你想將Id定義為其他型別，可以在<>內寫,比如Guid,long也是可以的。
Entity類重寫了等號運算子（==），可以輕鬆地檢查兩個實體是否相同了（實體的Id相同則認為它們相同）。它也定義了IsTransient方法來檢測它是否有Id。
IHasCreationTime介面使用一個通用的屬性來描述一個實體的“建立時間”。當實現了該介面的實體類插入到資料庫中時，ABP會自動地將當前的時間設定給CreationTime。
7.定義好實體之後，我們就要去DbContext中定義實體對應的DbSet，以應用Code First 資料遷移。找到我們的基礎服務層，即以EntityFrameworkCore結尾的專案中，找到DbContext類，如下圖，新增以下程式碼。
using Microsoft.EntityFrameworkCore;
using Abp.Zero.EntityFrameworkCore;
using ABP.TPLMS.Authorization.Roles;
using ABP.TPLMS.Authorization.Users;
using ABP.TPLMS.MultiTenancy;
using ABP.TPLMS.Entitys;
namespace ABP.TPLMS.EntityFrameworkCore
{
public class TPLMSDbContext : AbpZeroDbContext<Tenant, Role, User, TPLMSDbContext>
{
/* Define a DbSet for each entity of the application */
public TPLMSDbContext(DbContextOptions<TPLMSDbContext> options)
: base(options)
{
}
public DbSet<Module> Modules { get; set; }
}
}
二、執行Code First資料遷移，
1.從選單中選擇“工具->NuGet包管理器器—>程式包管理器控制檯”選單。如下圖。
2. 在PMC中，預設專案選擇EntityframeworkCore對應的專案後。輸入以下命令：Add-Migration AddEntityModule，建立遷移。如下圖。
3. 在上面的命令執行完畢之後，建立成功後，會在Migrations資料夾下建立時間_AddEntityModule格式的類檔案，這些程式碼是基於DbContext指定的模型。如下圖。
4.在程式包管理器控制檯，輸入Update-Database，回車執行遷移。執行成功後，檢視資料庫，Moudles表建立成功。如下圖。