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进行单元测试。

xunit.net介绍

xunit.net的创造者的创造者是jim newkirk和brad wilson从包括nunit及其它单元测试框架的使用经验中总结出来的一个新框架，相比于nunit，xunit.net有如下特点：

1. 为每个测试方法产生一个对象实例
2. 取消了[setup]和[teardown]
3. 取消了[expectedexception]
4. 类似于aspect的功能
5. 减少了自定义属性（attribute）的数目
6. 采用泛型
7. 匿名委托
8. 可扩展的断言
9. 可扩展的测试方法
10. 可扩展的测试类

xunit.net的官方网站是：http://xunit.codeplex.com，下面是xunit.net的运行界面：

注意在下载的xunit.net压缩包内有4个支持gui方式运行的exe文件，分别是：

1. xunit.gui.clr4.exe：用于在x64及.net4.0下运行xunit.net。
2. xunit.gui.clr4.x86.exe：用于在x86及.net4.0下运行xunit.net。
3. xunit.gui.exe：用于在x64及.net4.0以下版本运行xunit.net。
4. xunit.gui.x86.exe：用于在x86及.net4.0以下版本运行xunit.net。

准备项目代码：

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

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持。