實戰指南:使用 xUnit 和 ASP.NET Core 進行集成測試【完整教程】

来源:https://www.cnblogs.com/ruipeng/p/18141877
-Advertisement-
Play Games

引言 集成測試可在包含應用支持基礎結構(如資料庫、文件系統和網路)的級別上確保應用組件功能正常。 ASP.NET Core 通過將單元測試框架與測試 Web 主機和記憶體中測試伺服器結合使用來支持集成測試。 簡介 集成測試與單元測試相比,能夠在更廣泛的級別上評估應用的組件,確認多個組件一起工作以生成預 ...


引言

集成測試可在包含應用支持基礎結構(如資料庫、文件系統和網路)的級別上確保應用組件功能正常。 ASP.NET Core 通過將單元測試框架與測試 Web 主機和記憶體中測試伺服器結合使用來支持集成測試。

簡介

集成測試與單元測試相比,能夠在更廣泛的級別上評估應用的組件,確認多個組件一起工作以生成預期結果,包括資料庫、文件系統、網路設備等組件。單元測試主要用於測試獨立軟體組件,如類方法,通常使用 fakemock 對象。集成測試使用實際組件,需要更多代碼和數據處理,運行時間更長。建議將集成測試限制在重要的基礎結構方案上,若可用單元測試或集成測試測試行為,優先選擇單元測試。集成測試中被測試的項目通常稱為"SUT",用於指代要測試的應用。避免為每種資料庫和文件系統交互排列編寫集成測試,而是通過一組集中式讀取、寫入、更新和刪除集成測試充分測試這些組件,使用單元測試測試與這些組件交互的方法邏輯,使用 fakemock 對象可加快測試速度。

集成測試實戰

我們在之前的章節中創建了Sample.ApiSample.Repository的項目,現在我們對這個項目進行整體的集成測試,帶大家來感受一下。

ASP.NET Core 中的集成測試需要以下內容:

  • 測試項目用於包含和執行測試。 測試項目具有對 SUT 的引用。
  • 測試項目為 SUT 創建測試Web主機,並使用測試伺服器客戶端處理 SUT 的請求和響應。
  • 測試運行程式用於執行測試並報告測試結果。

