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

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

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

     在Demo中添加如下代码：

namespace Demo
{
    public class FileVerify
    {
        public bool IsValidFileName(string filename)
        {
            if(filename.EndsWith(".txt"))
            {
                return true;
            }
            return false;
        }
    }
}

 

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

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

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

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

 

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

using NUnit.Framework;

namespace Demo.Tests
{
    [TestFixture]
    public class FileVerifyTests
    {
        [Test]
        public void IsValidFileName_BadExtensions_ReturnFalse()
        {
            FileVerify fileVerify = MakFileVerify();

            var result = fileVerify.IsValidFileName("filename.too");

            Assert.False(result);
        }


        private FileVerify MakFileVerify()
        {
            return new FileVerify();
        }
    }
}

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，忽略大小写，代码修改如下

        public bool IsValidFileName(string filename)
        {
            if(filename.EndsWith(".txt",StringComparison.CurrentCultureIgnoreCase))
            {
                return true;
            }
            return false;
        }

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

 

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

        [TestCase("filename.txt")]
        [TestCase("filename.TXT")]
        public void IsValidFileName_GoodExtension_ReturnTrue(string filename)
        {
            FileVerify fileVerify = MakFileVerify();

            var result = fileVerify.IsValidFileName(filename);

            Assert.True(result);
        }

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

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

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

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

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

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

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

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

     修改后的产品代码为

        public bool IsValidFileName(string filename)
        {
            if (string.IsNullOrWhiteSpace(filename))
            {
                throw new ArgumentException();
            }
            if (filename.EndsWith(".txt", StringComparison.CurrentCultureIgnoreCase))
            {
                return true;
            }
            return false;
        }

     添加的测试为

        [Test]
        public void IsValidFileName_EmptyFileName_Throw()
        {
            FileVerify fileVerify = MakFileVerify();

            var ex = Assert.Catch<ArgumentException>(() => fileVerify.IsValidFileName(""));

            StringAssert.Contains("filename has to be provided", ex.Message);
        }

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

      如有错误之处，请指出！