C#单元测试的使用（一）

1  单元测试基础   

什么是单元测试？

一个单元测试是一段自动化的代码，这段代码调用被测试的工作单元，之后对这个单元的单个最终结果的某些假设进行检验。

单元测试几乎都是用单元测试框架编写的。单元测试容易编写，能够快速运行。单元测试可靠、可读，并且可维护。

只要产品代码不发生变化，单元测试的结果是稳定的。

与集成测试有何区别？

Note：集成测试是对一个工作单元进行的测试，这个测试对被测试的工作单元没有完全的控制，并使用该单元的一个或多个真实依赖物，例如时间、网络、数据库、线程或随机数产生器等。

2  测试驱动开发基础   

传统的单元测试流程

测试驱动开发流程概要

3  第一个单元测试   

NUnit

LogAn示例项目

LogAn （Log And Notificaition）

场景：公司有很多内部产品，用于在客户场地监控公司的应用程序。所有这些监控产品都会写日志文件，日志文件存放在一个特定的目录中。日志文件的格式是你们公司自己制定的，无法用现有的第三方软件进行解析。你的任务是：实现一个产品，对这些日志文件进行分析，在其中搜索特定的情况和事件，这个产品就是LogAn。找到特定的情况和事件后，这个产品应该通知相关的人员。

在本次的单元测试实践中，我们会一步一步编写测试来验证LogAn的解析、事件识别以及通知功能。首先，我们需要了解使用NUnit来编写单元测试（当然你也可以使用MsTest也是可以的）。

编写第一个单元测试

（1）我们的测试从以下这个LogAnalyzer类开始，这个类暂时只有一个方法IsValidLogFileName：

    public class LogAnalyzer    {        public bool IsValidLogFileName(string fileName)        {            if (fileName.EndsWith(".SLF"))            {                return false;            }            return true;        }    }

这个方法检查文件扩展名，据此判断一个文件是不是有效的日志文件。

这里在if中故意去掉了一个!运算符，因此这个方法就包含了一个Bug-当文件名以.SLF结尾时会返回false，而不是返回true。这样，我们就能看到测试失败时在测试运行期中显示什么内容。

（2）新建一个类库项目，命名为Manulife.LogAn.UnitTests（被测试项目项目名为Manulife.LogAn.Lib）。添加一个类，取名为LogAnalyzerTests.cs。

（3）在LogAnalyzerTests类中新增一个测试方法，取名为IsValidFileName_BadExtension_ReturnsFalse()。

首先，我们要明确如何编写测试代码，一般来说，一个单元测试通常包含三个行为：

因此，根据以上三个行为，我们可以编写出以下的测试方法：（其中断言部分使用了NUnit框架提供的Assert类）

    [TestFixture]    public class LogAnalyzerTests    {        [Test]        public void IsValidFileName_BadExtension_ReturnsFalse()        {            LogAnalyzer analyzer = new LogAnalyzer();            bool result = analyzer.IsValidLogFileName("filewithbadextension.foo");            Assert.AreEqual(false, result);        }    }

其中，属性[TestFixture]和[Test]是NUnit的特有属性，NUnit用属性机制来识别和加载测试。这些属性就像一本书里的书签，帮助测试框架识别记载程序集里面的重要部分，以及哪些部分是需要调用的测试。

1.[TestFixture]加载一个类上，标识这个类是一个包含自动化NUnit测试的类；

2.[Test]加在一个方法上，标识这个方法是一个需要调用的自动化测试；

另外，再说一下测试方法名称的规范，一般包含三个部分：[UnitOfWorkName]_[ScenarioUnderTest]_[ExpectedBehavior]

1.UnitOfWorkName　　被测试的方法、一组方法或者一组类

2.Scenario　　测试进行的假设条件，例如“登入失败”，“无效用户”或“密码正确”等

3.ExpectedBehavior　　在测试场景指定的条件下，你对被测试方法行为的预期　　

奔跑吧，第一个单元测试

