ASP.NET Core中使用xUnit进行单元测试

单元测试的功能自从MVC的第一个版本诞生的时候，就是做为一个重要的卖点来介绍的，一般在拿MVC与webform比较的时候，单元测试就是必杀底牌，把webform碾压得一无可取。

单元测试的重要性不用多说了，有单元测试的作兜底的项目，比如给开发人员买了份保险，固然这个保险的质量取决于单元测试的质量，那些一路Mock的单元测试，看起来很美，可是什么都cover不到。目前工做中的一个老项目，有2万多个单元测试用例，其中很多是用心之做，真正落实到了业务逻辑，开发人员能够放心的去修改代码，固然一切都必须按照TDD的原则来进行，具体就不详细说了。

接下来进入正题，单元测试这个重要的基础功能，在.NET Core中固然不能少，相关的API和组件提供的功能跟以前的版本没什么大的区别，主要在于须要对.NET Core的支持，说白了就是以前在.NET Framework平台下的代码，得从新生成支持.NET Core。好比本文要说到的xUnit，xUnit已经提供了对.NET Core的支持版本，下面咱们来看看如何在ASP.NET Core中使用xUnit进行单元测试。

准备项目代码：

1.建立一个空白的ASP.NET Core web项目，命名为UseXunit。

2.而后修改project.json的内容以下，在dependencies的最后一行加入对MVC组件的依赖

   "Microsoft.AspNetCore.Mvc": "1.0.1"

3.修改Startup.cs文件

   在ConfigureServices方法加入services.AddMvc();

   在Configure方法加入app.UseMvcWithDefaultRoute();

3.而后在项目根目录新建一个Controllers目录，并添加一个HomeController，代码以下

public class HomeController : Controller
    {
        public IActionResult Index()
        {
            return Content("Hello test");
        }
    }

4.到这里项目应该能跑起来了，运行后能看到输出Hello test，说明一个简单的项目已具有了。

 

加入单元测试项目

接下来加入单元测试项目，独立一个测试项目方便管理。

1.右键解决方案文件，而后选择新建一个解决方案文件夹，而后命名为test

2.在test目录下新建一个.NET Core项目，这里选择的项目类型是Class Library(.NET Core)，命名项目名为UseXunit.Tests

3.而后修改Tests项目的project.json内容为以下

{
  "version": "1.0.0-*",
  "testRunner": "xunit",
  "dependencies": {
    "Microsoft.NETCore.App": {
      "type": "platform",
      "version": "1.0.0"
    },
    "xunit": "2.1.0",
    "dotnet-test-xunit": "2.2.0-preview2-build1029",
    "UseXunit": "1.0.0",

    "Microsoft.AspNetCore.Mvc": "1.0.1"
  },
  "frameworks": {
    "netcoreapp1.0": {
      "imports": [ "dotnet5.6", "portable-net45+win8" ]
    }
  }
}

这里的改动几乎重写了系统默认生成的配置，系统默认的配置几乎跑不起来，须要从新设置。

dependencies引入了xunit，以及dotnet-test-xunit的运行支持package，固然也加入了对待测试项目的依赖(UseXunit)。

另一个关键配置是指定了testrunner为xunit

保存以后会自动restore相关的packages。

4.如今能够开始建立TestCase

新建一个HomeControllerTest类，内容以下

public class HomeControllerTest
    {
        [Fact]
        public void ShouldGetIndexResult()
        {
            var homeController = new HomeController();
            var contentResult = homeController.Index() as ContentResult;
            Assert.NotNull(contentResult);
            Assert.Equal("Hello test", contentResult.Content);
        }
    }

这里就建立了一个基本的测试用例，而后使用你熟悉的快捷键Ctrl+U+R(Reshaper)就能够将test愉快地运行起来了

 

完整代码请参考 https://github.com/shenba2014/AspDotNetCoreMvcExamples/tree/master/UseXunit