ABP 基础设施层——集成 Entity Framework
本文翻译自ABP的官方教程《EntityFramework Integration》，地址为：http://aspnetboilerplate.com/Pages/Documents/EntityFramework-Integration
ABP 可以与任何 ORM 框架协同工作，它内置了对 EntityFramework 的集成支持。本文将介绍如何在 ABP 中使用 EntityFramework。本文假定你已经初步掌握了EntityFramework。
译者注：怎么才算初步掌握了 EntityFramework 呢？译者认为应当懂得使用 Code First 模式进行CRUD。
1 Nuget 包
要在 ABP 中使用 EntityFramework 作为 ORM 框架的话，需要到 Nuget 上下载一个名为 Abp.EntityFramework的包。比较好的做法是：新建一个独立的程序集 (dll)，然后在这个程序集中调用这个包和 EntityFramework。
2 创建 DbContext(Creating DbContext)
要使用 EntityFramework，首先需要定义一个 DbContext 类。下面是一个DbContex 类的示例：
public class SimpleTaskSystemDbContext : AbpDbContext
{
public virtual IDbSet<Person> People { get; set; } public virtual IDbSet<Task> Tasks { get; set; }
public SimpleTaskSystemDbContext()
: base("MyConnectionStringName")
{ } protected override void OnModelCreating(DbModelBuilder modelBuilder)
{
base.OnModelCreating(modelBuilder);
modelBuilder.Entity<Person>().ToTable("StsPeople");
modelBuilder.Entity<Task>().ToTable("StsTasks").HasOptional(t=> t.AssignedPerson);
} }
上面的 SimpleTaskSystemDbContext 本质上是一个 DbContext 类，它派生自 AbpDbContext，而不是 DbContext。AbpDbContext 提供了很多重载的构造函数，如果需要的话，我们可以使用它。EntityFramework 可以使用约定的方式来映射实体和数据表。除非你想进行自定义映射，否则你甚至不需要做任何配置。在上例中，我们将实体映射到了不同的表中。默认情况下（按照约定优先于配置的原则，会默认采用约定的方式），Task 实体会映射到 Tasks 表，但在这里我们将它映射到了 StsTasks 表。相比起使用 Data Annotation 模式来进行自定义映射，我更喜欢使用 Fluent API 模式。当然，你可以选择你所喜欢的模式，这里没有特别的限制。
3 仓储(Repositories)
ABP 提供了一个名为 EfRepositoryBase 的基类，这使得实现仓储变得简单快捷。要实现 IRepository 接口，你只需要从这个基类进行派生即可。但是更好的做法是，自定义一个派生自 EfRepositoryBase 的基类，然后在这个基类中添加一些通用的方法。这样做的好处是，所有派生自这个基类的仓储都继承了这些通用方法。
（1）应用程序专用的仓储基类(Application specific base repository class)
在下面的例子中，我们定义了一个名为 SimpleTaskSystem 仓储基类，这个类是此应用程序所专用的。
// 应用程序中的所有仓储的基类
public class SimpleTaskSystemRepositoryBase<TEntity, TPrimaryKey> : EfRepositoryBase<SimpleTaskSystemDbContext, TEntity, TPrimaryKey>
where TEntity : class, IEntity<TPrimaryKey>
{
public SimpleTaskSystemRepositoryBase(IDbContextProvider<SimpleTaskSyst emDbContext> dbContextProvider)
: base(dbContextProvider)
{ } //添加仓储基类的通用方法 } public class SimpleTaskSystemRepositoryBase<TEntity> : SimpleTaskSystemRepositoryBase<TEntity, int>
where TEntity : class, IEntity<int>
{
public SimpleTaskSystemRepositoryBase(IDbContextProvider<SimpleTaskSyst emDbContext> dbContextProvider)
: base(dbContextProvider)
{ } // 不 要 在 这 里 添 加 任 何 通 用 方 法 ，通 用 方 法 应 当 被添加到 上 面 的 基 类 中（MyRepositoryBase<TEntity, TPrimaryKey>） }
需 要 注 意 的 是 ， 我 们 继 承 了 基 类EfRepositoryBase<SimpleTaskSystemDbContext, TEntity, TPrimaryKey>。这相当于做了一个声明，它会让 ABP 在仓储中调用 SimpleTaskSystemDbContext。
（2）仓储实现（Implementing a repository）
如果你只想使用预定义的仓储方法的话，你甚至不需要为实体创建仓储类。如下所示：
public class PersonAppService : IPersonAppService
{
private readonly IRepository<Person> _personRepository; public PersonAppService(IRepository<Person> personRepository)
{
_personRepository = personRepository;
} public void CreatePerson(CreatePersonInput input)
{
person = new Person { Name = input.Name, EmailAddress = input.EmailAddress };
_personRepository.Insert(person);
}
}
PersonAppService类采用构造函数注入的方式注入了一个IRepository<Person>对象，然后调用了预定义的 Insert 方法。采用这种方式，你可以方便地注入IRepository<TEntity> （或者 IRepository<TEntity, TPrimaryKey>）对象，然后使用预定义的方法。查看仓储文档以获得预定义方法的列表。
（3）自定义仓储(Custom repositories)
要实现自定义仓储，只要从上面所创建的应用程序专用的仓储基类（SimpleTaskSystemRepositoryBase）派生即可。
假定我们有一个名为 Task 的实体，它可以被赋予 Person 实体。Task 有一个状态属性（值为新建、已分配、已完成等）。我们需要编写一个自定义方法，这个方法能根据某些条件获取 Task 列表，并且使得 Task 的 AssisgnedPerson 属性可以在一次数据库查询中被加载（使用 EntityFramework 的贪婪加载方法 Include）。如下所示：
public interface ITaskRepository : IRepository<Task, long>
{
List<Task> GetAllWithPeople(int? assignedPersonId, TaskState? state);
} public class TaskRepository : SimpleTaskSystemRepositoryBase<Task, long>, ITaskRepository
{
public TaskRepository(IDbContextProvider<SimpleTaskSystemDbContext> dbContextProvider)
: base(dbContextProvider)
{
} public List<Task> GetAllWithPeople(int? assignedPersonId, TaskState? state)
{
var query = GetAll();
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();
}
}
我们首先定义了一个名为 ITaskRepository 的接口，紧接着定义了一个名为 TaskRepository 的类来实现它。预定义方法 GetAll()返回了一个 IQueryable<Task> 对象，接着我们将参数放入到 Where 筛选器中，最后调用 ToList()来获得一个 Task 列表。此外，我们可以通过调用 base.Context 属性来获得一个 DbContext 对象，这样一来，你就可以直接使用 Entity Framework 的所有功能。
仓储类应当在构造函数中获取IDbContextProvider对象。通过这种方式，在单元测试的时候，我们可以很容易地注入一个虚拟的 DbContext Provider 对象；而在运行的时候，ABP 会根据配置注入相应的 DbContext Provider 对象。