单元测试(一)(我的第一个单元测试)

一.创建项目并在被测试项目中编写代码
分别建立两个类库项目:被测试项目(Demo)和 测试项目(命名规范:在被项目项目后添加.TestsDemo.Tests)
在Demo中添加如下代码:

1 namespace Demo 2 { 3public class FileVerify 4{ 5public bool IsValidFileName(string filename) 6{ 7if(filename.EndsWith(".txt")) 8{ 9return true; 10} 11return false; 12} 13} 14 }


二.安装测试框架NUit,需要安装两个包(下图所示)
NUint是编写单元测试框架用的包
NUnit3TestAdapter是适配VS中的测试资源管理器的
注意:如果只安装NUnit包,在测试资源管理器中点击运行测试 则不会执行 而会提示:测试未运行
单元测试(一)(我的第一个单元测试)
文章图片


三.在Demo.Tests中编写单元测试
1 using NUnit.Framework; 2 3 namespace Demo.Tests 4 { 5[TestFixture] 6public class FileVerifyTests 7{ 8[Test] 9public void IsValidFileName_BadExtensions_ReturnFalse() 10{ 11FileVerify fileVerify = MakFileVerify(); 12 13var result = fileVerify.IsValidFileName("filename.too"); 14 15Assert.False(result); 16} 17 18 19private FileVerify MakFileVerify() 20{ 21return new FileVerify(); 22} 23} 24 }

1.Demo.Tests项目需先引用项目Demo
2.需引用NUnit.Framework命名空间
3.添加Attribute
[TestFixture]:添加到类上,标识该类包含自动化测试
[Test]:添加到方法上,标识该方法是一个需要调用的自动化测试
标注了这两个Attribute 测试资源管理器中就可以找到该测试方法了
4.测试方法访问修饰符必须为public 返回值类型必须为void
5.测试方法名称【IsValidFileName_BadExtensions_ReturnFalse】 命名三个部分:
①【工作单元名】如果工作单元是一个方法,那就是方法名;如果工作单元是一组方法,那名称需要抽象一点,涵盖这一组方法。
②【测试进行的假设条件】假设条件可以从两方面来理解:一是描述传给方法的参数,例如本例中的【BadExtensions】二是描述系统的初始状态
③【预期】对测试方法的预期。测试方法有3中行为:返回一个值(真实值或异常)【例如本例中的RetureFalse】、改变系统状态、调用第三方系统
然后将①②③用_连接起来这样可读性会很高
6.方法体包含三个行为:创建对象(Line 11) 操作对象(Line 13) 断言(Line 15)
建议:行为之间空一行,并且不在断言中进行函数调用,这样有良好的可读性,让更多的人可以读懂测试
7.MakeFileVerify方法是一个工厂方法,这样做的目的是为了:当之后FileVerify的构造函数发生变化后 只需要改动这一个地方为单元测试的可维护性打下了基础
8.Assert.False()是NUnit框架中断言的方法
【单元测试(一)(我的第一个单元测试)】
四.对该测试添加正验证
对于上面的测试从逻辑上讲不是完整的,我们还需要考虑扩展名的大小写,所以我们添加大写和小写后缀的测试,代码如下
[Test] public void IsValidFileName_GoodExtensionLower_ReturnTrue() { FileVerify fileVerify = MakFileVerify(); var result = fileVerify.IsValidFileName("filename.txt"); Assert.True(result); }[Test] public void IsValidFileName_GoodExtensionUpper_ReturnTrue() { FileVerify fileVerify = MakFileVerify(); var result = fileVerify.IsValidFileName("filename.TXT"); Assert.True(result); }

然后执行测试,发现大写测试失败,测试结果如下
单元测试(一)(我的第一个单元测试)
文章图片

这个时候我们需要修改产品代码,修改位置在Line 3,忽略大小写,代码修改如下
1public bool IsValidFileName(string filename) 2{ 3if(filename.EndsWith(".txt",StringComparison.CurrentCultureIgnoreCase)) 4{ 5return true; 6} 7return false; 8}

这个时候重新运行测试,3个测试就全部通过了

五.使用NUnit的【参数化测试】功能重构测试
1[TestCase("filename.txt")] 2[TestCase("filename.TXT")] 3public void IsValidFileName_GoodExtension_ReturnTrue(string filename) 4{ 5FileVerify fileVerify = MakFileVerify(); 6 7var result = fileVerify.IsValidFileName(filename); 8 9Assert.True(result); 10}

1.将方法上标记的[Test]替换为[TestCase("参数")]
2.重新命名测试方法将GoodExtension后的大小写去除,变得更通用
3.将测试方法参数中定义一个参数filename
4.把测试中硬编码的值替换成这个测试方法的参数
5.把替换掉的值放到[TestCase(param1)]中
测试运行器会将TestCase括号中的参数赋值给测试方法的参数;可以在一个测试方法上添加多个[TestCase]
六.测试预期异常保证当异常应该抛出时,被测试的方法能够正确的抛出异常
当用户输入的文件名为null或空时,这个时候应该抛出ArgumentException异常。如果代码没有抛出异常,那么测试就是失败的
修改后的产品代码为
1public bool IsValidFileName(string filename) 2{ 3if (string.IsNullOrWhiteSpace(filename)) 4{ 5throw new ArgumentException(); 6} 7if (filename.EndsWith(".txt", StringComparison.CurrentCultureIgnoreCase)) 8{ 9return true; 10} 11return false; 12}

添加的测试为
1[Test] 2public void IsValidFileName_EmptyFileName_Throw() 3{ 4FileVerify fileVerify = MakFileVerify(); 5 6var ex = Assert.Catch(() => fileVerify.IsValidFileName("")); 7 8StringAssert.Contains("filename has to be provided", ex.Message); 9}

这样一个简单的测试就完成了!
如有错误之处,请指出!



    推荐阅读