ASP.NET Core MVC / Razor Pages: 测试

你可以参考ASP.NET Core集成测试文档了解ASP.NET Core集成测试的详细内容. 本文档解释了ABP框架提供的附加测试基础设施.

应用程序启动模板

应用程序启动模板的.Web项目其中包含应用程序的UI视图/页面/组件, 并提供.Web.Tests项目来测试这些内容.

测试Razor页面

假设你已经创建了一个名为Issues.cshtml的Razor页面, 包含以下内容;

Issues.cshtml.cs

using System.Collections.Generic;
using System.Threading.Tasks;
using Microsoft.AspNetCore.Mvc.RazorPages;
using MyProject.Issues;
namespace MyProject.Web.Pages
{
    public class IssuesModel : PageModel
    {
        public List<IssueDto> Issues { get; set; }
        private readonly IIssueAppService _issueAppService;
        public IssuesModel(IIssueAppService issueAppService)
        {
            _issueAppService = issueAppService;
        }
        public async Task OnGetAsync()
        {
            Issues = await _issueAppService.GetListAsync();
        }
    }
}

Issues.cshtml

@page
@model MyProject.Web.Pages.IssuesModel
<h2>Issue List</h2>
<table id="IssueTable" class="table">
    <thead>
        <tr>
            <th>Issue</th>
            <th>Closed?</th>
        </tr>
    </thead>
    <tbody>
        @foreach (var issue in Model.Issues)
        {
            <tr>
                <td>@issue.Title</td>
                <td>
                    @if (issue.IsClosed)
                    {
                        <span>Closed</span>
                    }
                    else
                    {
                        <span>Open</span>
                    }
                </td>
            </tr>
        }
    </tbody>
</table>

本页仅创建一个包含issue的表格:

你可以在.Web.Tests项目中编写一个测试类如下所示:

using System.Threading.Tasks;
using HtmlAgilityPack;
using Shouldly;
using Xunit;
namespace MyProject.Pages
{
    public class Issues_Tests : MyProjectWebTestBase
    {
        [Fact]
        public async Task Should_Get_Table_Of_Issues()
        {
            // Act
            var response = await GetResponseAsStringAsync("/Issues");
            //Assert
            var htmlDocument = new HtmlDocument();
            htmlDocument.LoadHtml(response);
            var tableElement = htmlDocument.GetElementbyId("IssueTable");
            tableElement.ShouldNotBeNull();
            var trNodes = tableElement.SelectNodes("//tbody/tr");
            trNodes.Count.ShouldBeGreaterThan(0);
        }
    }
}

GetResponseAsStringAsync是一个快捷方法, 它来自执行HTTP GET请求的基类, 检查生成的HTTP状态是否为200, 并将响应作为string返回.

你可以使用Client对象(类型为HttpClient)对服务器执行任何类型的请求, 并读取响应.GetResponseAsStringAsync只是一种快捷方法.

本例使用HtmlAgilityPack库来解析传入的HTML并测试它是否包含issue表格.

本例假设的数据库中存在一些初始issue. 请参阅测试文档的种子数据部分, 了解如何设置种子数据, 以便可以假定数据库中有一些可用的初始数据.

控制器测试

测试控制器也不例外. 只需使用正确的URL向服务器执行请求, 获取响应并做出断言.

查看结果

如果控制器返回一个视图, 你可以使用类似的代码来测试返回的HTML. 参见上面的Razor页面示例.

对象结果

如果控制器返回对象结果, 则可以使用GetResponseAsObjectAsync方法.

假设你有一个如下定义的控制器:

using System.Collections.Generic;
using System.Threading.Tasks;
using Microsoft.AspNetCore.Mvc;
using MyProject.Issues;
using Volo.Abp.AspNetCore.Mvc;
namespace MyProject.Web.Controllers
{
    [Route("api/issues")]
    public class IssueController : AbpController
    {
        private readonly IIssueAppService _issueAppService;
        public IssueController(IIssueAppService issueAppService)
        {
            _issueAppService = issueAppService;
        }
        [HttpGet]
        public async Task<List<IssueDto>> GetAsync()
        {
            return await _issueAppService.GetListAsync();
        }
    }
}

你可以编写测试代码来调用API并获得结果:

using System.Collections.Generic;
using System.Threading.Tasks;
using MyProject.Issues;
using Shouldly;
using Xunit;
namespace MyProject.Pages
{
    public class Issues_Tests : MyProjectWebTestBase
    {
        [Fact]
        public async Task Should_Get_Issues_From_Api()
        {
            var issues = await GetResponseAsObjectAsync<List<IssueDto>>("/api/issues");
            issues.ShouldNotBeNull();
            issues.Count.ShouldBeGreaterThan(0);
        }
    }
}

测试JavaScript代码

ABP框架不提供任何基础设施来测试JavaScript代码. 你可以使用任何测试框架和工具来测试JavaScript代码.

测试基础设施

Volo.Abp.AspNetCore.TestBase 提供了集成到ABP框架和ASP.NET Core的测试基础设施.

Volo.Abp.AspNetCore.TestBase 已经安装在 .Web.Tests 项目中.

此包提供的AbpAspNetCoreIntegratedTestBase作为派生测试类的基类. 上面使用的MyProjectWebTestBase继承自AbpAspNetCoreIntegratedTestBase, 因此我们间接继承了AbpAspNetCoreIntegratedTestBase.

基本属性

AbpAspNetCoreIntegratedTestBase 提供了测试中使用的以下基本属性:

• Server: 在测试中托管web应用程序的TestServer实例.
• Client: 为执行对测试服务器的请求配置HttpClient实例.
• ServiceProvider: 可以在你需要时处理服务提供服务.

基本方法

AbpAspNetCoreIntegratedTestBase 提供了以下方法, 如果需要自定义测试服务器, 可以重写这些方法:

• ConfigureServices 仅为派生测试类注册/替换服务时可以重写使用.
• CreateHostBuilder 可用于自定义生成 IHostBuilder.

另请参阅

• 总览/服务器端测试