欧美bbbwbbbw肥妇,免费乱码人妻系列日韩,一级黄片

Asp.Net Core利用xUnit進行主機級別的網(wǎng)絡集成測試詳解

 更新時間:2018年12月11日 10:24:44   作者:Ron.liang  
這篇文章主要給大家介紹了關于Asp.Net Core利用xUnit進行主機級別的網(wǎng)絡集成測試的相關資料,文中通過示例代碼介紹的非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友們來一起看看吧

前言

在開發(fā) Asp.Net Core 應用程序的過程中,我們常常需要對業(yè)務代碼編寫單元測試,這種方法既快速又有效,利用單元測試做代碼覆蓋測試,也是非常必要的事情;但是,但我們需要對系統(tǒng)進行集成測試的時候,需要啟動服務主機,利用瀏覽器或者Postman 等網(wǎng)絡工具對接口進行集成測試,這就非常的不方便,同時浪費了大量的時間在重復啟動應用程序上;今天要介紹就是如何在不啟動應用程序的情況下,對 Asp.Net Core WebApi 項目進行網(wǎng)絡集成測試。

一、建立項目

1.1 首先我們建立兩個項目,Asp.Net Core WebApi 和 xUnit 單元測試項目,如下

1.2 上圖的單元測試項目 Ron.XUnitTest 必須應用待測試的 WebApi 項目 Ron.TestDemo

1.3 接下來打開 Ron.XUnitTest 項目文件 .csproj,添加包引用

Microsoft.AspNetCore.App
Microsoft.AspNetCore.TestHost

1.4 為什么要引用這兩個包呢,因為我剛才創(chuàng)建的 WebApi 項目是引用 Microsoft.AspNetCore.App 的,至于 Microsoft.AspNetCore.TestHost,它是今天的主角,為了使用測試主機,必須對其進行引用,下面會詳細說明

二、編寫業(yè)務

2.1 創(chuàng)建一個接口,代碼如下

 [Route("api/[controller]")]
 [ApiController]
 public class ValuesController : ControllerBase
 {
 private IConfiguration configuration;
 public ValuesController(IConfiguration configuration)
 {
  this.configuration = configuration;
 }

 [HttpGet("{id}")]
 public ActionResult<int> Get(int id)
 {
  var result= id + this.configuration.GetValue<int>("max");

  return result;
 }
 }

2.1 接口代碼非常簡單,接受一個參數(shù) id,然后和配置文件中獲取的值 max 相加,然后輸出結果給客戶端

三、編寫測試用例

3.1 為了能夠使用主機集成測試,我們需要使用類

Microsoft.AspNetCore.TestHost.TestServer

3.2 我們來看一下 TestServer 的源碼,代碼較長,你可以直接跳過此段,進入下一節(jié) 3.3

 public class TestServer : IServer
 {
 private IWebHost _hostInstance;
 private bool _disposed = false;
 private IHttpApplication<Context> _application;

 public TestServer(): this(new FeatureCollection())
 {
 }

 public TestServer(IFeatureCollection featureCollection)
 {
  Features = featureCollection ?? throw new ArgumentNullException(nameof(featureCollection));
 }

 public TestServer(IWebHostBuilder builder): this(builder, new FeatureCollection())
 {
 }
 
 public TestServer(IWebHostBuilder builder, IFeatureCollection featureCollection): this(featureCollection)
 {
  if (builder == null)
  {
  throw new ArgumentNullException(nameof(builder));
  }

  var host = builder.UseServer(this).Build();
  host.StartAsync().GetAwaiter().GetResult();
  _hostInstance = host;
 }

 public Uri BaseAddress { get; set; } = new Uri("http://localhost/");

 public IWebHost Host
 {
  get
  {
  return _hostInstance
   ?? throw new InvalidOperationException("The TestServer constructor was not called with a IWebHostBuilder so IWebHost is not available.");
  }
 }

 public IFeatureCollection Features { get; }

 private IHttpApplication<Context> Application
 {
  get => _application ?? throw new InvalidOperationException("The server has not been started or no web application was configured.");
 }

 public HttpMessageHandler CreateHandler()
 {
  var pathBase = BaseAddress == null ? PathString.Empty : PathString.FromUriComponent(BaseAddress);
  return new ClientHandler(pathBase, Application);
 }

 public HttpClient CreateClient()
 {
  return new HttpClient(CreateHandler()) { BaseAddress = BaseAddress };
 }

 public WebSocketClient CreateWebSocketClient()
 {
  var pathBase = BaseAddress == null ? PathString.Empty : PathString.FromUriComponent(BaseAddress);
  return new WebSocketClient(pathBase, Application);
 }

 public RequestBuilder CreateRequest(string path)
 {
  return new RequestBuilder(this, path);
 }

 public async Task<HttpContext> SendAsync(Action<HttpContext> configureContext, CancellationToken cancellationToken = default)
 {
  if (configureContext == null)
  {
  throw new ArgumentNullException(nameof(configureContext));
  }

  var builder = new HttpContextBuilder(Application);
  builder.Configure(context =>
  {
  var request = context.Request;
  request.Scheme = BaseAddress.Scheme;
  request.Host = HostString.FromUriComponent(BaseAddress);
  if (BaseAddress.IsDefaultPort)
  {
   request.Host = new HostString(request.Host.Host);
  }
  var pathBase = PathString.FromUriComponent(BaseAddress);
  if (pathBase.HasValue && pathBase.Value.EndsWith("/"))
  {
   pathBase = new PathString(pathBase.Value.Substring(0, pathBase.Value.Length - 1));
  }
  request.PathBase = pathBase;
  });
  builder.Configure(configureContext);
  return await builder.SendAsync(cancellationToken).ConfigureAwait(false);
 }

 public void Dispose()
 {
  if (!_disposed)
  {
  _disposed = true;
  _hostInstance.Dispose();
  }
 }

 Task IServer.StartAsync<TContext>(IHttpApplication<TContext> application, CancellationToken cancellationToken)
 {
  _application = new ApplicationWrapper<Context>((IHttpApplication<Context>)application, () =>
  {
  if (_disposed)
  {
   throw new ObjectDisposedException(GetType().FullName);
  }
  });

  return Task.CompletedTask;
 }

 Task IServer.StopAsync(CancellationToken cancellationToken)
 {
  return Task.CompletedTask;
 }

 private class ApplicationWrapper<TContext> : IHttpApplication<TContext>
 {
  private readonly IHttpApplication<TContext> _application;
  private readonly Action _preProcessRequestAsync;

  public ApplicationWrapper(IHttpApplication<TContext> application, Action preProcessRequestAsync)
  {
  _application = application;
  _preProcessRequestAsync = preProcessRequestAsync;
  }

  public TContext CreateContext(IFeatureCollection contextFeatures)
  {
  return _application.CreateContext(contextFeatures);
  }

  public void DisposeContext(TContext context, Exception exception)
  {
  _application.DisposeContext(context, exception);
  }

  public Task ProcessRequestAsync(TContext context)
  {
  _preProcessRequestAsync();
  return _application.ProcessRequestAsync(context);
  }
 }
 }

