ABP入門(mén)系列目錄——學(xué)習(xí)Abp框架之實(shí)操演練
源碼路徑:Github-LearningMpaAbp
這一節(jié)我們主要和領(lǐng)域?qū)?/strong>打交道。首先我們要對(duì)ABP的體系結(jié)構(gòu)以及從模板創(chuàng)建的解決方案進(jìn)行一一對(duì)應(yīng)乡翅。網(wǎng)上有代碼生成器去簡(jiǎn)化我們這一步的任務(wù),但是不建議初學(xué)者去使用。
一、首先來(lái)看看ABP體系結(jié)構(gòu)
領(lǐng)域?qū)?/strong>就是業(yè)務(wù)層,是一個(gè)項(xiàng)目的核心,所有業(yè)務(wù)規(guī)則都應(yīng)該在領(lǐng)域?qū)訉?shí)現(xiàn)材失。
實(shí)體(Entity): 實(shí)體代表業(yè)務(wù)領(lǐng)域的數(shù)據(jù)和操作,在實(shí)踐中硫豆,通過(guò)用來(lái)映射成數(shù)據(jù)庫(kù)表龙巨。
倉(cāng)儲(chǔ)(Repository): 倉(cāng)儲(chǔ)用來(lái)操作數(shù)據(jù)庫(kù)進(jìn)行數(shù)據(jù)存取。倉(cāng)儲(chǔ)接口在領(lǐng)域?qū)佣x熊响,而倉(cāng)儲(chǔ)的實(shí)現(xiàn)類(lèi)應(yīng)該寫(xiě)在基礎(chǔ)設(shè)施層旨别。
領(lǐng)域服務(wù)(Domain service): 當(dāng)處理的業(yè)務(wù)規(guī)則跨越兩個(gè)(及以上)實(shí)體時(shí),應(yīng)該寫(xiě)在領(lǐng)域服務(wù)方法里面汗茄。
領(lǐng)域事件(Domain Event): 在領(lǐng)域?qū)佑行┨囟ㄇ闆r發(fā)生時(shí)可以觸發(fā)領(lǐng)域事件秸弛,并且在相應(yīng)地方捕獲并處理它們。
工作單元(Unit of Work): 工作單元是一種設(shè)計(jì)模式洪碳,用于維護(hù)一個(gè)由已經(jīng)被修改(如增加递览、刪除和更新等)的業(yè)務(wù)對(duì)象組成的列表。它負(fù)責(zé)協(xié)調(diào)這些業(yè)務(wù)對(duì)象的持久化工作及并發(fā)問(wèn)題瞳腌。
二绞铃、再來(lái)看看解決方案
確定了解決方案下每個(gè)項(xiàng)目分別對(duì)應(yīng)那一層后,我們開(kāi)始創(chuàng)建Task實(shí)體纯趋。
三憎兽、創(chuàng)建Task實(shí)體
1.在領(lǐng)域?qū)觿?chuàng)建Tasks文件夾冷离,并創(chuàng)建Task實(shí)體類(lèi)吵冒;
2.ABP中所有的實(shí)體類(lèi)都繼承自Entity
,而Entity
實(shí)現(xiàn)了IEntity
接口西剥;而IEntity
接口是一個(gè)泛型接口痹栖,通過(guò)泛型指定主鍵Id類(lèi)型,默認(rèn)的Entity
的主鍵類(lèi)型是int類(lèi)型瞭空。
創(chuàng)建Task揪阿,肯定需要保存創(chuàng)建時(shí)間,可以通過(guò)實(shí)現(xiàn)審計(jì)模塊中的IHasCreationTime
來(lái)實(shí)現(xiàn)這種通用功能咆畏。代碼如下:
namespace LearningMpaAbp.Tasks
{
public class Task : Entity, IHasCreationTime
{
public const int MaxTitleLength = 256;
public const int MaxDescriptionLength = 64 * 1024;//64kb
public long? AssignedPersonId { get; set; }
[ForeignKey("AssignedPersonId")]
public User AssignedPerson { get; set; }
[Required]
[MaxLength(MaxTitleLength)]
public string Title { get; set; }
[Required]
[MaxLength(MaxDescriptionLength)]
public string Description { get; set; }
public TaskState State { get; set; }
public DateTime CreationTime { get; set; }
public Task()
{
CreationTime = Clock.Now;
State = TaskState.Open; ;
}
public Task(string title, string description = null) : this()
{
Title = title;
Description = description;
}
}
public enum TaskState : byte
{
Open = 0,
Completed = 1
}
}
其中定義了TaskState
狀態(tài)枚舉南捂。并添加了AssignedPerson
導(dǎo)航屬性,用來(lái)保存分配任務(wù)到某個(gè)用戶旧找。其中[Required]溺健、[MaxLength]特性是用來(lái)進(jìn)行輸入校驗(yàn)的。
3.定義好實(shí)體之后钮蛛,我們就要去DbContext
中定義實(shí)體對(duì)應(yīng)的DbSet
鞭缭,以應(yīng)用Code First 數(shù)據(jù)遷移剖膳。找到我們的基礎(chǔ)服務(wù)層,即以EntityFramework結(jié)尾的項(xiàng)目中岭辣,找到DbContext類(lèi)吱晒,添加以下代碼
//TODO: Define an IDbSet for your Entities...
public IDbSet<Task> Tasks { get; set; }
4.執(zhí)行Code First數(shù)據(jù)遷移。
- 打開(kāi)程序包管理器控制臺(tái)沦童,默認(rèn)項(xiàng)目選擇Entityframework對(duì)應(yīng)的項(xiàng)目后仑濒。執(zhí)行
Add-Migration Add_Task_Entity
,創(chuàng)建遷移偷遗。 - 創(chuàng)建成功后躏精,會(huì)在Migrations文件夾下創(chuàng)建
時(shí)間_Add_Task_Entity
格式的類(lèi)文件。如果注意觀察鹦肿,我們會(huì)發(fā)現(xiàn)Migrations文件夾下有個(gè)SeedData文件夾矗烛,顧名思義,這個(gè)文件夾下的類(lèi)主要是用來(lái)進(jìn)行預(yù)置種子數(shù)據(jù)的箩溃。我們可以參照已有類(lèi)的寫(xiě)法瞭吃,來(lái)預(yù)置兩條Task。創(chuàng)建DefaultTestDataForTask
類(lèi)涣旨,代碼如下:
namespace LearningMpaAbp.Migrations.SeedData
{
public class DefaultTestDataForTask
{
private readonly LearningMpaAbpDbContext _context;
private static readonly List<Task> _tasks;
public DefaultTestDataForTask(LearningMpaAbpDbContext context)
{
_context = context;
}
static DefaultTestDataForTask()
{
_tasks = new List<Task>()
{
new Task("Learning ABP deom", "Learning how to use abp framework to build a MPA application."),
new Task("Make Lunch", "Cook 2 dishs")
};
}
public void Create()
{
foreach (var task in _tasks)
{
if (_context.Tasks.FirstOrDefault(t => t.Title == task.Title) == null)
{
_context.Tasks.Add(task);
}
_context.SaveChanges();
}
}
}
}
然后在Configuration
類(lèi)中的Seed
方法中歪架,添加以下代碼。
new DefaultTestDataForTask(context).Create();
- 在程序包管理器控制臺(tái)霹陡,輸入
Update-Database
和蚪,回車(chē)執(zhí)行遷移。執(zhí)行成功后烹棉,查看數(shù)據(jù)庫(kù)攒霹,Tasks表創(chuàng)建成功,且表中已存在兩條測(cè)試數(shù)據(jù)浆洗。
至此催束,Task實(shí)體類(lèi)成功創(chuàng)建。
源碼已上傳至Github-LearningMpaAbp伏社,可自行參考抠刺。