使用xunit对asp.net core webapi进行集成测试

新项目我们采用前后端分离，后端采用asp.net core webapi, 如何对后端代码进行自动化测试呢，有以下几种方案：

1. 单元测试，目前这个方案对我们来说难度很大，抛开时间的问题，单元测试对开发人员的水平要求很高，暂且不提。

2. 使用postman等第三方工具，模拟http请求对webapi进行测试。缺点就是webapi必须跑起来，不能像单元测试一样，点一个按扭就可以跑测试。

3. 使用xunit等单元测试工具对webapi进行测试，为了解决postmam问题，我们使用xunit对webapi进行类单元测试。

使用xunit等单元测试工具对webapi进行测试的主要思路：

1. 使用代码启动webapi项目，就像program.cs中代码一样

2. 借助http工具类库对webapi发送http请求，这里我们使用RestSharp，详见官网：http://restsharp.org/。

3. 接收返回值，进行断言判断，我们使用的Shouldly框架。

下面是具体的代码：

首先创建测试项目，这是visual studio 2017自带的xunit的测试项目，足可以看到ms的诚意了。

然后我们创建一个类，用于启动webapi:

public class ApiServerRunning : IDisposable

    {

        private IWebHost _builder;

        public void Dispose()

        {

            _builder?.Dispose();

        }

        public void GivenRunningOn(string url)

        {

            _builder = new WebHostBuilder()

                   .UseUrls(url)

                   .UseKestrel()

                   .UseContentRoot(Directory.GetCurrentDirectory())

                   .UseStartup<Startup>()

                   .Build();

            _builder.Start();

        }

    }

然后我们就碰到一个问题，什么时候启动webapi,不是每个单元测试都要启动一次，不是运行每个类都启动一次，而是整个测试项目只运行一个，这里就用到了xunit的ICollectionFixture，

想具体了解的话，请自行百度。这里就直接上代码了：

/// <summary>

    /// used to startup weiapi, run only once

    /// </summary>

    public class TestFixture : IDisposable

    {

        public ApiServerRunning _server = new ApiServerRunning();

        public TestFixture()

        {

            this.Given(s => _server.GivenRunningOn(TestConst.SERVER_URL))

                .Then(x => x.Connect())

                .BDDfy();

        }

        private void Connect()

        {

            Console.WriteLine("webapi startup successfully!!! ");

        }

        public void Dispose()

        {

        }

    }

    /// <summary>

    /// used to tag every class using test fixture

    /// </summary>

    [CollectionDefinition("TestCollection")]

    public class TestCollection:ICollectionFixture<TestFixture>

    {

    }

有了以上两个类，我们接下来就可以写单元测试了：

[Collection("TestCollection")]

    public class TaskControllerTest : TestBase

    {

        [Fact(DisplayName = "获取列表")]

        private void GetOpinionTaskHospitals_Test()

        {

            var req = agent.CreateRequest("GetTasks")

                .AddParameter("month", "2015-07-01")

                .AddHeader(FmConsts.HeaderName_UserInfo, TestConst.USER_INFO);

            var rel = agent.Execute<<List<Task>>>(req);

            rel.Result.Count.ShouldNotBe();

        }

    }

每个类都发送请求，所以这里有个TestBase的基类，里面有一个agent的http的对象，是我们封闭了restsharp的http请求对象，这里就不贴了。

还有如果没有登录，所有如果想使用登录的cookie，这里我是直接添加了一个头信息，相当于一个登录，但是这里肯定有问题可能会过期，当然办法总比困难多。

还有一个难点，就是这里的测试，还是用的我们的开发数据库，这个测试会污染数据，由于开发数据的变量，也会影响测试结果，如果替换开发数据库oracle为内存数据为库，而且代码变动也很少，是我们接下来的工作。请经验的同学，请指教。

巴特西

使用xunit对asp.net core webapi进行集成测试

最新文章

热门文章