3.3 TestServer 類代碼量比較大,不過不要緊,我們只需要關注它的構造方法就可以了

 public TestServer(IWebHostBuilder builder)
  : this(builder, new FeatureCollection())
 {
 }

3.4 其構造方法接受一個 IWebHostBuilder 對象,只要我們傳入一個 WebHostBuilder 就可以創(chuàng)建一個測試主機了

3.5 創(chuàng)建測試主機和 HttpClient 客戶端,我們在測試類 ValuesUnitTest 編寫如下代碼

 public class ValuesUnitTest
 {
 private TestServer testServer;
 private HttpClient httpCLient;

 public ValuesUnitTest()
 {
  testServer = new TestServer(new WebHostBuilder().UseStartup<Ron.TestDemo.Startup>());
  httpCLient = testServer.CreateClient();
 }

 [Fact]
 public async void GetTest()
 {
  var data = await httpCLient.GetAsync("/api/values/100");
  var result = await data.Content.ReadAsStringAsync();

  Assert.Equal("300", result);
 }
 }

代碼解釋

這段代碼非常簡單,首先,我們聲明了一個 TestServer 和 HttpClient 對象,并在構造方法中初始化他們; TestServer 的初始化是由我們 new 了一個 Builder 對象,并指定其使用待測試項目 Ron.TestDemo 中的 Startup 類來啟動,這樣我們能可以直接使用待測試項目的路由和管道了,甚至我們無需指定測試站點,因為這些都會在 TestServer 自動配置一個 localhost 的主機地址

3.7 接下來就是創(chuàng)建了一個單元測試的方法,直接使用剛才初始化的 HttpClient 對象進行網(wǎng)絡請求,這個時候,我們只需要知道 Action 即可,同時傳遞參數(shù) 100,最后斷言服務器輸出值為:"300",回顧一下我們創(chuàng)建的待測試方法,其業(yè)務正是將客戶端傳入的 id 值和配置文件 max 值相加后輸出,而 max 值在這里被配置為 200

3.8 運行單元測試

3.9 測試通過,可以看到,測試達到了預期的結果,服務器正確返回了計算后的值

四、配置文件注意事項

4.1 在待測試項目中的配置文件 appsettings.json 并不會被測試主機所讀取,因為我們在上面創(chuàng)建測試主機的時候沒有調用方法

WebHost.CreateDefaultBuilder

4.2 我們只是創(chuàng)建了一個 WebHostBuilder 對象,非常輕量的主機配置,簡單來說就是無配置,如果對于 WebHost.CreateDefaultBuilder 不理解的同學,建議閱讀我的文章 asp.netcore 深入了解配置文件加載過程.

4.3 所以,為了能夠在單元測試中使用項目配置文件,我在 Ron.TestDemo 項目中的 Startup 類加入了下面的代碼

 public class Startup
 {
 public Startup(IConfiguration configuration, IHostingEnvironment env)
 {
  this.Configuration = new ConfigurationBuilder()
  .AddJsonFile("appsettings.json")
  .AddEnvironmentVariables()
  .SetBasePath(env.ContentRootPath)
  .Build();
 }

 public IConfiguration Configuration { get; }

 // This method gets called by the runtime. Use this method to add services to the container.
 public void ConfigureServices(IServiceCollection services)
 {
  services.AddSingleton<IConfiguration>(this.Configuration);
  services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_2);
 }
 }

