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

一.创建项目并在被测试项目中编写代码

     分别建立两个类库项目：被测试项目（Demo）和 测试项目（命名规范：在被项目项目后添加.Tests   Demo.Tests）  

     在Demo中添加如下代码：

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

二.安装测试框架NUit,需要安装两个包（下图所示）

NUint是编写单元测试框架用的包

NUnit3TestAdapter是适配VS中的测试资源管理器的 

注意：如果只安装NUnit包，在测试资源管理器中点击运行测试 则不会执行 而会提示：测试未运行

三.在Demo.Tests中编写单元测试

 1 using NUnit.Framework;
 2 
 3 namespace Demo.Tests
 4 {
 5     [TestFixture]
 6     public class FileVerifyTests
 7     {
 8         [Test]
 9         public void IsValidFileName_BadExtensions_ReturnFalse()
10         {
11             FileVerify fileVerify = MakFileVerify();
12 
13             var result = fileVerify.IsValidFileName("filename.too");
14 
15             Assert.False(result);
16         }
17 
18 
19         private FileVerify MakFileVerify()
20         {
21             return 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，忽略大小写，代码修改如下

1         public bool IsValidFileName(string filename)
2         {
3             if(filename.EndsWith(".txt",StringComparison.CurrentCultureIgnoreCase))
4             {
5                 return true;
6             }
7             return false;
8         }

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

五.使用NUnit的【参数化测试】功能重构测试 

 1         [TestCase("filename.txt")]
 2         [TestCase("filename.TXT")]
 3         public void IsValidFileName_GoodExtension_ReturnTrue(string filename)
 4         {
 5             FileVerify fileVerify = MakFileVerify();
 6 
 7             var result = fileVerify.IsValidFileName(filename);
 8 
 9             Assert.True(result);
10         }

     1.将方法上标记的[Test]替换为[TestCase("参数")]

     2.重新命名测试方法将GoodExtension后的大小写去除，变得更通用

     3.将测试方法参数中定义一个参数filename

     4.把测试中硬编码的值替换成这个测试方法的参数

     5.把替换掉的值放到[TestCase(param1)]中

     测试运行器会将TestCase括号中的参数赋值给测试方法的参数；可以在一个测试方法上添加多个[TestCase]

六.测试预期异常   保证当异常应该抛出时，被测试的方法能够正确的抛出异常

     当用户输入的文件名为null或空时，这个时候应该抛出ArgumentException异常。如果代码没有抛出异常，那么测试就是失败的

     修改后的产品代码为

 1         public bool IsValidFileName(string filename)
 2         {
 3             if (string.IsNullOrWhiteSpace(filename))
 4             {
 5                 throw new ArgumentException();
 6             }
 7             if (filename.EndsWith(".txt", StringComparison.CurrentCultureIgnoreCase))
 8             {
 9                 return true;
10             }
11             return false;
12         }

     添加的测试为

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

      这样一个简单的测试就完成了！

      如有错误之处，请指出！