[Architect] ABP(现代ASP.NET样板开发框架) 翻译

所有翻译文档,将上传word文档至GitHub

本节目录:

简介
代码示例
支持的功能
GitHub

简介

ABP是“ASP.NET Boilerplate Project (ASP.NET样板项目)”的简称。

ABP不仅仅是1个框架，更提供了一个基于DDD和最佳实践方案

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

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

代码示例

(Application层代码示例)

public class TaskAppService : ApplicationService, ITaskAppService
{
    private readonly IRepository<Task> _taskRepository;
 
    public TaskAppService(IRepository<Task> taskRepository)
    {
        _taskRepository = taskRepository;
    }
 
    [AbpAuthorize(MyPermissions.UpdatingTasks)]
    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("CouldNotFoundTheTaskMessage"));
        }
 
        input.MapTo(task);
    }
}

支持的功能

Dependency Injection: 继承了application service的每个类, 都会注册到容器中 as transient (created per request). 并会自动注入所有依赖.
Repository: ABP 会创建1个 default repository for each entity. Default repository 有很多实用的方法. 我们也可以自定义repository的方法.
Authorization: ABP 会检查权限. 如果用户没有登录或者没有UpdatingTasks权限,在上面的例子中,则会自动阻止执行.通过添加特性标签实现权限.
Validation: ABP 会自动验证input参数是否为null.并根据(data annotation attributes and custom validation rules)对所有属性做验证.如果验证不通过,会抛出异常.
Audit Logging: User, browser, IP address, calling service, method, parameters等信息会自动记录下
Unit Of Work: 在ABP中, 每个application service 方法默认都会开启事务.在方法开始的时候,自动创建1个数据库连接和开启事务,方法没有异常的执行完会自动提交事务.
Exception Handling: 在ABP中,我们几乎不需要处理异常.ABP会自动记录,并通过合适的方法返回给客户端.
Logging: 可以通过Logger属性 write logs.Log4Net 是默认的日志框架,并且可配置替换成其他日志框架.
Localization: 当抛异常的时候,可以调用L方法,会自动使用本地化语言配置.
Auto Mapping: ABP定义1个MapTo扩展方法,使用AutoMapper方便我们做实体映射.
Dynamic Web API Layer: 通过配置,ABP会在运行的时候,自动将application service methods 生成Web API.
Dynamic Javascript AJAX Proxy: ABP自动创建javascript proxy methods可以直接调用application service methods.
Modularity: 提供了完善的基础设施层来生成可复用的模块.
Data Filters: 提供自动过滤,如软删除,多租户.
Multi Tenancy: 提供单数据库多用户方式的多租户.
Setting Management: 提供了完善的基础设施层来获取更改 application, tenant and user level 设置信息.
Unit & Integration Testing: 提供了基类简化单元和集成测试.
...