2020/01/28, ASP.NET Core 3.1, VS2019, xUnit 2.4.0
摘要：基于ASP.NET Core 3.1 WebApi搭建后端多层网站架构【3-xUnit单元测试之简单方法测试】
使用xUnit编写单元测试，测试上一章节的基础公共库
上一章节已经建立了Common公共类库，本章节介绍编写简单的单元测试，对上一章节的公共类库中EnumExtension方法编写单元测试，同时也是介绍上一章节中公共类库EnumExtension的使用方法
官方文档对测试的最佳实践
新建测试项目
在tests解决方案文件夹下，新建xUnit测试项目，存放在解决方案tests路径下：
我这里测试项目名称规则为"测试目标项目名称+Tests"，这里测试的是Common项目，所以测试项目取名CommonTests
项目新建成功后，记得要引用MS.Common类库
新建一个枚举用于测试
既然是为了测试枚举方法，当然需要先有一个枚举StatusCodeEnum.cs类，就存放在测试项目下：
using System.ComponentModel;
namespace CommonTests
{
public enum StatusCode
{
[Description("已删除")]
Deleted = -1,//软删除，已删除的无法恢复，无法看见，暂未使用
[Description("生效")]
Enable = 0,
[Description("失效")]
Disable = 1//失效的还可以改为生效
}
}
编写枚举方法测试代码
把原先的UnitTest1.cs删除，新建EnumExtensionTest.cs类：
可以看到我这里测试类命名规则为"测试目标类名称+Test"，这里测试的是EnumExtension类，所以取名为EnumExtensionTest
将EnumExtensionTest类修改为pulic类型
在其中添加测试一个测试方法：
[Fact]
[Trait("GetEnum", "itemName")]
public void GetEnum_EnumName_ReturnCorrespondEnum()
{
//Arrange
StatusCode statusCode = StatusCode.Deleted;
//Act
string actual = statusCode.ToString();
//Assert
Assert.Equal(statusCode, actual.GetEnum<StatusCode>());
}
- 测试类必须是public类型
- 测试用例需要打上
[Fact]特性标记，Fact特性还可以给测试用例取别名 - Trait特性可以对测试用例进行分组说明
- 更多特性和使用方法可以搜索相关资源
- 测试方法命名规则为"要测试的方法的名称+测试的方案+调用方案时的预期行为"：
- 此处测的是GetEnum方法，使用Enum名称，获取对应的枚举
- 所以叫GetEnum_EnumName_ReturnCorrespondEnum
- 整体方法名要易于理解测试的目的
- 测试要分为三部分（AAA）：Arrange、Act、Assert：
- 安排对象，根据需要对其进行创建和设置
- 作用于对象
- 断言某些项按预期进行
运行测试
在VS中"测试"-"测试资源管理器"，打开测试资源管理器：
在测试资源管理器中已经可以看到我们刚刚写的测试用例。
点击运行所有测试：
等待测试结束，便会给出测试结果：
以上便是最简单的单元测试流程
针对EnumExtension方法完整的测试用例代码：
using MS.Common.Extensions;
using Xunit;
namespace CommonTests
{
public class EnumExtensionTest
{
[Fact]
[Trait("GetEnum", "itemName")]
public void GetEnum_EnumName_ReturnCorrespondEnum()
{
//Arrange
StatusCode statusCode = StatusCode.Deleted;
//Act
string actual = statusCode.ToString();
//Assert
Assert.Equal(statusCode, actual.GetEnum<StatusCode>());
}
[Fact]
[Trait("GetEnum", "itemValue")]
public void GetEnum_EnumValue_ReturnCorrespondEnum()
{
//Arrange
StatusCode statusCode = StatusCode.Disable;
//Act
int actual = statusCode.GetHashCode();
//Assert
Assert.Equal(statusCode, actual.GetEnum<StatusCode>());
}
[Fact]
[Trait("GetEnumName", "itemValue")]
public void GetEnumName_EnumValue_ReturnCorrespondEnumName()
{
//Arrange
StatusCode statusCode = StatusCode.Enable;
//Act
int actual = statusCode.GetHashCode();
//Assert
Assert.Equal(statusCode.ToString(), actual.GetEnumName<StatusCode>());
}
[Fact]
[Trait("GetEnumValue", "itemName")]
public void GetEnumValue_EnumName_ReturnCorrespondEnumValue()
{
//Arrange
StatusCode statusCode = StatusCode.Disable;
//Act
string actual = statusCode.ToString();
//Assert
Assert.Equal(statusCode.GetHashCode(), actual.GetEnumValue<StatusCode>());
}
[Fact]
[Trait("GetDescription", "Enum")]
public void GetDescription_Enum_ReturnCorrespondEnumDescription()
{
//Arrange
StatusCode statusCode = StatusCode.Deleted;
//Assert
Assert.Equal("已删除", statusCode.GetDescription());
}
}
}
添加了一个简单的单元测试用例，介绍了最基本的单元测试流程和方法
项目完成后，如下图所示