ABP使用及框架解析系列 - [Unit of Work part.1-概念及使用]
前言
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(); 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-框架实现]
最新文章
- Andriod学习笔记4:mac下搭建 Eclipse+CDT 集成开发环境
- xamarin学习之页面布局
- linux中不小心将rpm命令卸载了,怎么恢复?
- js定时相关函数:
- jquery fadeOut 异步
- linux下安装配置DHCP服务器
- Lua包管理工具Luarocks详解 - 15134559390的个人空间 - 开源中国社区
- bzoj 1560 [JSOI2009]火星藏宝图(DP)
- Asp.Net Web API 导航3
- js移动端tap事件封装
- 【HighCharts系列教程】一、认识Highcharts
- nginx负载均衡(一)
- WinForm下的loading框的实现
- c++ stod很慢
- mysql存储引擎的优缺点
- Linux 系统最大TCP连接数 调优
- (笔记)Linux内核学习(三)之进程调度
- mui框架(一)
- Linux 系统安全检查(shell)
- mysql之SQLYog配置
热门文章
- oracle 备份数据库对象(存储过程PROCEDURE,FUNCTION,VIEW,TRIGGER...)
- iOS 真机调试不能连接网络的排错过程
- webpack的安装和使用
- lua中的string类型
- A Simple OpenGL Shader Example
- Android搜索框效果
- 应用程序框架实战三十三:表现层及ASP.NET MVC介绍(二)
- MVC, MVP, MVVM比较以及区别(下)
- 项目中遇到的Integer问题--转
- iOS 使用EZAudio库生成wav出错的情况