TestStack.FluentMVCTesting 技术文档
1. 安装指南
在开始使用 TestStack.FluentMVCTesting 之前,您需要首先安装该库。该库可以通过 NuGet 包管理器进行安装,将自动引用 System.Web 和 System.Web.Mvc。以下是不同版本 ASP.NET MVC 的安装命令:
-
如果您使用的是 ASP.NET MVC 5 (.NET 4.5+),则运行以下命令:
Install-Package TestStack.FluentMVCTesting
-
如果您使用的是 ASP.NET MVC 4 (.NET 4.0+),则运行以下命令:
Install-Package TestStack.FluentMVCTesting.Mvc4
-
如果您使用的是 ASP.NET MVC 3 (.NET 4.0+),则运行以下命令:
Install-Package TestStack.FluentMVCTesting.Mvc3
安装时,请确保您使用的是与您的 MVC 版本兼容的 NuGet 包。如果在安装过程中遇到 System.Security.VerificationException
异常,这可能意味着您引用的 System.Web.Mvc 版本与 NuGet 包中包含的 dll 不兼容。请确保使用正确版本的 MVC 包。
2. 项目的使用说明
TestStack.FluentMVCTesting 提供了一个流畅的接口,用于针对 ASP.NET MVC 控制器创建简洁且表达性强的测试。这个库与测试框架无关,因此可以与您选择的测试库(例如 NUnit、xUnit 等)结合使用。
该库兼容 AAA 测试方法,尽管它将 Act 和 Assert 部分结合在一起(但在 Fluent 断言之后,您也可以有其他断言)。以下是一些代码示例,供参考。
首先,创建一个测试类,如下所示:
using MyApp.Controllers;
using NUnit.Framework;
using TestStack.FluentMVCTesting;
namespace MyApp.Tests.Controllers
{
[TestFixture]
class HomeControllerShould
{
private HomeController _controller;
[SetUp]
public void Setup()
{
_controller = new HomeController();
}
}
}
然后,您可以创建一个如下所示的测试:
[Test]
public void Render_default_view_for_get_to_index()
{
_controller.WithCallTo(c => c.Index()).ShouldRenderDefaultView();
}
以上代码检查当调用 _controller.Index()
时返回的 ActionResult
是否为 ViewResult
类型,且视图名称为 "Index" 或空(Index 动作的默认视图)。
3. 项目API使用文档
以下是 TestStack.FluentMVCTesting 的一些断言示例:
var vm = new SomeViewModel();
_controller.WithModelErrors().WithCallTo(c => c.Index(vm))
.ShouldRenderDefaultView()
.WithModel(vm);
_controller.WithCallTo(c => c.Index())
.ShouldRenderDefaultView()
.WithModel<ModelType>()
.AndModelErrorFor(m => m.Property1).ThatEquals("The error message.")
.AndModelErrorFor(m => m.Property2);
_controller.WithCallTo(c => c.Index())
.ShouldRenderView("ViewName");
_controller.WithCallTo(c => c.Index())
.ShouldReturnEmptyResult();
_controller.WithCallTo(c => c.Index())
.ShouldRedirectTo("http://www.google.com.au/");
_controller.WithCallTo(c => c.ActionWithRedirectToAction())
.ShouldRedirectTo(c => c.ActionInSameController);
_controller.WithCallTo(c => c.Index())
.ShouldRedirectTo<SomeOtherController>(c => c.SomeAction());
_controller.WithCallTo(c => c.Index())
.ShouldRenderAnyFile("content/type");
_controller.WithCallTo(c => c.Index())
.ShouldRenderFileContents("text");
_controller.WithCallTo(c => c.Index())
.ShouldReturnContent("expected content");
_controller.WithCallTo(c => c.Index())
.ShouldGiveHttpStatus(404);
_controller.WithCallTo(c => c.Index()).ShouldReturnJson(data =>
{
Assert.That(data.SomeProperty, Is.EqualTo("SomeValue"));
});
以上示例展示了如何使用不同的断言方法对 MVC 控制器的行为进行测试。
4. 项目安装方式
项目的安装方式已在“安装指南”一节中详细说明,请参考上述 NuGet 包安装命令进行操作。
- 国产编程语言蓝皮书《国产编程语言蓝皮书》-编委会工作区011
- nuttxApache NuttX is a mature, real-time embedded operating system (RTOS).C00
- 每日精选项目🔥🔥 01.08日推荐:提升信息检索能力与创意的AI助手:Khoj🔥🔥 每日推荐行业内最新、增长最快的项目,快速了解行业最新热门项目动态~~022
- Cangjie-Examples本仓将收集和展示高质量的仓颉示例代码,欢迎大家投稿,让全世界看到您的妙趣设计,也让更多人通过您的编码理解和喜爱仓颉语言。Cangjie042
- 毕方Talon工具本工具是一个端到端的工具,用于项目的生成IR并自动进行缺陷检测。Python039
- PDFMathTranslatePDF scientific paper translation with preserved formats - 基于 AI 完整保留排版的 PDF 文档全文双语翻译,支持 Google/DeepL/Ollama/OpenAI 等服务,提供 CLI/GUI/DockerPython05
- mybatis-plusmybatis 增强工具包,简化 CRUD 操作。 文档 http://baomidou.com 低代码组件库 http://aizuda.comJava03
- advanced-javaAdvanced-Java是一个Java进阶教程,适合用于学习Java高级特性和编程技巧。特点:内容深入、实例丰富、适合进阶学习。JavaScript0106
- taro开放式跨端跨框架解决方案,支持使用 React/Vue/Nerv 等框架来开发微信/京东/百度/支付宝/字节跳动/ QQ 小程序/H5/React Native 等应用。 https://taro.zone/TypeScript09
- Yi-CoderYi Coder 编程模型,小而强大的编程助手HTML012