建立實體

如下所示專案下建立blog/notes資料夾，並加入我們的實體檔案

/// <summary>
    /// 文章資訊
    /// </summary>
    public class Note : Entity, IHasCreationTime, IHasDeletionTime, IHasModificationTime, ICreationAudited
    {
        /// <summary>
        /// 標題
        /// </summary>
        public string Title { get
 
; set; }
        /// <summary>
        /// 內容
        /// </summary>
        public string Content { get; set; }
        /// <summary>
        /// 建立時間
        /// </summary>
        public DateTime CreationTime { get; set; }
        /// <summary>
        /// 刪除時間
        /// </summary>
        public
 
 DateTime? DeletionTime { get; set; }
        /// <summary>
        /// 是否刪除
        /// </summary>
        public bool IsDeleted { get; set; }
        /// <summary>
        /// 上次修改時間
        /// </summary>
        public DateTime? LastModificationTime { get; set; }
        /// <summary>
        ///
 
 建立人
        /// </summary>
        public long? CreatorUserId { get; set; }
        /// <summary>
        /// 點贊次數
        /// </summary>
        public long Like { get; set; }
        /// <summary>
        /// 收藏次數
        /// </summary>
        public long Collect { get; set; }
        /// <summary>
        /// 瀏覽次數
        /// </summary>
        public long Scan { get; set; }
        /// <summary>
        /// 內容的資料型別 markdown內容，html內容，或者其他
        /// </summary>
        public int TextType { get; set; }
        /// <summary>
        /// 簡單描述，用於微信推送時的描述或者其他
        /// </summary>
        public string Des { get; set; }
        /// <summary>
        /// 封面圖片，可用於微信推送時或者其他
        /// </summary>
        public string Img { get; set; }
        /// <summary>
        /// 關鍵字，可用於搜尋，分類等
        /// </summary>
        public string Tags { get; set; }
        /// <summary>
        /// 是否釋出
        /// </summary>
        public bool IsPublic { get; set; }
    }

/// <summary>
    /// 文章專輯
    /// </summary>
    public class NoteBook : Entity, IHasCreationTime, IHasDeletionTime, IHasModificationTime, ICreationAudited
    {
        /// <summary>
        /// 專輯名稱
        /// </summary>
        public string Name { get; set; }
        /// <summary>
        /// 專輯描述
        /// </summary>
        public string Des { get; set; }
        /// <summary>
        /// 專輯封面
        /// </summary>
        public string Img { get; set; }
        /// <summary>
        /// 專輯建立時間
        /// </summary>
        public DateTime CreationTime { get; set; }
        /// <summary>
        /// 專輯刪除時間
        /// </summary>
        public DateTime? DeletionTime { get; set; }
        /// <summary>
        /// 專輯是否刪除
        /// </summary>
        public bool IsDeleted { get; set; }
        /// <summary>
        /// 專輯最後修改時間
        /// </summary>
        public DateTime? LastModificationTime { get; set; }
        /// <summary>
        /// 專輯建立人
        /// </summary>
        public long? CreatorUserId { get; set; }
    }

/// <summary>
    /// 專輯和文章對應關係
    /// </summary>
    public class NoteToNoteBook : Entity, IHasCreationTime, ICreationAudited
    {
        /// <summary>
        /// 文章的id
        /// </summary>
        public int NoteId { get; set; }
        /// <summary>
        /// 文章內容
        /// </summary>
        public Note Note { get; set; }
        /// <summary>
        /// 專輯id
        /// </summary>
        public int NoteBookId { get; set; }
        /// <summary>
        /// 專輯內容
        /// </summary>
        public NoteBook NoteBook { get; set; }
        /// <summary>
        /// 建立時間
        /// </summary>
        public DateTime CreationTime { get; set; }
        /// <summary>
        /// 建立人
        /// </summary>
        public long? CreatorUserId { get; set; }
    }

建立DbContext

提到DbContext,對於經常使用DbFirst模式的開發者來說已經再熟悉不過了，EntityFramework全靠這員大將。它的作用是代表與資料庫連線的會話，提供了查詢、狀態跟蹤、儲存等功能。
還有一個重要的物件是DbSet，對實體型別提供了集合操作，比如Add、Attach、Remove。繼承了DbQuery，所以可以提供查詢功能。
ABP框架為我們建立了一個DbContext模板，如下圖：

新增資料集如下：

public class MZCDbContext : AbpZeroDbContext<Tenant, Role, User, MZCDbContext>
    {
        /* Define an IDbSet for each entity of the application */

        public MZCDbContext(DbContextOptions<MZCDbContext> options)
            : base(options)
        {

        }
        public DbSet<Note> Notes { get; set; }
        public DbSet<NoteBook> NoteBooks { get; set; }
        public DbSet<NoteToNoteBook> NoteToNoteBooks { get; set; }

    }

建立資料庫遷移

現在我們通過建立的實體類和DbContext類利用EF的Code First資料庫遷移來建立資料庫。ABP模板預設開啟了遷移。
多的就不說了，執行add-migration notes 和 update-database命令如下：

