上一篇 我们介绍了什么是ABP,这一篇我们通过原作者的”简单任务系统”例子,演示如何运用ABP开发项目
创建实体
一般来说任务是需要分配给人来做的,所以我们创建两个实体模型类:Task和Persion
using Abp.Domain.Entities;
using Abp.Domain.Entities.Auditing;
using System.ComponentModel.DataAnnotations.Schema;
using System;
namespace SimpleTaskSystem
{
public class Task : Entity, IHasCreationTime
{
[ForeignKey("AssignedPersonId")]
public Person AssignedPerson { get; set; }
public long? AssignedPersonId { get; set; }
public string Description { get; set; }
public TaskState State { get; set; }
public DateTime CreationTime { get; set; }
public Task()
{
State = TaskState.Active;
}
}
}
using System;
using Abp.Domain.Entities;
using Abp.Domain.Entities.Auditing;
namespace SimpleTaskSystem
{
public class Person : Entity, IHasCreationTime
{
public string Name { get; set; }
public DateTime CreationTime { get; set; }
}
}
创建DbContext
使用EntityFramework需要先定义DbContext类,ABP的模板已经创建了DbContext文件,我们只需要把Task和Person类添加到IDbSet
using Abp.EntityFramework;
using System.Data.Entity;
namespace SimpleTaskSystem.EntityFramework
{
public class SimpleTaskSystemDbContext : AbpDbContext
{
//TODO: Define an IDbSet for each Entity...
//Example:
//public virtual IDbSet Users { get; set; }
public virtual IDbSet Tasks { get; set; }
public virtual IDbSet People { get; set; }
/* NOTE:
* Setting "Default" to base class helps us when working migration commands on Package Manager Console.
* But it may cause problems when working Migrate.exe of EF. If you will apply migrations on command line, do not
* pass connection string name to base classes. ABP works either way.
*/
public SimpleTaskSystemDbContext()
: base("Default")
{
}
/* NOTE:
* This constructor is used by ABP to pass connection string defined in SimpleTaskSystemDataModule.PreInitialize.
* Notice that, actually you will not directly create an instance of SimpleTaskSystemDbContext since ABP automatically handles it.
*/
public SimpleTaskSystemDbContext(string nameOrConnectionString)
: base(nameOrConnectionString)
{
}
}
}
通过Database Migrations创建数据库
我们使用EntityFramework的Code First模式创建数据库架构。ABP模板生成的项目已经默认开启了数据迁移功能,我们添加一些默认数据进去。
using System.Data.Entity.Migrations;
namespace SimpleTaskSystem.Migrations
{
internal sealed class Configuration : DbMigrationsConfiguration
{
public Configuration()
{
AutomaticMigrationsEnabled = false;
ContextKey = "SimpleTaskSystem";
}
protected override void Seed(SimpleTaskSystem.EntityFramework.SimpleTaskSystemDbContext context)
{
// This method will be called every time after migrating to the latest version.
// You can add any seed data here...
context.People.AddOrUpdate(
p => p.Name,
new Person { Name = "张三" },
new Person { Name = "王二" },
new Person { Name = "李四" },
new Person { Name = "老王" }
);
}
}
}
然后打开 程序包管理器控制台 ,选择默认项目并执行命令”Add-Migration InitialCreate”,此时会在Migrations目录下生成一个以 当前时间_InitialCreate.cs 的文件。
然后继续在 程序包管理器控制台 执行 Update-Database,等执行完毕则会在数据库自动创建相应的数据表
定义仓储接口
通过仓储模式,可以更好把业务代码与数据库操作代码更好的分离。我们把仓储的代码写到 Core 项目中
using Abp.Domain.Repositories;
using System.Collections.Generic;
namespace SimpleTaskSystem.Repositorys
{
public interface ITaskRepository : IRepository<Task, long>
{
List GetAllWithPeople(long? assignedPersonId, TaskState? state);
}
}
我们可以为Persion类定义一个仓储,也可以不定义,这里我选择定义,虽然ABP默认提供的仓储在本例中已经够用了,但考虑到以后扩展方便,我们还是也给它定义一个。
using Abp.Domain.Repositories;
namespace SimpleTaskSystem.Repositorys
{
public interface IPersionRepository : IRepository<Person, long>
{
}
}
这样后期我们要加一个自定义方法直接加在这里面就行了,不用改动太多。这里也介绍一下ABP自带的仓储方法,我们可以直接使用。
实现仓储类
因为本例用的是EntityFramework,所以我们将在EntityFramework项目中实现上面定义的ITaskRepository仓储接口。如果后期想换个ORM框架,比如NHibernate,我们就只要更换仓储实现的这个项目即可。
TaskRepository.cs
using System.Collections.Generic;
using Abp.EntityFramework;
using SimpleTaskSystem.EntityFramework.Repositories;
using SimpleTaskSystem.Repositorys;
using System.Linq;
using System.Data.Entity;
namespace SimpleTaskSystem.EntityFramework.Repositorys
{
public class TaskRepository : SimpleTaskSystemRepositoryBase<Task, long>, ITaskRepository
{
public TaskRepository(IDbContextProvider dbContextProvider) : base(dbContextProvider)
{
}
public List GetAllWithPeople(long? assignedPersonId, TaskState? state)
{
//在仓储方法中,不用处理数据库连接、DbContext和数据事务,ABP框架会自动处理。
var query = GetAll(); //返回一个 IQueryable接口类型
//添加一些Where条件
if (assignedPersonId.HasValue)
{
query = query.Where(task => task.AssignedPerson.Id == assignedPersonId.Value);
}
if (state.HasValue)
{
query = query.Where(task => task.State == state);
}
return query
.OrderByDescending(task => task.CreationTime)
.Include(task => task.AssignedPerson)
.ToList();
}
}
}
PersionRepository.cs
using SimpleTaskSystem.Repositorys;
using Abp.EntityFramework;
namespace SimpleTaskSystem.EntityFramework.Repositories
{
public class PersionRepository : SimpleTaskSystemRepositoryBase<Person, long>, IPersionRepository
{
public PersionRepository(IDbContextProvider dbContextProvider) : base(dbContextProvider)
{
}
}
}
创建服务(Services)
首先在Application项目中定义Task的应用服务层的接口,各dto的类请下载源码查看。
ITaskAppService.cs
using Abp.Application.Services;
namespace SimpleTaskSystem.Services
{
public interface ITaskAppService : IApplicationService
{
GetTasksOutput GetTasks(GetTasksInput input);
void UpdateTask(UpdateTaskInput input);
void CreateTask(CreateTaskInput input);
}
}
然后,我们写TaskAppService类来实现ITaskAppService接口
TaskAppService.cs
using Abp.Application.Services;
using AutoMapper;
using SimpleTaskSystem.Repositorys;
using System.Collections.Generic;
namespace SimpleTaskSystem.Services
{
public class TaskAppService : ApplicationService, ITaskAppService
{
private readonly ITaskRepository _taskRepository;
private readonly IPersionRepository _personRepository;
///
/// 构造函数自动注入我们所需要的类或接口
///
public TaskAppService(ITaskRepository taskRepository, IPersionRepository personRepository)
{
_taskRepository = taskRepository;
_personRepository = personRepository;
}
public void CreateTask(CreateTaskInput input)
{
Logger.Info("Creating a task for input: " + input);
//通过输入参数,创建一个新的Task实体
var task = new Task { Description = input.Description };
if (input.AssignedPersonId.HasValue)
{
task.AssignedPersonId = input.AssignedPersonId.Value;
}
//调用仓储基类的Insert方法把实体保存到数据库中
_taskRepository.Insert(task);
}
public GetTasksOutput GetTasks(GetTasksInput input)
{
//调用Task仓储的特定方法GetAllWithPeople
var tasks = _taskRepository.GetAllWithPeople(input.AssignedPersonId, input.State);
//用AutoMapper自动将List转换成List
return new GetTasksOutput
{
Tasks = Mapper.Map<list>(tasks)
};
}
public void UpdateTask(UpdateTaskInput input)
{
//可以直接Logger,它在ApplicationService基类中定义的
Logger.Info("Updating a task for input: " + input);
//通过仓储基类的通用方法Get,获取指定Id的Task实体对象
var task = _taskRepository.Get(input.Id);
//修改task实体的属性值
if (input.State.HasValue)
{
task.State = input.State.Value;
}
if (input.AssignedPersonId.HasValue)
{
task.AssignedPerson = _personRepository.Load(input.AssignedPersonId.Value);
}
//我们都不需要调用Update方法
//因为应用服务层的方法默认开启了工作单元模式(Unit of Work)
//ABP框架会工作单元完成时自动保存对实体的所有更改,除非有异常抛出。有异常时会自动回滚,因为工作单元默认开启数据库事务。
}
}
}
数据验证
如果应用服务(Application Service)方法的参数对象实现了IInputDto或IValidate接口,ABP会自动进行参数有效性验证。
CreateTaskInput.cs
using Abp.Application.Services.Dto;
using System.ComponentModel.DataAnnotations;
namespace SimpleTaskSystem.Services
{
public class CreateTaskInput : IInputDto
{
[Required]
public string Description { get; set; }
public long? AssignedPersonId { get; set; }
}
}
如果你想使用自定义验证,你可以实现ICustomValidate 接口
UpdateTaskInput.cs
using System.Collections.Generic;
using System.ComponentModel.DataAnnotations;
using Abp.Application.Services.Dto;
using Abp.Runtime.Validation;
namespace SimpleTaskSystem.Services
{
public class UpdateTaskInput : IInputDto, ICustomValidate
{
public int Id { get; set; }
public string Description { get; set; }
public long? AssignedPersonId { get; set; }
public TaskState? State { get; set; }
public void AddValidationErrors(List results)
{
if (AssignedPersonId == null && State == null)
{
results.Add(new ValidationResult("AssignedPersonId和State不能同时为空!", new[] { "AssignedPersonId", "State" }));
}
}
}
}
创建Web Api服务
ABP默认已经开户了动态API,我们不需要任何设置即可非常轻松地把Application Service的public方法发布成Web Api接口,可以供客户端通过ajax调用。
下一篇我们将在此基础上构建前台页面,实现在浏览器中对任务进行简单的增删改查,静请期待……
本节源码链接: http://pan.baidu.com/s/1jIvZPSM 密码: njk5