/VB.NET等进行单元测试,而平昔利用上了xUnit.net

二〇一四.6.27 微软现已正式发布了.NET Core 1.0
帕杰罗TM,可是工具链依然预览版,同样的大气的开源测试库也都以最少发布了Alpha测试版援助.NET
Core, 这篇小说 The State of .Net Core Testing
Today

就将顺序开源测试库的当下展开实行了集中。本文我们的指标是在咱们营造大家应用程序的时候能够进行测试,怎样利用XUnit结合你能够因而为您的门类增加不一样的测试用例NSubstitute进行单元测试,同时对全部项目进行集成测试。这一次我们接纳Visual
Studio 二〇一六 Update 3实行编写 。xUnit.net是基于.NET Framework
的开源测试工具。通过xUnit.net能够针对C#/F#/VB.NET等展开单元测试。ASP.NET
Core 更直白把过去的Visual Studio Unit Test Framework
说再见了,而直接利用上了xUnit.net,xUnit.net基于NUnit
。从网站依旧官网上,你能够找到不少xUnit的长处,与NUnit和此外测试框架比较有瞬间有的优势 
         1)为各种测试方法发生贰个指标实例
         2)取消了[SetUp]和[TearDown]
         3)取消了[ExpectedException]
         4)类似于Aspect的功能
         5)减弱了自定义属性(Attribute)的数目
         6)选拔泛型
         7)匿名委托
         8)可扩展的预知
         9)可扩大的测试方法
         10)可扩充的测试类

2015.6.27 微软曾经正式通知了.NET Core 1.0
TiggoTM,可是工具链照旧预览版,同样的汪洋的开源测试库也都以至少公布了Alpha测试版帮衬.NET
Core, 那篇小说 The State of .Net Core Testing
Today

就将种种开源测试库的近日举办举办了集中。本文大家的目标是在大家营造我们应用程序的时候能够实行测试,怎样行使XUnit结合你能够透过为您的品类增进不相同的测试用例NSubstitute进行单元测试,同时对全体项目进行合并测试。此次我们应用Visual
Studio 二零一六 Update 3实行编写 。xUnit.net是基于.NET Framework
的开源测试工具。通过xUnit.net能够针对C#/F#/VB.NET等举办单元测试。ASP.NET
Core 更间接把过去的Visual Studio Unit Test Framework
说再见了,而直白动用上了xUnit.net,xUnit.net基于NUnit
。从网站大概官网上,你能够找到不少xUnit的亮点,与NUnit和任何测试框架相比有瞬间片段优势 
         1)为每一个测试方法产生八个指标实例
         2)取消了[SetUp]和[TearDown]
         3)取消了[ExpectedException]
         4)类似于Aspect的功能
         5)裁减了自定义属性(Attribute)的多寡
         6)选拔泛型
         7)匿名委托
         8)可扩张的断言
         9)可扩充的测试方法
         10)可扩张的测试类

        
领会更加多关于xUnit.net能够参考那里(点击打开链接[舍弃Nunit拥抱Xunit])。

        
精通更多关于xUnit.net能够参见那里(点击打开链接[舍弃Nunit拥抱Xunit])。

 

 

利用xUnit.net 单元测试

运用xUnit.net 单元测试

 

 

 

 

第3大家好像于.NET Core连串 :叁 、使用多个类别
创设三个消除方案testdemo,添加3个类库项目名为DotnetCoreLib,Library.cs
也交替为:

namespace DotnetCoreLib
{
    public class Calculator
    {
        public int Multi(int x, int y)
        {
            return x * y;
        }
    }

}

图片 1

上边我们要开创三个针对DotnetCoreLib的测试项目,具体创制进程大家参照作品
https://github.com/dotnet/core-docs/tree/master/samples/core/getting-started/unit-testing-using-dotnet-test
,大家修改DotnetCoreLibTest 项目标project.json
,扩充XUnit相关的nuget包引用,并修改部分安插。

 

图片 2 

再有我们设置Framework节点为 netcoreapp1.0, 重视的xunit
和xunit.runner的包

“dependencies”: {
    “dotnet-test-xunit”: “2.2.0-preview2-build1029”,
    “DotnetCoreLib”: {
      “version”: “1.0.0-*”,
      “target”: “project”
    },
    “xunit”: “2.2.0-beta2-build3300”,
    “xunit.runner.console”: “2.2.0-beta2-build3300”
  }

 

Calculator接下去就从头测试我们的类库Calculator,
修改Class1.cs为CalculatorTest.cs ,

 

using DotnetCoreLib;
using Xunit;

 

