如何创建.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