什么是ABP框架?
ABP框架(以下简称ABP)是一个开源的、有良好文档记录的应用程序框架。它不仅仅是一个框架,它还提供了基于领域驱动设计的强大架构模型,并考虑了所有最佳实践。ABP框架基于 Core和EF Core,同事支持ASP.MVC 5.x 和EF 6.x。
一个简单的示例
让我们研究一个简单的类,看看ABP的好处:
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); }}
这里我们看到了一个样例应用程序服务方法。DDD中的应用程序服务直接被表示层用于执行应用程序的用例。把UpdateTask看作是通过AJAX调用的JavaScript方法。
让我们来看看ABP的一些好处吧:
- 依赖注入:ABP使用并提供一个常规的DI基础结构。由于该类是一个应用程序服务,所以它通常是作为临时的(每个请求创建)的DI容器注册的。它可以简单地注入任何依赖项(例如本例中的IRepository任务)。
- 资源库:ABP可以为每个实体创建一个默认的存储库(例如本例中的IRepository任务)。默认存储库有许多有用的方法,例如本例中使用的FirstOrDefault方法。我们可以扩展默认存储库以满足我们的需要。存储库抽象了DBMS和orm,并简化了数据访问逻辑。
- 授权:ABP可以声明地检查权限。如果当前用户没有“更新任务”权限,或者没有登录,那么它将阻止访问UpdateTask方法。ABP不仅使用声明性的属性,而且它还有其他的方式可以授权。
- 验证:ABP自动检查输入是否为空。它还基于标准的数据注释属性和定制验证规则验证输入的所有属性。如果一个请求无效,它会抛出一个正确的验证异常并在客户端处理它。
- 审计日志记录:用户、浏览器、IP地址、调用服务、方法、参数、调用时间、执行时间和其他一些信息,根据约定和配置自动保存每个请求。
- 工作单元:在ABP中,每一个应用程序服务方法默认是一个工作单元。它会自动创建一个连接,并在方法开始时启动一个事务。如果该方法成功完成,没有异常,那么事务就提交了,连接被处理了。即使这个方法使用不同的存储库或方法,它们都将是原子性的(事务性的)。当事务提交时,实体的所有更改都会自动保存。我们甚至不需要像上面所示的那样调用复位.update(task)方法。
- 异常处理:我们几乎不需要在web应用程序中手动处理ABP中的异常。默认情况下,所有异常都是自动处理的!如果发生异常,ABP会自动记录并返回一个适当的结果给客户端。例如,如果这是一个AJAX请求,它会向客户端返回一个JSON对象,表明发生了错误。它隐藏了来自客户端的实际异常,除非异常是一个UserFriendlyException,正如本例中所使用的。它还能理解和处理客户端的错误,并向用户显示适当的消息。
- 日志:正如您所看到的,我们可以使用基类中定义的记录器对象来编写日志。Log4Net是默认使用的,但它是可更改的且可配置的
- 本地化:注意,我们在抛出异常时使用了'L'方法?通过这种方式,它会根据当前用户的文化自动进行本地化。更多地查看本地化文档。
- 自动映射:在最后一行中,我们使用了ABP的mapextension方法来将输入属性映射到实体属性。它使用AutoMapper库来执行映射。基于命名约定,我们可以很容易地将属性映射到另一个对象。
- 动态API层:TaskAppService是一个简单的类。我们通常需要编写一个包装器API控制器来将方法暴露给JavaScript客户端,但是ABP在运行时自动执行这个操作。通过这种方式,我们可以直接从客户端使用应用程序服务方法。
- 动态的Javascript AJAX代理:ABP创建代理方法,这些方法使得调用应用程序服务方法非常简单,就像在客户端调用Javascript方法一样简单。
我们可以在这个简单的类中看到ABP的好处。所有这些任务通常都需要花费大量的时间,但是由框架自动处理。除了这个简单的例子外,ABP还为模块化、多租户、缓存、后台作业、数据过滤器、设置管理、领域事件、单元和集成测试等提供了强大的基础架构和开发模型。你专注于你的业务代码,不要重复你自己!