ABPvNext教程詳解

一、什麼是ABPvNext？

ABPvNext（ASP.NET Boilerplate）是一個ASP.NET Core 應用程序的開發框架，它以最佳實踐為基礎，旨在提高應用程序的生產力和質量。

ABPvNext不僅僅是一個框架，它同時也是一套完整的應用程序開發解決方案。它提供了許多可供使用的功能，如多租戶和多語言支持、身份驗證和授權、實體框架、自動化測試等。

二、ABPvNext的核心功能

ABPvNext提供了許多核心功能，包括實體框架、MVC框架、身份驗證和授權等等。

1.實體框架

ABPvNext的實體框架提供了一個強大和靈活的對象關係映射（ORM）和實體框架。您可以使用ABPvNext動態創建實體、修改實體、查詢實體和刪除實體。它還允許您使用以下技術訪問數據: Dapper、Entity Framework Core和NHibernate。

以下是使用ABPvNext實體框架的示例代碼：

public interface IBookRepository : IRepository<Book, Guid>
{
    Task<List<Book>> GetBooksAsync(string name);
}

2.MVC框架

ABPvNext的MVC框架提供了一組用於構建Web應用程序的基礎設施。它使用標準的ASP.NET Core MVC技術來構建Web應用程序，並具有可定製的路由、參數驗證和錯誤處理等功能。

以下是使用ABPvNext MVC框架的示例代碼：

[HttpPost]
public async Task<ActionResult> Create([FromBody] CreateBookInput input)
{
    var book = ObjectMapper.Map<Book>(input);
    await _bookManager.CreateAsync(book);
    return CreatedAtAction("Get", new { id = book.Id }, book);
}

3.身份驗證和授權

ABPvNext提供了強大的身份驗證和授權功能，支持多種身份驗證機制，如用戶名/密碼、OAuth、OpenId Connect、LDAP、Windows身份驗證和Cognito身份提供程序等。它還提供了一組用於授權的API，以及支持更細粒度授權的自定義策略和聲明。

以下是使用ABPvNext身份驗證和授權功能的示例代碼：

[Authorize]
public async Task<ActionResult> Update(Guid id, [FromBody] UpdateBookInput input)
{
    var book = await _bookManager.GetAsync(id);
    if (book == null)
    {
        return NotFound();
    }

    ObjectMapper.Map(input, book);
    await _bookManager.UpdateAsync(book);
    return NoContent();
}

三、ABPvNext的應用程序模塊化

ABPvNext支持應用程序的模塊化。每個模塊都是一個可插入應用程序的組件。每個模塊都有自己的Web界面（或API接口）和實現業務邏輯的服務層。在ABPvNext中，模塊是通過NuGet包進行分發。

以下是使用ABPvNext模塊化的示例代碼：

[DependsOn(typeof(AbpSettingManagementHttpApiModule))]
public class MyModule : AbpModule
{
    public override void ConfigureServices(ServiceConfigurationContext context)
    {
        Configure<AbpDbContextOptions>(options =>
        {
            options.UseSqlServer();
        });
    }
 
    public override void OnApplicationInitialization(ApplicationInitializationContext context)
    {
        var app = context.GetApplicationBuilder();
        app.UseHttpsRedirection();
        app.UseRouting();
        app.UseAuthentication();
        app.UseAuthorization();
        app.UseEndpoints(endpoints =>
        {
            endpoints.MapControllers();
        });
    }
}

四、ABPvNext的多租戶支持

ABPvNext的多租戶支持使您能夠為多個客戶提供託管服務。它允許為每個租戶提供獨立的數據庫，甚至可以使用不同的身份驗證和授權提供程序。

以下是使用ABPvNext多租戶支持的示例代碼：

public class MyTenant : AbpTenant<Guid>
{
    public MyTenant(Guid id, string name) 
        : base(id, name)
    {
    }
 
    public string ConnectionString { get; set; }
}
 
public class MyTenantResolveContributor : TenantResolveContributorBase
{
    public override async Task ResolveAsync(ITenantResolveContext context)
    {
        var host = context.httpContextAccessor.HttpContext.Request.Host.Host;
        var tenant = await CreateTenantAsync(host);
        if (tenant != null)
        {
            context.Result = new TenantResolveResult(tenant);
        }
    }
    
    private async Task<MyTenant> CreateTenantAsync(string host)
    {
        var url = $"http://tenant1.api.example.com/tenant/{host}";
        var json = await _httpClient.GetStringAsync(url);
        var result = JsonConvert.DeserializeObject<MyTenant>(json);
        return result;
    }
}

五、ABPvNext的自動化測試

ABPvNext提供了一組自動化測試工具，包括單元測試和集成測試。它支持多種測試框架，如xUnit、NUnit和MS Test。使用ABPvNext的測試工具，您可以輕鬆地創建和運行測試套件，以確保應用程序的質量和穩定性。

以下是使用ABPvNext自動化測試的示例代碼：

public class BookAppService_Tests : MyProjectApplicationTestBase
{
    private readonly IBookAppService _bookAppService;
    private readonly IRepository<Book, Guid> _bookRepository;
 
    public BookAppService_Tests()
    {
        _bookAppService = GetRequiredService<IBookAppService>();
        _bookRepository = GetRequiredService<IRepository<Book, Guid>>();
    }
 
    [Fact]
    public async Task Should_Get_All_Books()
    {
        var result = await _bookAppService.GetAllAsync(new GetAllBooksInput());
        result.Items.Count.ShouldBe(2);
    }
 
    // other tests
}