如何創建.net core ABP和Angular模板可以參考我的這篇文章:http://blog.csdn.net/yiershan1314/article/details/78219322
創建實體
如下所示項目下創建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);
這僅僅只是開始,更多的還在後面。
關於AsyncCrudAppService更多屬性和方法可以參考官方api:
https://aspnetboilerplate.com/api-docs/html/T_Abp_Application_Services_AsyncCrudAppService_6.htm