asp.net core 使用 TestServer 来做集成测试的方法

Intro

之前我的项目里的集成测试是随机一个端口，每次都真实的启动一个 WebServer，之前也有看到过微软文档上

TestServer

的介绍，当时没仔细看过以为差不多就没用，一直是启动了一个真正的 WebServer 去跑集成测试的，上次分享

Xunit.DependencyInjection

改造测试项目的时候，写的烂代码被大师看到了之后， 大师建议用

TestServer

来做集成测试，使用

TestServer

不会真正的占用端口号，不会出现权限问题，于是扒了扒 TestServer 的源码，并用

TestServer

改进了集成测试项目，感谢大师[献花鲜花]~~

Sample

之前的集成测试监听了一个端口号，使用了一个真实的 WebServer，下面改成使用

TestServer

TestServer

现在是在

Microsoft.AspNetCore.TestHost

这个 Nuget 包中，引用这个包就可以使用了

在服务注册的时候调用

UseTestServer

这一扩展方法就可以注入

TestServer

了，集成测试一般会用

HttpClient

来请求服务器端的 API 地址或页面，

TestServer

提供了一个方便的

CreateClient

的方法可以很方便的创建一个用来请求

TestServer

的

HttpClient

，微软也提供了一些比较方便的扩展方法，可以使用

IHost

的

GetTestClient

扩展方法来获取

HttpClient

改成使用

TestServer

很简单，引用 nuget 包

Microsoft.AspNetCore.TestHost

，变更对比如下：

源码概览

TestServer 在启动的时候并没有监听端口，可以参考源码

IServer

的

Start

TestServer 通过

CreateClient

方法来创建调用 TestServer 接口的 HttpClient

通过上面的代码可以看的出来核心代码是在

ClientHandler

中定义的，源码有点多，详细可以直接看源码 https://github.com/dotnet/aspnetcore/blob/v5.0.0/class="lazy" data-src/Hosting/TestHost/class="lazy" data-src/ClientHandler.cs

ClientHandler

重写了 HttpClientHandler 的

SendAsync

方法，使得请求直接拦截掉，不会真正的发生 Http 请求，实际的请求过程首先将 Http 请求的信息转换成 HttpRquestFeature 然后直接交给 TestServer 处理，其实也就是直接交给 asp.net core 的请求管道去处理，请求处理结束之后，获取 HttpContext 响应，获取 HttpResponseFeature 然后转换成 HttpClient 需要的 HttpResponseMessage.

More

TestServer

不仅仅可以支持 HTTP 请求的处理，还支持 WebSocket 的处理，WebSocket 的集成测试也可以使用

TestServer

来处理。

你如果还是比较怀疑是否真的没有 HTTP 请求，可以用 Fildder 之类的 HTTP 抓包工具监控在跑测试的期间是否真的有 HTTP 请求，如果是真正的 WebServer 会有 HTTP 请求，TestServer 不会有 HTTP 请求。

https://docs.microsoft.com/en-us/aspnet/core/test/integration-tests?view=aspnetcore-5.0
https://github.com/dotnet/aspnetcore/tree/v5.0.0/class="lazy" data-src/Hosting/TestHost/class="lazy" data-src
https://github.com/dotnet/aspnetcore/tree/v5.0.0/class="lazy" data-src/Hosting/TestHost/class="lazy" data-src/TestServer.cs
https://github.com/dotnet/aspnetcore/blob/v5.0.0/class="lazy" data-src/Hosting/TestHost/class="lazy" data-src/ClientHandler.cs#L58
https://github.com/OpenReservation/ReservationServer/blob/3.1.0/OpenReservation.API.Test/Startup.cs#L26
https://github.com/OpenReservation/ReservationServer/commit/e683065bf76e3c51688238c382b2c1f0c8028e7d

到此这篇关于asp.net core 使用 TestServer 来做集成测试的文章就介绍到这了,更多相关asp.net core 集成测试内容请搜索编程网以前的文章或继续浏览下面的相关文章希望大家以后多多支持编程网！

您可能感兴趣的文章:Asp.Net Core利用xUnit进行主机级别的网络集成测试详解