檢視我們的資料庫表新增成功：

構建應用層服務

在DDD（領域驅動設計）設計中，倉儲實現了對資料進行特定操作的程式碼。ABP使用泛型IRepository介面為每一個實體建立了一個自動的倉儲。IRepository定義了select，insert，update和一些更多的通用方法：

ABP框架已經內建了這麼多常用的操作方法，當然，我們也可以根據自己的需求擴充套件這些倉儲。這裡我就直接用自動倉儲，不再建立倉儲。

新增如下檔案：

初步定義dto內容如下：

/// <summary>
    /// 建立的時候不需要太多資訊，內容更新主要依靠update
    /// 在使用者點選建立的時候資料庫便建立資料，在使用者編輯過程中自動更新儲存資料。
    /// </summary>
    public class CreateNoteDto
    {
        /// <summary>
        /// 建立時間
        /// </summary>
        public DateTime CreationTime { get; set; }
        /// <summary>
        /// 建立人
        /// </summary>
        public long CreatorUserId { get; set; }
        /// <summary>
        /// 內容的資料型別 markdown內容，html內容，或者其他
        /// </summary>
        public int TextType { get; set; }
    }
    /// <summary>
    /// 自動更新所傳的資料
    /// </summary>
    public class UpdateNoteDto : EntityDto<int>
    {
        /// <summary>
        /// 標題
        /// </summary>
        public string Title { get; set; }
        /// <summary>
        /// 內容
        /// </summary>
        public string Content { get; set; }
        /// <summary>
        /// 上次修改時間
        /// </summary>
        public DateTime? LastModificationTime { get; set; }
    }
    /// <summary>
    /// 釋出更新時所用
    /// </summary>
    public class PublicNoteDto: UpdateNoteDto
    {
        /// <summary>
        /// 簡單描述，用於微信推送時的描述或者其他
        /// </summary>
        public string Des { get; set; }
        /// <summary>
        /// 封面圖片，可用於微信推送時或者其他
        /// </summary>
        public string Img { get; set; }
        /// <summary>
        /// 關鍵字，可用於搜尋，分類等
        /// </summary>
        public string Tags { get; set; }
        /// <summary>
        /// 是否釋出
        /// </summary>
        public bool IsPublic { get; set; }
    }
    /// <summary>
    /// 用於列表展示
    /// </summary>
    public class NoteDto : EntityDto<int>
    {
        /// <summary>
        /// 標題
        /// </summary>
        public string Title { get; set; }
        /// <summary>
        /// 建立時間
        /// </summary>
        public DateTime CreationTime { get; set; }
        /// <summary>
        /// 點贊次數
        /// </summary>
        public long Like { get; set; }
        /// <summary>
        /// 收藏次數
        /// </summary>
        public long Collect { get; set; }
        /// <summary>
        /// 瀏覽次數
        /// </summary>
        public long Scan { get; set; }
        /// <summary>
        /// 是否釋出
        /// </summary>
        public string IsPublic { get; set; }
    }

初步定義介面如下：

public interface INoteAppServer: IAsyncCrudAppService<NoteDto,int, PagedResultRequestDto,CreateNoteDto,UpdateNoteDto>
    {
    }

IAsyncCrudAppService繼承了IApplicationService介面，後面會講到，繼承了這個介面的service會自動封裝成webapi。當然我們可以根據需要來選擇繼承或者不繼承apb提供的介面。其中也定義瞭如下介面函式：

        Task<TEntityDto> Create(TCreateInput input);
        Task Delete(TDeleteInput input);
        Task<TEntityDto> Get(TGetInput input);
        Task<PagedResultDto<TEntityDto>> GetAll(TGetAllInput input);
        Task<TEntityDto> Update(TUpdateInput input);

簡單實現介面

    public class NoteAppServer : AsyncCrudAppService<Note,NoteDto, int, PagedResultRequestDto, CreateNoteDto, UpdateNoteDto>, INoteAppServer
    {

        public NoteAppServer(IRepository<Note> repository)
            : base(repository)
        {

        }
    }

可以看出來，我們什麼不寫也可以，因為繼承了AsyncCrudAppService類，這裡就預設有以下實現。但是用起來怎麼樣，可以試試。

        [AsyncStateMachine(typeof(AsyncCrudAppService<,,,,,,,>.<Create>d__7))]
        public virtual Task<TEntityDto> Create(TCreateInput input);
        public virtual Task Delete(TDeleteInput input);
        [AsyncStateMachine(typeof(AsyncCrudAppService<,,,,,,,>.<Get>d__5))]
        public virtual Task<TEntityDto> Get(TGetInput input);
        [AsyncStateMachine(typeof(AsyncCrudAppService<,,,,,,,>.<GetAll>d__6))]
        public virtual Task<PagedResultDto<TEntityDto>> GetAll(TGetAllInput input);
        [AsyncStateMachine(typeof(AsyncCrudAppService<,,,,,,,>.<Update>d__8))]
        public virtual Task<TEntityDto> Update(TUpdateInput input);
        protected virtual Task<TEntity> GetEntityByIdAsync(TPrimaryKey id);