4.4 其目的就是手動讀取配置文件,重新初始化 IConfiguration 對象,并將 this.Configuration 對象加入依賴注入容器中

結語

  • 本文從單元測試入手,針對常見的系統(tǒng)集成測試提供了另外一種便捷的測試方案,通過創(chuàng)建 TestServer 測試主機開始,利用主機創(chuàng)建 HttpCLient 對象進行網(wǎng)絡集成測試
  • 減少重復啟動程序和測試工具,提高了測試效率
  • 充分利用了 Visual Studio 的優(yōu)勢,既可以做單元測試,還能利用這種測試方案進行快速代碼調試
  • 最后,還了解如何通過 TestServer 主機加載待測試項目的配置文件對象 IConfiguration

示例代碼下載

http://xiazai.jb51.net/201812/yuanma/Ron.TestDemo_jb51.rar

總結

以上就是這篇文章的全部內容了,希望本文的內容對大家的學習或者工作具有一定的參考學習價值,如果有疑問大家可以留言交流,謝謝大家對腳本之家的支持。

相關文章

  • 使用HttpClient增刪改查ASP.NET Web API服務

    使用HttpClient增刪改查ASP.NET Web API服務

    這篇文章介紹了使用HttpClient增刪改查ASP.NET Web API服務的方法,文中通過示例代碼介紹的非常詳細。對大家的學習或工作具有一定的參考借鑒價值,需要的朋友可以參考下
    2022-10-10
  • 禁止ViewState的3種解決方法

    禁止ViewState的3種解決方法

    默認情況下,ViewState是被啟用的,比如提交表單后,表單中輸入的值會自動保留。但是如果不需要保留,也可以將其禁用,這樣可以節(jié)省資源。
    2013-03-03
  • .Net基于Thread實現(xiàn)自旋鎖的三種方式

    .Net基于Thread實現(xiàn)自旋鎖的三種方式

    本文主要講解.Net基于Thread實現(xiàn)自旋鎖的三種方式,基于Test--And--Set原子操作實現(xiàn),包含優(yōu)缺點介紹,感興趣的朋友跟隨小編一起看看吧
    2021-06-06
  • 如何利用HttpClientFactory實現(xiàn)簡單的熔斷降級

    如何利用HttpClientFactory實現(xiàn)簡單的熔斷降級

    這篇文章主要給大家介紹了關于如何利用HttpClientFactory實現(xiàn)簡單的熔斷降級的相關資料,文中通過示例代碼介紹的非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友們下面隨著小編來一起學習學習吧
    2018-07-07
  • C#中使用SQLite數(shù)據(jù)庫的方法介紹

    C#中使用SQLite數(shù)據(jù)庫的方法介紹

    SQLite是一個開源的輕量級的桌面型數(shù)據(jù)庫,它將幾乎所有數(shù)據(jù)庫要素(包括定義、表、索引和數(shù)據(jù)本身)都保存在一個單一的文件中。SQLite用C編寫實現(xiàn),它在內存消耗、文件體積、操作性能、簡單性方面都有不錯的表現(xiàn)
    2012-01-01
  • ASP.NET Global.asax應用程序文件簡介

    ASP.NET Global.asax應用程序文件簡介

    Global.asax 文件,有時候叫做 ASP.NET 應用程序文件,提供了一種在一個中心位置響應應用程序級或模塊級事件的方法。
    2009-03-03
  • asp.net(c#) RSS功能實現(xiàn)代碼

    asp.net(c#) RSS功能實現(xiàn)代碼

    這兩天一邊從網(wǎng)上找資料,自己再測試,終于完成本站的RSS功能了!先自我恭喜下!!  
    2008-11-11
  • ASP.NET 4.0配置文件中的ClientIDMode屬性詳解

    ASP.NET 4.0配置文件中的ClientIDMode屬性詳解

    在ASP.NET 4.0中的每個控件上都多了一個叫做ClientIDMode的屬性,本文主要介紹了ASP.NET 4.0配置文件中的ClientIDMode屬性詳解,非常具有實用價值,需要的朋友可以參考下
    2018-11-11
  • asp.net coolite 刪除時彈出確定按鈕

    asp.net coolite 刪除時彈出確定按鈕

    如果用coolite的 Confirm() 是不知道你選擇了什么的 如上代碼才可以的
    2009-09-09
  • asp.net mvc CodeFirst模式數(shù)據(jù)庫遷移步驟詳解

    asp.net mvc CodeFirst模式數(shù)據(jù)庫遷移步驟詳解

    這篇文章主要為大家詳細介紹了asp.net mvc CodeFirst模式數(shù)據(jù)庫遷移步驟,具有一定的參考價值,感興趣的小伙伴們可以參考一下
    2017-10-10

最新評論