namespace DotnetCoreLibTest
{
    public class CalTest
    {
        private readonly Calculator calculator;

        public CalTest()
        {
            calculator = new Calculator();
        }

 

        [Fact]
        public void OneMutiOneIsOne()
        {
            var result = calculator.Multi(1, 1);
            Assert.Equal(1, result);
        }

 

        [Theory]
        [InlineData(-1)]
        [InlineData(0)]
        [InlineData(1)]
        public void ReturnValue(int value)
        {
            var result = calculator.Multi(1,value);

            Assert.Equal(result, value);
        }
    }
}

 

上边包车型大巴多个测试,大家独家用了二个特点[Fact] 和[Theory],
[Fact]品质表示为一个格局的单个测试,[Theory]品质表示执行同样的代码,可是有例外的输入的参数的测试套件。[InlineData]
属性可用以钦赐为这么些输入值。通过特征[Fact]
和[Theory],xUnit就清楚了那是个测试方法,然后运营这些艺术。在一个测试方法中,我们一般服从包括三手续的AAA模式:

  1. Arrange:为测试准备
  2. Act:运营SUT(实际测试的代码)
  3. Assert:校验结果

下边大家运行dotnet test 就能够见见结果了。

C:\Users\geffz\Documents\Visual Studio
2015\Projects\TestDemo\DotnetCoreLibTest>dotnet test
Project DotnetCoreLib (.NETCoreApp,Version=v1.0) was previously
compiled. Skipping compilation.
Project DotnetCoreLibTest (.NETCoreApp,Version=v1.0) was previously
compiled. Skipping compilation.
xUnit.net .NET CLI test runner (64-bit .NET Core win10-x64)
  Discovering: DotnetCoreLibTest
  Discovered:  DotnetCoreLibTest
  Starting:    DotnetCoreLibTest
  Finished:    DotnetCoreLibTest
=== TEST EXECUTION SUMMARY ===
   DotnetCoreLibTest  Total: 4, Errors: 0, Failed: 0, Skipped: 0, Time:
0.206s
SUMMARY: Total: 1 targets, Passed: 1, Failed: 0.

 

上边包车型地铁输出大家知晓已经实施了多个测试,都因而了,[Face]特点标识表示固定输入的测试用例,而[Theory]特色标识表示能够钦定多少个输入的测试用例,结合InlineData天性标识应用。在地点的例证里,总共使用了2回InlineData特性标识,每趟设定的值都不及,在实施单元测试时,设定的值会被测试框架赋值到对应的测试方法的参数里。你能够通过为您的门类增加差别的测试用例,这样就能够让你的代码获得丰富测试。

 

 

 

第三大家好像于.NET Core连串 :③ 、使用多少个品类
创立3个化解方案testdemo,添加多少个类库项目名为DotnetCoreLib,Library.cs
也交替为:

namespace DotnetCoreLib
{
    public class Calculator
    {
        public int Multi(int x, int y)
        {
            return x * y;
        }
    }

}

图片 3

上面大家要成立三个针对性DotnetCoreLib的测试项目,具体创造进度大家参照文章
https://github.com/dotnet/core-docs/tree/master/samples/core/getting-started/unit-testing-using-dotnet-test
,大家修改DotnetCoreLibTest 项目标project.json
,扩展XUnit相关的nuget包引用,并修改部分安插。

 

图片 4 

再有我们设置Framework节点为 netcoreapp1.0, 正视的xunit
和xunit.runner的包

“dependencies”: {
    “dotnet-test-xunit”: “2.2.0-preview2-build1029”,
    “DotnetCoreLib”: {
      “version”: “1.0.0-*”,
      “target”: “project”
    },
    “xunit”: “2.2.0-beta2-build3300”,
    “xunit.runner.console”: “2.2.0-beta2-build3300”
  }

 

Calculator接下去就从头测试大家的类库Calculator,
修改Class1.cs为CalculatorTest.cs ,

 

using DotnetCoreLib;
using Xunit;

 

namespace DotnetCoreLibTest
{
    public class CalTest
    {
        private readonly Calculator calculator;

        public CalTest()
        {
            calculator = new Calculator();
        }

 

        [Fact]
        public void OneMutiOneIsOne()
        {
            var result = calculator.Multi(1, 1);
            Assert.Equal(1, result);
        }

 

        [Theory]
        [InlineData(-1)]
        [InlineData(0)]
        [InlineData(1)]
        public void ReturnValue(int value)
        {
            var result = calculator.Multi(1,value);

            Assert.Equal(result, value);
        }
    }
}

 

