ABP使用及框架解析系列

前言

ABP

ABP是“ASP.NET Boilerplate Project”的简称。

ABP的官方网站：http://www.aspnetboilerplate.com

ABP在Github上的开源项目：https://github.com/aspnetboilerplate

ABP其他学习博客推荐及介绍：http://www.cnblogs.com/mienreal/p/4528470.html

Unit of Work

Unit of Work 又称之为“工作单元”，Unit of Work的相关概念及介绍，请移步另一篇博客：设计模式/原则篇 - Unit of Work。

在ABP中，因为不能确定开发人员实际使用的ORM和数据访问层具体是什么，为了更好的扩展性，ABP为Unit of Work封装了一套通用接口抽象，并提供了Entity Framework及NHibernate的实现。

使用

默认行为

在ABP中，ApplicationService（领域服务，实现IApplicationService接口的类）和Repository（实现IRepository接口的类）的每个方法默认都是一个工作单元。在方法的起始处就开始了一个事务，在方法的结束时，事务也会自动提交，如果这个方法中抛出了异常，事务会自动回滚。

public interface ISimpleAppService : IApplicationService
{
    void ComplexOperation();
}

public class SimpleAppService : ISimpleAppService
{
    public void ComplexOperation()
    {
        //该方法默认就是一个工作单元
    }
}


public interface ISimpleRepository : IRepository<Simple, string>
{
    List<Simple> GetAllByName(string name);
}

public class SimpleRepository : ABPRepositoryBase<Simple, long>, ISimpleRepository
{
    public List<Simple> GetAllByName(string name)
    {
        //该方法默认就是一个工作单元，ABPRepositoryBase默认有一些公共方法的实现，比如GetAll、Update这些
    }
}

UnitOfWorkAttribute

另一种添加Unit of Work的方式，便是在方法上面添加UnitOfWork特性，这样便和上面的默认行为相同，该方法成为一个工作单元。

UnitOfWork特性，还包含一系列参数，Scope（事务参数）、IsTransactional（工作单元是否是事务）、Timeout（超时时间）、IsolationLevel（事务隔离级别）、IsDisabled（是否禁用工作单元，这个属性用于关闭领域服务和仓储库默认的方法即工作单元的设置）。

public class TempService
{
    [UnitOfWork]
    public void Method()
    {
        //TempService不是领域服务，没有实现IApplicationService接口，但是通过UnitOfWorkAttribute，使Method也成为一个工作单元
    }
}

重要

标记UnitOfWork特性的方法的所在类，需要注册到IoC容器中，并通过IoC容器进行创建，类和方法的可访问级别需要为public或protected，因为ABP通过动态代理实现AOP进行切面编程，具体缘由将在ABP使用及框架解析系列 - [Unit of Work part.2-框架实现]中解析。

IUnitOfWorkManager

上面两种方式，其内部都是使用IUnitOfWorkManager进行单元控制的，所以我们也可以直接通过IUnitOfWorkManager进行控制，如下代码所示：

public class TempService
{
    private IUnitOfWorkManager _uowManager;
    private ITempRepository _tempRsy;

    public TempService(IUnitOfWorkManager uowManager, ITempRepository tempRsy)
    {
        this._uowManager = uowManager;
        this._tempRsy = tempRsy;
    }

    public void Method()
    {
        using (var uow = _uowManager.Begin())
        {
            _tempRsy.Insert(new Temp());
            _tempRsy.Delete(1);

            uow.Complete();
        }
    }
}

TempService并非领域服务，没有实现IApplicationService接口，所以Method方法默认不是一个工作单元。在Method内部，使用using块便是一个工作单元，通过uow.Complete()进行提交，如果出现异常，会自动回滚。

IUnitOfWorkManager的Begin方法可接受一系列参数对工作单元或事务进行设置，在这里就不对每个参数进行详细说明了。如有疑问，大家都已在评论中进行讨论。

上述三种方式为Unit of Work在ABP中的使用方式，下面还有一些ABP中Unit of Work的特性、配置及注意事项。

全局/默认配置

不论是在使用Attribute还是IUnitOfWorkManager，都是可以进行一些参数设置的，但是同时也是可以不对其进行设置的，当不对其进行设置时，将会使用默认参数，而这个默认参数，可以通过一个全局配置进行修改。

ABP有一个IUnitOfWorkDefaultOptions接口，并且通过IoC与UnitOfWorkDefaultOptions进行了单例依赖注册，所以通过IoC容器获取IUnitOfWorkDefaultOptions实例时，可以获取到Unit of Work全局默认配置，通过修改这个对象里的参数，可以修改其默认配置。但是需要注意的是，这个配置是一个全局配置，所以随便在一个地方就进行修改不是一个好的做法。

ABP中有一个模块（AbpModule）的概念，推荐在主项目的模块类的PreInitialize方法中进行修改。ABP也为此提供了更加便捷的方式进行修改默认配置，AbpModule类下有一个Configuration属性，该属对象齐聚了很多配置项，其中UnitOfWork属性便是IUnitOfWorkDefaultOptions接口对象，通过这个便可方便的修改默认配置了。

其他特性

1.支持多个工作单元嵌套，它们共用最外层的工作单元。但如果嵌套的工作单元在不同主线程上，则每个主线程会有一个不同的工作单元，具体实现将在ABP使用及框架解析系列 - [Unit of Work part.2-框架实现]中解析。

2.在工作单元中，进行数据查询，如有返回IQueryable，需要再工作单元内进行ToList或ToArray等操作，因为返回IQueryable对象时并没有进行真正的数据操作（延迟执行），而数据库连接会在工作单元结束后关闭，所以如果再工作单元结束后进行ToList等操作，会抛出异常（当然，这里说的是ABP提供的NH和Ef的实现，自己实现ABP接口可以自行限制）。

3.Unit of Work除了提供了Complete外，还提供了SaveChanges方法，用于先行提交数据。在Entity主键为自增ID，并且后续操作需要这个ID时，可以通过先SaveChanges来提交数据来获取自增ID值。

4.在使用ABP提供的EF实现中，在工作单元中对Entity进行修改后，即使不手动调用Update，在UoW结束时也会自动保存修改，因为Ef对Entity的状态进行了跟踪，并且在UoW进行Complete操作前，会先SaveChanges（NH没有仔细研究）。

5.可以为Unit of Work注册三个事件：Completed、Failed、Disposed。这三个事件，在IUnitOfWorkManager对象的Current属性定义。

框架实现

由于框架实现内容较多，为了不导致篇幅过长，框架实现部分，请移步 ABP使用及框架解析系列 - [Unit of Work part.2-框架实现]