而直接运用上了xUnit.net,/VB.NET等开始展览单元测试

201六.陆.二七 微软已经正式发布了.NET Core 壹.0
奥迪Q五TM,可是工具链依旧预览版,同样的雅量的开源测试库也都是最少公布了Alpha测试版协助.NET
Core, 那篇小说 The State of .Net Core Testing
Today

就将依次开源测试库的近年来举办举办了汇总。本文我们的目标是在大家营造大家应用程序的时候能够实行测试,怎么着行使XUnit结合您能够通过为你的花色增加差别的测试用例NSubstitute实行单元测试,同时对总体项目进展合并测试。本次大家使用Visual
Studio 二零一五 Update 三实行编写 。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的功能
         伍)收缩了自定义属性(Attribute)的多寡
         陆)选择泛型
         柒)匿名委托
         捌)可扩充的预见
         玖)可扩充的测试方法
         10)可扩张的测试类

201陆.陆.二7 微软已经正式发表了.NET Core 壹.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和别的测试框架相比较有瞬间有的优势 
         一)为各种测试方法发生二个目的实例
         2)取消了[SetUp]和[TearDown]
         3)取消了[ExpectedException]
         4)类似于Aspect的功能
         5)收缩了自定义属性(Attribute)的多少
         陆)选择泛型
         7)匿名委托
         8)可扩充的断言
         玖)可增加的测试方法
         10)可扩大的测试类

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

        
了解越来越多关于xUnit.net可以参考那里(点击打开链接[舍弃Nunit拥抱Xunit])。

 

 

选取xUnit.net 单元测试

运用xUnit.net 单元测试

 

 

 

 

第二我们好像于.NET Core体系 :三、使用多少个连串
成立3个解决方案testdemo,添加八个类库项目名称叫DotnetCoreLib,Library.cs
也交替为:

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

}

图片 1

上面我们要开创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节点为 netcoreapp一.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,
修改Class一.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就知道了那是个测试方法,然后运转这么些主意。在3个测试方法中,大家壹般遵守包涵叁手续的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特性标识,每趟设定的值都不相同,在执行单元测试时,设定的值会被测试框架赋值到相应的测试方法的参数里。你能够经过为您的类型增加分化的测试用例,那样就足以让您的代码得到充裕测试。

 

 

 

第一我们好像于.NET Core类别 :三、使用八个项目
创造2个解决方案testdemo,添加2个类库项目名称为DotnetCoreLib,Library.cs
也交替为:

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

}

图片 3

下边大家要创制2个针对性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节点为 netcoreapp壹.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,
修改Class一.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]品质表示为三个主意的单个测试,[Theory]质量表示执行同1的代码,不过有例外的输入的参数的测试套件。[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的主意提供模拟功用,从而达到在不实际信赖其余模块的有血有肉作用的情事下完结本人模块的单元测试工作。那时大家平常须求有2个单元测试模拟类库,一向以来,开发者对
mocking 类库的语法的简洁性有让人惊叹标须要,NSubstitute
试图满意那一急需。不难明了的语法能够让我们将中央放在测试自身,而不是纠缠在测试替代实例的创造和配置上。NSubstitute
已尝试将最常用的操作须求不难化、易用化,并辅助部分不常用的或探索性的功用,与此同时还尽量地将其语法向自然语言靠近。关于NSubstitute的更详细音信请往
NSubstitute完全手册索引

 

NSubstitute 已经昭示二.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
等,但当大家只是想要二个能有早晚程度决定的替代实例时,为啥我们要麻烦于此呢?大家能够告诉被创立的代表实例,当方法被调用时回来3个值:

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

 

  
在1个支行结构清晰的项目里,各层之间依赖于事先约定好的接口。在四个人搭档开发时,大多数人都只会负责协调的那某个模块成效,开发进程常常状态下也不一致。当有个别开发职员需求对协调的模块举办单元测试而借助于的此外模块还并未有开发到位时,则必要对借助的接口通过Mock的方法提供模拟作用,从而达到在不实际依赖别的模块的有血有肉作用的地方下成功自己模块的单元测试工作。那时大家日常须要有1个单元测试模拟类库,向来以来,开发者对
mocking 类库的语法的简洁性有肯定的必要,NSubstitute
试图知足那1必要。简单明了的语法能够让我们将主导放在测试本人,而不是纠缠在测试替代实例的创始和安插上。NSubstitute
已尝试将最常用的操作供给不难化、易用化,并协理部分不常用的或探索性的成效,与此同时还尽量地将其语法向自然语言靠近。关于NSubstitute的更详细消息请往
NSubstitute完全手册索引

 

NSubstitute 已经昭示二.0 LX570C版本协助.NET Core。引进NSubstitute
相关nuget包:

图片 7

笔者们把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
就能够看来结果了,扩大了地点的1个用例,关于NSubstitute的更详细音讯请往
NSubstitute完全手册索引

图片 8

 

合龙测试

下面我们只是对逻辑进行了单元测试。对于Asp.Net
Core项目,还索要效法在网址铺排的意况下对一一请求入口进行测试。NET Core
可为急速轻松集成测试提供越发棒的帮忙。

TestServer 类为 ASP.NET Core
中的集成测试执行超越11分之6000斤操作,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窗口实行单元测试,查看测试结果

图片 9

合并测试

地点大家只是对逻辑进行了单元测试。对于Asp.Net
Core项目,还须要效法在网址铺排的景观下对11请求入口举办测试。NET Core
可为飞速轻松集成测试提供丰盛棒的支撑。

TestServer 类为 ASP.NET Core
中的集成测试执行超越1/三艰难操作,Microsoft.AspNetCore.TestHost
包中享有此类。本节内容出自于MSDN杂志《 ASP.NET Core – 实际的 ASP.NET
Core MVC
筛选器
》,这个合并测试不必要数据库或
Internet 连接或运转的 Web
服务器。它们犹如单元测试一样赶快不难,但最根本的是,它们允许你在1切请求管道中测试
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

相关文章