下边包车型客车八个测试,大家分别用了3个特色[Fact] 和[Theory],
[Fact]质量表示为1个格局的单个测试,[Theory]质量表示执行同样的代码,不过有不一样的输入的参数的测试套件。[InlineData]
属性可用于内定为那么些输入值。通过特色[Fact]
和[Theory],xUnit就理解了这是个测试方法,然后运转那些艺术。在2个测试方法中,大家一般服从包罗三步骤的AAA模式:

  1. Arrange:为测试准备
  2. Act:运转SUT(实际测试的代码)
  3. Assert:校验结果

下边我们运营dotnet test 就足以看出结果了。

C:\Users\geffz\Documents\Visual Studio
2015\Projects\TestDemo\DotnetCoreLibTest>dotnet test
Project DotnetCoreLib (.NETCoreApp,Version=v1.0) was previously
compiled. Skipping compilation.
Project DotnetCoreLibTest (.NETCoreApp,Version=v1.0) was previously
compiled. Skipping compilation.
xUnit.net .NET CLI test runner (64-bit .NET Core win10-x64)
  Discovering: DotnetCoreLibTest
  Discovered:  DotnetCoreLibTest
  Starting:    DotnetCoreLibTest
  Finished:    DotnetCoreLibTest
=== TEST EXECUTION SUMMARY ===
   DotnetCoreLibTest  Total: 4, Errors: 0, Failed: 0, Skipped: 0, Time:
0.206s
SUMMARY: Total: 1 targets, Passed: 1, Failed: 0.

 

地点的出口大家通晓已经进行了五个测试,都经过了,[Face]特色标识表示一定输入的测试用例,而[Theory]特征标识表示能够钦定八个输入的测试用例,结合InlineData特性标识应用。在上头的例子里,总共使用了一遍InlineData天性标识,每一遍设定的值都不可同日而语,在实行单元测试时,设定的值会被测试框架赋值到对应的测试方法的参数里。你可以透过为你的项目拉长不相同的测试用例,那样就足以让您的代码获得丰裕测试。

 

xUnit.net 搭配NSubstitute 实行单元测试

 

  
在八个分支结构清晰的门类里,各层之间正视于事先约定好的接口。在三个人搭档开发时,超越二分一人都只会负责协调的那部分模块作用,开发进程经常状态下也不均等。当某些开发人士供给对协调的模块举行单元测试而借助于的别的模块还未曾支付到位时,则须求对借助的接口通过Mock的法子提供模拟作用,从而达到在不实际重视其余模块的有血有肉功能的气象下完了自身模块的单元测试工作。那时大家常见供给有一个单元测试模拟类库,一直以来,开发者对
mocking 类库的语法的简洁性有可想而知的要求,NSubstitute
试图满足这一要求。简单明了的语法能够让我们将主体放在测试本身,而不是纠缠在测试替代实例的创造和布局上。NSubstitute
已尝试将最常用的操作需要不难化、易用化,并帮助部分不常用的或探索性的机能,与此同时还尽量地将其语法向自然语言靠近。关于NSubstitute的更详细消息请往
NSubstitute完全手册索引

 

NSubstitute 已经宣告2.0 昂科雷C版本扶助.NET Core。引入NSubstitute
相关nuget包:

图片 5

大家把Calculator 类重构下提取出接口ICalculator:

    public interface ICalculator
    {
        int Multi(int x, int y);
    }

 

我们能够让NSubstitute来成立项目实例的替代实例,能够创造诸如
Stub、Mock、Fake、Spy、Test Double
等,但当大家只是想要二个能有一定水准决定的替代实例时,为啥大家要麻烦于此呢?我们得以告知被创设的替代实例,当方法被调用时重临贰个值:

     [Fact]
      public void Test_GetStarted_ReturnSpecifiedValue()
      {
          ICalculator calculator =
Substitute.For<ICalculator>();
          calculator.Multi(1, 2).Returns(2);

          int actual = calculator.Multi(1, 2);
          Assert.Equal(2, actual);
      }

上边我们运营dotnet test
就足以看出结果了,扩展了下边包车型地铁3个用例,关于NSubstitute的更详细消息请往
NSubstitute完全手册索引

图片 6

 