（1）编写好测试代码之后，点击"测试"->"运行"->"所有测试"

（2）然后，点击"测试"->"窗口"->"测试窗口管理器"，你会看到以下场景

从上图可以看出，我们得测试方法并没有通过，我们期望（Expected）的结果是False，而实际（Actual）的结果却是True。

继续添加你的单元测试

（1）通常在进行单元测试时我们会考虑到代码覆盖率，点击"测试"->"分析代码覆盖率"->"所有测试"，你可以看到以下结果：80%

（2）这时，我们需要想出完善的测试策略来覆盖所有的情况，因此我们添加一些测试方法来提高我们的代码覆盖率。这里我们添加两个方法，一个测试大写文件扩展名，一个测试小写文件扩展名：

    [Test]    public void IsValidFileName_GoodExtensionLowercase_ReturnsTrue()    {        LogAnalyzer analyzer = new LogAnalyzer();        bool result = analyzer.IsValidLogFileName("filewithgoodextension.slf");        Assert.AreEqual(true, result);    }
    [Test]    public void IsValidFileName_GoodExtensionUppercase_ReturnsTrue()    {        LogAnalyzer analyzer = new LogAnalyzer();        bool result = analyzer.IsValidLogFileName("filewithgoodextension.SLF");        Assert.AreEqual(true, result);    }

这时测试结果如下图所示：

这时再来看看代码覆盖率：100%

（3）为了让所有的测试都能通过，这时我们需要修改源代码，改用大小写不敏感的字符串匹配：

    public bool IsValidLogFileName(string fileName)    {        if (!fileName.EndsWith(".SLF", StringComparison.CurrentCultureIgnoreCase))        {            return false;        }        return true;    }

这时，我们再来运行一下所有的测试（也可以选择 运行未通过的测试）来看下由红到绿的快感。单元测试的理念很简单：只有所有的测试都通过，继续前行的绿灯才会亮起。哪怕只有一个测试失败了，进度条上都会亮起红灯，显示你的系统（或者测试）出现了问题。

4 More%20NUnit

参数化重构单元测试

NUnit中有个叫做 参数化测试（Parameterized%20Tests）的功能，我们可以借助[TestCase]标签特性来重构我们的单元测试：

可以看到，借助TestCase特性，测试数目没有改变，但是测试代码却变得更易维护，更加易读。

SetUp与TearDown

NUnit还有一些特别的标签特性，可以很方便地控制测试前后的设置和清理状态工作，他们就是[SetUp]和[TearDown]。

1.[SetUp]%20这个标签加在一个方法上，NUnit每次在运行测试类里的任何一个测试时都会先运行这个setup方法；

2.[TearDown]%20这个标签标识一个方法应该在测试类里的每个测试运行完成之后执行；

  [TestFixture]
    public class LogAnalyzerTests
    {
        private LogAnalyzer analyzer = null;
        [SetUp]
        public void Setup()
        {
            analyzer = new LogAnalyzer();
        }

        [Test]
        public void IsValidFileName_ValidFileLowerCased_ReturnsTrue()
        {
            bool result = analyzer.IsValidLogFileName("whatever.slf");
            Assert.IsTrue(result, "filename should be valid!");
        }

        [Test]
        public void IsValidFileName_ValidFileUpperCased_ReturnsTrue()
        {
            bool result = analyzer.IsValidLogFileName("whatever.SLF");
            Assert.IsTrue(result, "filename should be valid!");
        }

        [TearDown]
        public void TearDown()
        {
            analyzer = null;
        }
    }

我们可以把setup和teardown方法想象成测试类中测试的构造函数和析构函数，在每个测试类中只能有一个setup和teardown方法，这两个方法对测试类中的每个方法只执行一次。

