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项目中.
此包提供的AbpWebApplicationFactoryIntegratedTest作为派生测试类的基类. 它继承自ASP.NET Core提供的WebApplicationFactory类。
上面使用的MyProjectWebTestBase继承自AbpWebApplicationFactoryIntegratedTest, 因此我们间接继承了AbpWebApplicationFactoryIntegratedTest.
另请参阅
08-09 五月