xUnit.net 搭配NSubstitute 实行单元测试

 

  
在贰个支行结构清晰的花色里,各层之间注重于事先约定好的接口。在五人搭档开发时,超越四分之二个人都只会负责协调的那部分模块成效,开发进程平时状态下也不雷同。当有个别开发职员须求对团结的模块实行单元测试而借助于的别的模块还从未开发形成时,则必要对看重的接口通过Mock的法子提供模拟作用,从而达成在不实际注重其余模块的切切实实际效果果的情状下成功本身模块的单元测试工作。那时我们一般供给有1个单元测试模拟类库,一向以来,开发者对
mocking 类库的语法的简洁性有强烈的要求,NSubstitute
试图满意这一急需。简单明了的语法可以让我们将主导放在测试本人,而不是纠缠在测试替代实例的成立和安顿上。NSubstitute
已尝试将最常用的操作要求简单化、易用化,并帮衬部分不常用的或探索性的机能,与此同时还尽量地将其语法向自然语言靠近。关于NSubstitute的更详细新闻请往
NSubstitute完全手册索引

 

NSubstitute 已经揭露2.0 OdysseyC版本帮忙.NET Core。引入NSubstitute
相关nuget包:

图片 7

大家把Calculator 类重构下提取出接口ICalculator:

    public interface ICalculator
    {
        int Multi(int x, int y);
    }

 

我们得以让NSubstitute来创设项目实例的代表实例,能够创建诸如
Stub、Mock、Fake、Spy、Test Double
等,但当大家只是想要2个能有自然水准决定的替代实例时,为何大家要麻烦于此呢?大家能够告诉被成立的替代实例,当方法被调用时再次回到1个值:

     [Fact]
      public void Test_GetStarted_ReturnSpecifiedValue()
      {
          ICalculator calculator =
Substitute.For<ICalculator>();
          calculator.Multi(1, 2).Returns(2);

          int actual = calculator.Multi(1, 2);
          Assert.Equal(2, actual);
      }

下边咱们运转dotnet test
就足以看来结果了,扩展了上边的3个用例,关于NSubstitute的更详细消息请往
NSubstitute完全手册索引

图片 8

 

合并测试

地方大家只是对逻辑进行了单元测试。对于Asp.Net
Core项目,还索要效法在网站铺排的情状下对一一请求入口举行测试。NET Core
可为快捷轻松集成测试提供尤其棒的支持。

TestServer 类为 ASP.NET Core
中的集成测试执行半数以上千斤操作,Microsoft.AspNetCore.TestHost
包中有着此类。本节内容来自于MSDN杂志《 ASP.NET Core – 实际的 ASP.NET
Core MVC
筛选器
》,这几个合并测试不要求数据库或
Internet 连接或运维的 Web
服务器。它们犹如单元测试一样飞快简单,但最重点的是,它们允许你在全方位请求管道中测试
ASP.NET
应用,而不只是决定器类中的孤立方法。提出尽量编写单元测试,并针对性不可能单元测试的行为退回到集成测试,但利用此类高品质情势在
ASP.NET Core 中运营集成测试是尤其棒的。

 

通过在3个工程里还要效仿了服务端(TestServer)和客户端(HttpClient)的通信,从而达到了总体育项目测验试WebApi接口的指标,相关的代码放在https://github.com/ardalis/GettingStartedWithFilters/tree/master/IntegrationTests
。文章对ASP.NET CORE
MVC的筛选器进行测试,由于很难通过编写制定单元测试来测试此类现象,不过能够由此ASP.NET
Core 的并轨测试来达成平等的指标。

using System.IO;
using System.Net.Http;
using System.Net.Http.Headers;
using Filters101;
using Microsoft.AspNetCore.Hosting;
using Microsoft.AspNetCore.TestHost;

 

namespace IntegrationTests
{
    public class AuthorsControllerTestBase
    {
        protected HttpClient GetClient()
        {
            var builder = new WebHostBuilder()
                .UseContentRoot(Directory.GetCurrentDirectory())
                .UseStartup<Startup>()
                .UseEnvironment(“Testing”);
            var server = new TestServer(builder);
            var client = server.CreateClient();

            // client always expects json results
            client.DefaultRequestHeaders.Clear();
            client.DefaultRequestHeaders.Accept.Add(
                new
MediaTypeWithQualityHeaderValue(“application/json”));

            return client;
        }
    }
}

 

 

using System.Collections.Generic;
using System.Linq;
using System.Net.Http;
using System.Threading.Tasks;
using Filters101.Models;
using Newtonsoft.Json;
using Xunit;

namespace IntegrationTests.AuthorsController
{
    public class Get : AuthorsControllerTestBase
    {
        private readonly HttpClient _client;

        public Get()
        {
            _client = base.GetClient();
        }