集成測試後跟一系列事件,包括常規“排列”“操作”“斷言”測試步驟:

  • 已配置 SUTWeb 主機。
  • 創建測試伺服器客戶端以嚮應用提交請求。
  • 執行“排列”測試步驟:測試應用會準備請求。
  • 執行“操作”`測試步驟:客戶端提交請求並接收響應。
  • 執行“斷言”測試步驟:實際響應基於預期響應驗證為通過或失敗。
  • 該過程會一直繼續,直到執行了所有測試。
  • 報告測試結果。

上面解釋到了集成測試中被測試的項目通常稱為SUT。我們要測試的項目Sample.Api既是我們的SUT

好了我們開始創建xUnit的單元測試項目,並添加Sample.Api的項目引用.

集成測試第一步

在我們的單元測試項目中安裝Nuget依賴

PM> NuGet\Install-Package Microsoft.AspNetCore.Mvc.Testing -Version 8.0.4

基礎結構組件(如測試 Web 主機和記憶體中測試伺服器 (TestServer))由 Microsoft.AspNetCore.Mvc.Testing 包提供或管理。 使用此包可簡化測試創建和執行。

Microsoft.AspNetCore.Mvc.Testing 包處理以下任務:

將依賴項文件 (.deps) 從 SUT 複製到測試項目的 bin目錄中。
將內容根目錄設置為 SUT 的項目根目錄,以便可在執行測試時找到靜態文件和頁面/視圖。
提供 WebApplicationFactory 類,以簡化 SUTTestServer 中的啟動過程。

概念有點多,後續裡面的概念會慢慢講到。

我們知道Asp.Net CoreWeb項目項目是藉助Kestrel啟動,用集成測試的TestServer正是代替了Kestrel托管服務的啟動,那我們要測試的項目就不需要單獨被啟動了。

什麼是TestServer?

TestServer 用於在集成測試中模擬和啟動應用程式的主機環境。通過創建 TestServer 實例,可以在測試中模擬出一個運行中的應用程式實例,以便進行端到端的集成測試。

Microsoft.AspNetCore.Mvc.Testing中已經預設集成了對TestServer的支持所以,不需要額外進行配置。

SUT 環境?

如果未設置 SUT 的環境,則環境會預設為開發環境即 Development

向測試項目公開啟動類Program

使用 WebApplicationFactory<TEntryPoint> 創建 TestServer以進行集成測試。 TEntryPointSUT 的入口點類,通常是 Program.cs

有兩種向測試項目公開 Program 的方法

  • Program.cs添加部分類
  var builder = WebApplication.CreateBuilder(args);
  // ... Configure services, routes, etc.
  app.Run();
  + public partial class Program { }
  • 配置MSBuild
    SUTcsproj文件下添加
	<ItemGroup>
		<Using Include="Sample.Api" />
		<InternalsVisibleTo Include="dotNetParadise.IntegrationTest" />
	</ItemGroup>
  1. <Using Include="Sample.Api" />:這個子元素指定了要在項目中使用的命名空間或程式集。在這裡,Sample.Api 被包含在項目中,以便項目可以訪問和使用該命名空間或程式集中的內容。

  2. <InternalsVisibleTo Include="dotNetParadise.IntegrationTest" />:這個子元素用於將內部可見性(InternalsVisibleTo)屬性應用於項目,允許指定的程式集(在這裡是 dotNetParadise.IntegrationTest)訪問項目中的內部成員。這在單元測試或集成測試中非常有用,因為測試項目通常需要訪問被測試項目的內部成員以進行更全面的測試。

相對來說更推薦使用第一種部分類的形式來對測試項目公開。

WebApplicationFactory

可以使用預設的WebApplicationFactory和自定義的WebApplicationFactory來進行集成測試

測試類實現一個類固定常式介面 (IClassFixture),以指示類包含測試,併在類中的所有測試間提供共用對象實例。

來感受一下

使用預設 WebApplicationFactory 的基本測試

看一下如何使用

public class DefaultWebApplicationFactoryTest : IClassFixture<WebApplicationFactory<Program>>
{
    private readonly WebApplicationFactory<Program> _factory;

    public DefaultWebApplicationFactoryTest(WebApplicationFactory<Program> factory)
    {
        _factory = factory;
    }

    [Fact]
    public async Task GetAll_Query_ReturnOkAndListStaff()
    {
        //Arrange
        var httpClient = _factory.CreateClient();
        //act
        var response = await httpClient.GetAsync("/api/Staff");
        //Assert
        //校驗狀態碼
        Assert.Equal(HttpStatusCode.OK, response.StatusCode);
        //校驗用戶
        var users = await response.Content.ReadFromJsonAsync<List<Staff>>();
        Assert.NotNull(users);
    }

    [Fact]
    public async Task GetConfig_WhenCalled_ReturnOk() {
        //Arrange
        var httpClient = _factory.CreateClient();
        //act
        var response = await httpClient.GetAsync("/GetConfig");
        //Assert
        //校驗狀態碼
        Assert.Equal(HttpStatusCode.OK, response.StatusCode);
        //校驗用戶
        var config = await response.Content.ReadFromJsonAsync<string>();
        Assert.NotNull(config);
    }
}

看到我們的測試類繼承了IClassFixture來共用實例對象,並且泛型類型是預設的WebApplicationFactory<Program>

接下來在我們的SUTSample.Apiprogram中打個斷點來驗證一下

image

看到了我們測試時預設的 WebApplicationFactory 使用預設配置啟動應用程式主機,包括載入 appsettings.json 等配置文件。

在我們的appsettings.Development.json中加了一個配置

{
  "Config": "這裡是appsettings.Development.json"
}

GetConfig_WhenCalled_ReturnOk 測試方法看下結果

image

正確的讀到appsettings.Development.json的內容了,從而可以得出我們上面的結論,如果未設置 SUT 的環境,則環境會預設為開發環境即 Development

從上面我們看到我們向SUT發請求是調用的CreateClient()
CreateClient() 方法用於創建一個 HttpClient 實例,用於模擬客戶端與 SUT 進行交互。通過這個 HttpClient,測試代碼可以發送 HTTP 請求到應用程式,並驗證應用程式的響應。

總的來說預設的 WebApplicationFactory 提供了一種快速啟動應用程式主機進行集成測試的方式,適用於簡單的測試場景。

自定義 WebApplicationFactory

通過從 WebApplicationFactory<TEntryPoint> 來創建一個或多個自定義工廠,可以獨立於測試類創建 Web 主機配置

我們來創建一個SampleApiWebAppFactory的類,然後繼承WebApplicationFactory<Program>

public class SampleApiWebAppFactory : WebApplicationFactory<Program>
{
    protected override void ConfigureWebHost(IWebHostBuilder builder)
    {

        builder.ConfigureServices((context, services) =>
        {

        });
        builder.UseEnvironment("Production");
        base.ConfigureWebHost(builder);
    }

    public HttpClient Client()
    {
        return CreateDefaultClient();
    }
}

image

裡面有Asp.Net Core 啟動項配置,我們都可以在自定義的SampleApiWebAppFactory進行重寫, 自定義的 WebApplicationFactory 提供了一種靈活的方式來定製化應用程式主機的配置,並擴展功能以滿足特定的測試需求。通過繼承並重寫 ConfigureWebHost 方法等,開發人員可以對應用程式主機進行自定義配置,包括添加新的服務、中間件或修改預設配置,從而在測試環境中模擬特定的場景或功能。

優勢和功能擴展:

  • 定製化配置: 自定義的 WebApplicationFactory 允許開發人員根據測試需求添加自定義配置,比如測試環境特定的服務、中間件或其他設置,以確保測試環境與實際生產環境保持一致或滿足特定測試需求。
  • 功能擴展: 通過重寫 ConfigureWebHost 方法,開發人員可以擴展應用程式主機的功能,例如註冊額外的服務、修改中間件管道、添加測試專用的配置等,從而更好地適應測試場景。

複雜性和維護:

  • 定製化代碼量增加: 自定義的 WebApplicationFactory 可能會包含更多的定製化代碼,需要更多的理解和維護,但這樣可以更好地控制應用程式主機的配置和功能。
  • 更高的靈活性: 雖然需要更多的理解和維護,但自定義的 WebApplicationFactory 提供了更大的靈活性和定製性,可以滿足更複雜的測試需求,並確保測試環境的準確性和一致性。

總的來說,通過自定義的 WebApplicationFactory,開發人員可以根據具體的測試場景和需求定製化配置和功能,以確保在集成測試中能夠模擬真實的應用程式環境,併進行更全面和準確的測試。這種方式允許開發人員更好地控制應用程式主機的設置,以適應不同的測試需求和場景。

SUT 的資料庫上下文在 Program.cs 中註冊。 測試應用的 builder.ConfigureServices 回調在執行應用的 Program.cs 代碼之後執行。 若要將與應用資料庫不同的資料庫用於測試,必須在 builder.ConfigureServices 中替換應用的資料庫上下文。

builder.ConfigureServices((context, services) =>
{
    var descriptor = new ServiceDescriptor(
        typeof(DbContextOptions<SampleDbContext>),
        serviceProvider => DbContextFactory<SampleDbContext>(serviceProvider, (sp, o) =>
        {
            o.UseInMemoryDatabase("TestDB");
        }),
         ServiceLifetime.Scoped);

    services.Replace(descriptor);
});

上面用到的DbContextFactory方法

    private static DbContextOptions<TContext> DbContextFactory<TContext>(IServiceProvider applicationServiceProvider,
      Action<IServiceProvider, DbContextOptionsBuilder> optionsAction)
      where TContext : DbContext
    {
        var builder = new DbContextOptionsBuilder<TContext>(
            new DbContextOptions<TContext>(new Dictionary<Type, IDbContextOptionsExtension>()));

        builder.UseApplicationServiceProvider(applicationServiceProvider);

        optionsAction?.Invoke(applicationServiceProvider, builder);

        return builder.Options;
    }

來寫個集成測試

public class SampleApiTest(SampleApiWebAppFactory factory) : IClassFixture<SampleApiWebAppFactory>
{

    [Fact]
    public async Task GetAll_Query_ReturnOkAndListStaff()
    {
        //Arrange
        var httpClient = factory.CreateClient();
        //act
        var response = await httpClient.GetAsync("/api/Staff");
        //Assert
        //校驗狀態碼
        Assert.Equal(HttpStatusCode.OK, response.StatusCode);
        //校驗用戶
        var users = await response.Content.ReadFromJsonAsync<List<Staff>>();
        Assert.NotNull(users);
    }

    [Fact]
    public async Task GetConfig_WhenCalled_ReturnOk()
    {
        //Arrange
        var httpClient = factory.CreateClient();
        //act
        var response = await httpClient.GetAsync("/GetConfig");
        //Assert
        //校驗狀態碼
        Assert.Equal(HttpStatusCode.OK, response.StatusCode);
        //校驗用戶
        var config = await response.Content.ReadFromJsonAsync<string>();
        Assert.NotNull(config);
    }

    // 後面測試省略。。。。
}

image

最後

集成測試是確保應用組件在包含資料庫、文件系統和網路等基礎結構的級別上正常運行的重要方式。ASP.NET Core通過結合單元測試框架、測試Web主機和記憶體中測試伺服器來支持集成測試。

在集成測試中,我們評估應用組件在更廣泛的級別上的功能,驗證多個組件一起工作以生成預期結果,包括資料庫、文件系統、網路設備等。單元測試主要用於測試獨立的軟體組件,而集成測試需要使用實際組件,涉及更多的代碼和數據處理,以及更長的運行時間。建議將集成測試限制在重要的基礎結構方案上,優先選擇單元測試或集成測試來測試行為。

在集成測試中,被測試的項目通常稱為SUTSystem Under Test),用於指代要測試的應用。避免為每種資料庫和文件系統交互編寫獨立的集成測試,而是通過一組集中式的測試來全面測試這些組件,並使用單元測試來測試與這些組件交互的方法邏輯。

通過自定義的WebApplicationFactory,可以根據測試需求定製化配置和功能,模擬真實的應用程式環境進行全面和準確的測試。自定義的WebApplicationFactory提供了靈活性和定製性,滿足複雜的測試需求,並確保測試環境的準確性。雖然自定義的WebApplicationFactory可能需要更多的理解和維護,但能更好地適應不同的測試場景。

集成測試是確保應用程式正常運行的關鍵步驟,通過綜合不同組件的功能來驗證應用的整體表現,提高應用程式的質量和穩定性。

本文來自博客園,作者:董瑞鵬,轉載請註明原文鏈接:https://www.cnblogs.com/ruipeng/p/18141877


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • 通常情況下,PDF文件是不可編輯的,但PDF表單提供了一些可編輯區域,允許用戶填寫和提交信息。PDF表單通常用於收集信息、反饋或進行線上申請,是許多行業中數據收集和交換的重要工具。 PDF表單可以包含各種類型的輸入控制項,如文本框、覆選框、下拉菜單、單選按鈕等。本文將介紹如何使用C# 和一個免費.NE ...
  • 在C#編程世界中,語法的精妙之處往往體現在那些看似微小卻極具影響力的符號與結構之中。其中,“_ =” 這一組合突然出現還真不知道什麼意思。本文將深入剖析“_ =” 的含義、工作原理及其在實際編程中的廣泛應用,揭示其作為C#語法奇兵的重要角色。 一、下劃線 _:神秘的棄元符號 下劃線 _ 在C#中並非 ...
  • 在發現結果為真的WHEN子句時,CASE表達式的真假值判斷會終止,剩餘的WHEN子句會被忽略: CASE WHEN col_1 IN ('a', 'b') THEN '第一' WHEN col_1 IN ('a') THEN '第二' ELSE '其他' END 註意: 統一各分支返回的數據類型. ...
  • 引言 在上一章節我們實戰了在Asp.Net Core中的項目實戰,這一章節講解一下如何測試Asp.Net Core的中間件。 TestServer 還記得我們在集成測試中提供的TestServer嗎? TestServer 是由 Microsoft.AspNetCore.TestHost 包提供的。 ...
  • System.AggregateException: 發生一個或多個錯誤。 > Microsoft.WebTools.Shared.Exceptions.WebToolsException: 生成失敗。檢查輸出視窗瞭解更多詳細信息。 內部異常堆棧跟蹤的結尾 > (內部異常 #0) Microsoft ...
  • 如何將 ASP.NET Core MVC 項目的視圖分離到另一個項目 在當下這個年代 SPA 已是主流,人們早已忘記了 MVC 以及 Razor 的故事。但是在某些場景下 SSR 還是有意想不到效果。比如某些靜態頁面,比如追求首屏載入速度的時候。最近在項目中回歸傳統效果還是不錯。 有的時候我們希望將 ...
  • 前言 多表頭表格是一個常見的業務需求,然而WPF中卻沒有預設實現這個功能,得益於WPF強大的控制項模板設計,我們可以通過修改控制項模板的方式自己實現它。 一、需求分析 下圖為一個典型的統計表格,統計1-12月的數據。 此時我們有一個需求,需要將月份按季度劃分,以便能夠直觀地看到季度統計數據,以下為該需求 ...
  • 在.NET Emit編程中,我們探討了運算操作指令的重要性和應用。這些指令包括各種數學運算、位操作和比較操作,能夠在動態生成的代碼中實現對數據的處理和操作。通過這些指令,開發人員可以靈活地進行算術運算、邏輯運算和比較操作,從而實現各種複雜的演算法和邏輯......本篇之後,將進入第七部分:實戰項目 ...
一周排行
    -Advertisement-
    Play Games
  • 不廢話,直接代碼 private Stack<Action> actionStack = new Stack<Action>(); private void SetCellValues() { var worksheet = Globals.ThisAddIn.Application.ActiveS ...
  • OpenAPI 規範是用於描述 HTTP API 的標準。該標準允許開發人員定義 API 的形狀,這些 API 可以插入到客戶端生成器、伺服器生成器、測試工具、文檔等中。儘管該標準具有普遍性和普遍性,但 ASP.NET Core 在框架內預設不提供對 OpenAPI 的支持。 當前 ASP.NET ...
  • @DateTimeFormat 和 @JsonFormat 是 Spring 和 Jackson 中用於處理日期時間格式的註解,它們有不同的作用: @DateTimeFormat @DateTimeFormat 是 Spring 框架提供的註解,用於指定字元串如何轉換為日期時間類型,以及如何格式化日 ...
  • 一、背景說明 1.1 效果演示 用python開發的爬蟲採集軟體,可自動抓取抖音評論數據,並且含二級評論! 為什麼有了源碼還開發界面軟體呢?方便不懂編程代碼的小白用戶使用,無需安裝python、無需懂代碼,雙擊打開即用! 軟體界面截圖: 爬取結果截圖: 以上。 1.2 演示視頻 軟體運行演示視頻:見 ...
  • SpringBoot筆記 SpringBoot文檔 官網: https://spring.io/projects/spring-boot 學習文檔: https://docs.spring.io/spring-boot/docs/current/reference/html/ 線上API: http ...
  • 作為後端工程師,多數情況都是給別人提供介面,寫的好不好使你得重視起來。 最近我手頭一些活,需要和外部公司對接,我們需要提供一個介面文檔,這樣可以節省雙方時間、也可以防止後續扯皮。這是就要考驗我的介面是否規範化。 1. 介面名稱清晰、明確 顧名思義,介面是做什麼的,是否準確、清晰?讓使用這一眼就能知道 ...
  • 本文介紹基於Python語言,遍歷文件夾並從中找到文件名稱符合我們需求的多個.txt格式文本文件,並從上述每一個文本文件中,找到我們需要的指定數據,最後得到所有文本文件中我們需要的數據的合集的方法~ ...
  • Java JUC&多線程 基礎完整版 目錄Java JUC&多線程 基礎完整版1、 多線程的第一種啟動方式之繼承Thread類2、多線程的第二種啟動方式之實現Runnable介面3、多線程的第三種實現方式之實現Callable介面4、多線的常用成員方法5、線程的優先順序6、守護線程7、線程的讓出8、線 ...
  • 實時識別關鍵詞是一種能夠將搜索結果提升至新的高度的API介面。它可以幫助我們更有效地分析文本,並提取出關鍵詞,以便進行進一步的處理和分析。 該介面是挖數據平臺提供的,有三種模式:精確模式、全模式和搜索引擎模式。不同的模式在分詞的方式上有所不同,適用於不同的場景。 首先是精確模式。這種模式會儘量將句子 ...
  • 1 為啥要折騰搭建一個專屬圖床? 技術大佬寫博客都用 md 格式,要在多平臺發佈,圖片就得有外鏈 後續如博客遷移,國內博客網站如掘金,簡書,語雀等都做了防盜鏈,圖片無法遷移 2 為啥選擇CloudFlare R2 跳轉:https://dash.cloudflare.com/ 有白嫖額度 免費 CD ...