上一篇 我们介绍了什么是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