        [Theory]
        [InlineData(“authors”)]
        [InlineData(“authors2”)]
        public async Task ReturnsListOfAuthors(string controllerName)
        {
            var response = await
_client.GetAsync($”/api/{controllerName}”);
            response.EnsureSuccessStatusCode();
            var stringResponse = await
response.Content.ReadAsStringAsync();
            var result =
JsonConvert.DeserializeObject<IEnumerable<Author>>(stringResponse).ToList();

            Assert.Equal(2, result.Count());
            Assert.Equal(1, result.Count(a => a.FullName == “Steve
Smith”));
            Assert.Equal(1, result.Count(a => a.FullName == “Neil
Gaiman”));
        }
    }
}

该案例中的客户端是行业内部的
System.Net.Http.HttpClient,你能够利用它向服务器发出请求,正就像通过网络同样。但因为有着请求都在内部存款和储蓄器中开始展览,所以测试最佳便捷可信赖。在cmd窗口进行单元测试,查看测试结果

图片 9

集成测试

地方大家只是对逻辑进行了单元测试。对于Asp.Net
Core项目,还亟需效法在网站铺排的景况下对各类请求入口实行测试。NET Core
可为急迅轻松集成测试提供丰硕棒的支撑。

TestServer 类为 ASP.NET Core
中的集成测试执行超过55%劳顿操作,Microsoft.AspNetCore.TestHost
包中拥有此类。本节内容出自于MSDN杂志《 ASP.NET Core – 实际的 ASP.NET
Core MVC
筛选器
》,那几个合并测试不需求数据库或
Internet 连接或运维的 Web
服务器。它们犹如单元测试一样便捷不难,但最首要的是,它们允许你在全方位请求管道中测试
ASP.NET
应用,而不只是决定器类中的孤立方法。提出尽量编写单元测试,并针对性不恐怕单元测试的行为退回到集成测试,但利用此类高品质格局在
ASP.NET Core 中运作集成测试是尤其棒的。

 

通过在多少个工程里还要效仿了服务端(TestServer)和客户端(HttpClient)的通讯,从而达到了总体育项目测验试WebApi接口的目标,相关的代码放在https://github.com/ardalis/GettingStartedWithFilters/tree/master/IntegrationTests
。文章对ASP.NET CORE
MVC的筛选器举办测试,由于很难通过编写制定单元测试来测试此类现象,不过能够透过ASP.NET
Core 的合一测试来达成同等的目标。

using System.IO;
using System.Net.Http;
using System.Net.Http.Headers;
using Filters101;
using Microsoft.AspNetCore.Hosting;
using Microsoft.AspNetCore.TestHost;

 

namespace IntegrationTests
{
    public class AuthorsControllerTestBase
    {
        protected HttpClient GetClient()
        {
            var builder = new WebHostBuilder()
                .UseContentRoot(Directory.GetCurrentDirectory())
                .UseStartup<Startup>()
                .UseEnvironment(“Testing”);
            var server = new TestServer(builder);
            var client = server.CreateClient();

            // client always expects json results
            client.DefaultRequestHeaders.Clear();
            client.DefaultRequestHeaders.Accept.Add(
                new
MediaTypeWithQualityHeaderValue(“application/json”));

            return client;
        }
    }
}

 

 

using System.Collections.Generic;
using System.Linq;
using System.Net.Http;
using System.Threading.Tasks;
using Filters101.Models;
using Newtonsoft.Json;
using Xunit;

namespace IntegrationTests.AuthorsController
{
    public class Get : AuthorsControllerTestBase
    {
        private readonly HttpClient _client;

        public Get()
        {
            _client = base.GetClient();
        }

        [Theory]
        [InlineData(“authors”)]
        [InlineData(“authors2”)]
        public async Task ReturnsListOfAuthors(string controllerName)
        {
            var response = await
_client.GetAsync($”/api/{controllerName}”);
            response.EnsureSuccessStatusCode();
            var stringResponse = await
response.Content.ReadAsStringAsync();
            var result =
JsonConvert.DeserializeObject<IEnumerable<Author>>(stringResponse).ToList();

            Assert.Equal(2, result.Count());
            Assert.Equal(1, result.Count(a => a.FullName == “Steve
Smith”));
            Assert.Equal(1, result.Count(a => a.FullName == “Neil
Gaiman”));
        }
    }
}

该案例中的客户端是规范的
System.Net.Http.HttpClient,你能够动用它向服务器发出请求,正就如通过网络同样。但因为有着请求都在内部存款和储蓄器中开始展览,所以测试最佳便捷可信赖。在cmd窗口进行单元测试,查看测试结果

图片 10

相关文章