不过，使用[Setup]越多，测试代码可读性就越差。原书作者推荐采用工厂方法（Factory%20Method）初始化被测试的实例。

  /// <summary>
    /// 工厂方法初始化 LogAnalyzer
    /// 既节省编写代码的时间，又使每个测试内的代码更简洁易读
    /// 同时保证 LogAnalyzer 总是用同样的方式初始化
    /// </summary>
    private static LogAnalyzer MakeAnalyzer()
    {
        return new LogAnalyzer();
    }

 [Test]
    public void IsValidFileName_BadExtension_ReturnsFalse()
    {
        LogAnalyzer analyzer = MakeAnalyzer();
        bool result = analyzer.IsValidLogFileName("filewithbadextension.foo");
        Assert.AreEqual(false, result);
    }

很多时候，我们的方法中会抛出一些异常，这时如果我们的测试也应该做一些修改。在NUnit中，提供了一个API%20:%20Assert.Catch<T>(delegate)

首先，我们修改一下被测试的方法，增加一行判断文件名是否为空的代码：

public bool IsValidLogFileName(string fileName)
    {
        if(string.IsNullOrEmpty(fileName))
        {
            throw new ArgumentException("filename has to be provided");
        }

        if (!fileName.EndsWith(".SLF", StringComparison.CurrentCultureIgnoreCase))
        {
            return false;
        }
        return true;
    }

 [Test]
    public void IsValidFileName_EmptyName_Throws()
    {
        LogAnalyzer analyzer = new LogAnalyzer();
        // 使用Assert.Catch
        var ex = Assert.Catch<Exception>(() => analyzer.IsValidLogFileName(string.Empty));
        // 使用Assert.Catch返回的Exception对象
        StringAssert.Contains("filename has to be provided", ex.Message);
    }

忽略测试

有时候测试代码有问题，但是我们又需要把代码签入到主代码树中。在这种罕见的情况下（虽然确实非常少），可以给那些测试代码自身有问题的测试加一个[Ignore]标签特性。

[Test]
    [Ignore("there is a problem with this test!")]
    public void IsValidFileName_ValidFile_ReturnsTrue()
    {
        // ...
    }

可以看到，这个测试确实被忽略了：

设置测试的类别

我们可以把测试按照指定的测试类别运行，使用[Category]标签特性就可以实现这个功能：

    [Test]
    [Category("Fast Tests")]
    public void IsValidFileName_BadExtension_ReturnsFalse()
    {
        LogAnalyzer analyzer = new LogAnalyzer();
        bool result = analyzer.IsValidLogFileName("filewithbadextension.foo");
        Assert.AreEqual(false, result);
    }

此前我们得测试都有返回值，而很多要测试的方法都没有返回值，而只是改变对象中的某些状态，我们又该如何测试呢？

首先，我们修改IsValidLogFileName方法，增加一个状态属性：

public class LogAnalyzer
    {
        public bool WasLastFileNameValid { get; set; }
        public bool IsValidLogFileName(string fileName)
        {
            // 改变系统状态
            WasLastFileNameValid = false;

            if(string.IsNullOrEmpty(fileName))
            {
                throw new ArgumentException("filename has to be provided");
            }

            if (!fileName.EndsWith(".SLF", StringComparison.CurrentCultureIgnoreCase))
            {
                return false;
            }

            // 改变系统状态
            WasLastFileNameValid = true;

            return true;
        }
    }

其次，我们编写一个测试，对系统状态进行断言：

 [TestCase("badfile.foo", false)]
    [TestCase("goodfile.slf", true)]
    public void IsValidFileName_WhenCalled_ChangesWasLastFileNameValid(string fileName, bool expected)
    {
        LogAnalyzer analyzer = new LogAnalyzer();
        analyzer.IsValidLogFileName(fileName);
        Assert.AreEqual(expected, analyzer.WasLastFileNameValid);
    }

5  小结

这一篇作为入门，带领大家领略了一下单元测试的概念，如何编写单元测试，如何在VS中应用NUnit进行单元测试。相信大家以前都用过MSTest，而我们这里却使用了NUnit。所以，下面我们来总结一下MSTest与NUnit在特性标签上的一些区别：