1.介绍
ABP是开源的且文档比较齐全的应用程序框架。其实它不仅仅是个框架,考虑其最佳实践,ABP更提供了基于领域驱动设计(DDD)的强大价格模型。
ABP支持最新的ASP.NET Core和EF Core,同时也支持ASP.NET MVC 5.x和EF 6.x.
2.快速看一个示例
public class TaskAppService : ApplicationService, ITaskAppService { private readonly IRepository_taskRepository; public TaskAppService(IRepository taskRepository) { _taskRepository = taskRepository; } [AbpAuthorize(MyPermissions.UpdateTasks)] public async Task UpdateTask(UpdateTaskInput input) { Logger.Info("Updating a task for input: " + input); var task = await _taskRepository.FirstOrDefaultAsync(input.TaskId); if (task == null) { throw new UserFriendlyException(L("CouldNotFindTheTaskMessage")); } input.MapTo(task); } }
上面是一个Application Service 方法示例,DDD中方的Application Service直接由表示层调用来执行应用程序的用例。
将UpdateTask看成是JavaScript通过AJAX调用的方法。
3.ABP的优势
依赖注入(DI):ABP提供了传统的DI基础设施,由于此类是应用程序服务,因此它通常在DI容器中注册为瞬态(根据请求创建). 它可以简单地注入任何依赖项(例如此示例中的IRepository
仓储:ABP可以为每个实体创建一个默认存储库(例如本例中的IRepository
授权:ABP可以声明性的检查权限,如果当前用户没有“update tasks”权限或者未登录,ABP会阻止访问UpdateTask方法。ABP不仅使用声明性属性,而且还有其他一些授权方法。
验证:ABP会自动检查输入是否为Null,它还基于标准数据注释属性和自定义验证规则验证输入的所有属性。如果请求无效,则会抛出异常并在客户端进行处理。
审计日志:根据约定和配置,为每个请求自动保存用户,浏览器,IP地址,调用服务,方法,参数,调用时间,执行时长以及其他一些信息。
工作单元:在ABP,每个应用程序服务方法默认都被假设成一个工作单元。它自动的在方法开始时创建一个连接并开始一个事务。如果这个方法没有任何异常的完成,事务会被提交并且释放连接。尽管这个方法用了不同的仓储或者方法,他们都将是原子的(事务的)。当一个事务被提交的时候,对实体的所有修改将会自动被保存。我们甚至不需要调用_repository.Update(task),如上例所示。
异常处理:在一个ABP的web应用程序中,我们几乎从来不用手动去处理异常.默认情况下所有的异常都会被自动处理!如果一个异常发生,ABP会自动记录并向客户端返回正确的结果。比如,如果这是一个AJAX请求,它返回一个JSON对象到客户端标识一个错误的发生。只有在UserFriendlyException情况下,它会隐藏真实的异常。它还可以处理客户端上的错误,并向用户展示相应的信息。
日志:我们可以使用在基类中定义的Logger对象。默认使用Log4Net,但是这个是可更改可配置的。
本地化:注意我们在抛出异常时使用了'L'方法? 这样,它会根据当前用户的文化自动进行本地化。
自动映射:在最后一行中,我们使用ABP的MapTo扩展方法将输入属性映射到实体属性。 它使用AutoMapper库来执行映射。 我们可以根据命名约定轻松地将属性从一个对象映射到另一个对象。
动态的API:TaskAppService是一个简单的类。 通常我们必须编写一个包装器API控制器来向JavaScript客户端公开方法,但ABP会在运行时自动执行该操作。 这样,我们可以直接从客户端使用应用程序服务方法。
动态AJAX代理:ABP创建代理方法,这些方法使调用应用程序服务方法就像在客户端上调用JavaScript方法一样简单。
我们可以在这个简单的类中看到ABP的好处。 所有这些任务通常需要花费很长时间,但在ABP中,框架都帮我们做了。我们只需要关注自己真正的业务。