经验首页 前端设计 程序设计 Java相关 移动开发 数据库/运维 软件/图像 大数据/云计算 其他经验
当前位置：技术经验 » Java相关 » Spring Boot » 查看文章
实战指南：使用 xUnit.DependencyInjection 在单元测试中实现依赖注入【完整教程】
来源：cnblogs　　作者：董瑞鹏　　时间：2024/4/15 9:48:48　　对本文有异议

引言

上一篇我们创建了一个Sample.Api项目和Sample.Repository，并且带大家熟悉了一下Moq的概念，这一章我们来实战一下在xUnit项目使用依赖注入。

Xunit.DependencyInjection

Xunit.DependencyInjection 是一个用于 xUnit 测试框架的扩展库，它提供了依赖注入的功能，使得在编写单元测试时可以更方便地进行依赖注入。通过使用 Xunit.DependencyInjection，可以在 xUnit 测试中使用依赖注入容器（比如 Microsoft.Extensions.DependencyInjection）来管理测试中所需的各种依赖关系，包括服务、日志、配置等等。

使用

我们用Xunit.DependencyInjection对上一章的Sample.Repository进行单元测试。

Nuget包安装项目依赖

  1. PM> NuGet\Install-Package Xunit.DependencyInjection -Version 9.1.0

创建测试类

  1. public class StaffRepositoryTest
  2. {
  3.     [Fact]
  4.     public void DependencyInject_WhenCalled_ReturnTrue()
  5.     {
  6.         Assert.True(true);
  7.     }
  8. }

运行测试 先看一下

image

从这可以得出一个结论 如果安装了Xunit.DependencyInjection的xUnit单元测试项目启动时会检测是否有默认的Startup类

如果你安装了Xunit.DependencyInjection但是还没有准备好在项目中使用也可以在csproj中禁用

  1. <Project>
  2.     <PropertyGroup>
  3.         <EnableXunitDependencyInjectionDefaultTestFrameworkAttribute>false</EnableXunitDependencyInjectionDefaultTestFrameworkAttribute>
  4.     </PropertyGroup>
  5. </Project>

再测试一下

image

可以看到我们添加的配置生效了

配置

在我们的测试项目中新建Startup.cs

  1. public class Startup
  2. {
  4. }

在.Net 6 之前我们不就是用这个来配置项目的依赖和管道吗，其实这个位置也一样用它来对我们项目的依赖和服务做一些基础配置，使用配置单元测试的Startup其实和配置我们的Asp.Net Core的启动配置是一样的

CreateHostBuilder

CreateHostBuilder 方法用于创建应用程序的主机构建器（HostBuilder）。在这个方法中，您可以配置主机的各种参数、服务、日志、环境等。这个方法通常用于配置主机构建器的各种属性，以便在应用程序启动时使用。

  1. public IHostBuilder CreateHostBuilder([AssemblyName assemblyName]) { }

ConfigureHost

ConfigureHost 方法用于配置主机构建器。在这个方法中，您可以对主机进行一些自定义的配置，比如设置环境、使用特定的配置源等

  1.   public void ConfigureHost(IHostBuilder hostBuilder) { }

ConfigureServices

ConfigureServices 方法用于配置依赖注入容器（ServiceCollection）。在这个方法中，您可以注册应用程序所需的各种服务、中间件、日志、数据库上下文等等。这个方法通常用于配置应用程序的依赖注入服务。

Configure

ConfigureServices 中配置的服务可以在 Configure 方法中指定。如果已经配置的服务在 Configure 方法的参数中可用，它们将会被注入

  1.     public void Configure()
  2.     {
  4.     }

Sample.Repository

接下来对我们的仓储层进行单元测试
已知我们的仓储层已经有注入的扩展方法

  1.     public static IServiceCollection AddEFCoreInMemoryAndRepository(this IServiceCollection services)
  2.     {
  3.         services.AddScoped<IStaffRepository, StaffRepository>();
  4.         services.AddDbContext<SampleDbContext>(options => options.UseInMemoryDatabase("sample").EnableSensitiveDataLogging(), ServiceLifetime.Scoped);
  5.         return services;
  6.     }

所以我们只需要在单元测试项目的Startup的ConfigureServices 注入即可。
对我们的Sample.Repository添加项目引用,然后进行依赖注册

  1.     public void ConfigureServices(IServiceCollection services, HostBuilderContext context)
  2.     {
  3.         services.AddEFCoreInMemoryAndRepository();
  4.     }

好了接下来编写单元测试Case

依赖项获取：

  1. public class StaffRepositoryTest
  2. {
  3.     private readonly IStaffRepository _staffRepository;
  4.     public StaffRepositoryTest(IStaffRepository staffRepository)
  5.     {
  6.         _staffRepository = staffRepository;
  7.     }
  8. }

在测试类中使用依赖注入和我们正常获取依赖是一样的都是通过构造函数的形式

  1.  public class StaffRepositoryTest
  2. {
  3.     private readonly IStaffRepository _staffRepository;
  4.     public StaffRepositoryTest(IStaffRepository staffRepository)
  5.     {
  6.         _staffRepository = staffRepository;
  7.     }
  9.     //[Fact]
  10.     //public void DependencyInject_WhenCalled_ReturnTrue()
  11.     //{
  12.     //    Assert.True(true);
  13.     //}
  15.     [Fact]
  16.     public async Task AddStaffAsync_WhenCalled_ShouldAddStaffToDatabase()
  17.     {
  18.         // Arrange
  19.         var staff = new Staff { Name = "zhangsan", Email = "zhangsan@163.com" };
  20.         // Act
  21.         await _staffRepository.AddStaffAsync(staff, CancellationToken.None);
  22.         // Assert
  23.         var retrievedStaff = await _staffRepository.GetStaffByIdAsync(staff.Id, CancellationToken.None);
  24.         Assert.NotNull(retrievedStaff); // 确保 Staff 已成功添加到数据库
  25.         Assert.Equal("zhangsan", retrievedStaff.Name); // 检查名称是否正确
  26.     }
  29.     [Fact]
  30.     public async Task DeleteStaffAsync_WhenCalled_ShouldDeleteStaffFromDatabase()
  31.     {
  33.         var staff = new Staff { Name = "John", Email = "john@example.com" };
  34.         await _staffRepository.AddStaffAsync(staff, CancellationToken.None); // 先添加一个 Staff
  36.         // Act
  37.         await _staffRepository.DeleteStaffAsync(staff.Id, CancellationToken.None); // 删除该 Staff
  39.         // Assert
  40.         var retrievedStaff = await _staffRepository.GetStaffByIdAsync(staff.Id, CancellationToken.None); // 尝试获取已删除的 Staff
  41.         Assert.Null(retrievedStaff); // 确保已经删除
  43.     }
  46.     [Fact]
  47.     public async Task UpdateStaffAsync_WhenCalled_ShouldUpdateStaffInDatabase()
  48.     {
  49.         // Arrange
  50.         var staff = new Staff { Name = "John", Email = "john@example.com" };
  51.         await _staffRepository.AddStaffAsync(staff, CancellationToken.None); // 先添加一个 Staff
  53.         // Act
  54.         staff.Name = "Updated Name";
  55.         await _staffRepository.UpdateStaffAsync(staff, CancellationToken.None); // 更新 Staff
  57.         // Assert
  58.         var updatedStaff = await _staffRepository.GetStaffByIdAsync(staff.Id, CancellationToken.None); // 获取已更新的 Staff
  59.         Assert.Equal("Updated Name", updatedStaff?.Name); // 确保 Staff 已更新
  61.     }
  63.     [Fact]
  64.     public async Task GetStaffByIdAsync_WhenCalledWithValidId_ShouldReturnStaffFromDatabase()
  65.     {
  66.         // Arrange
  67.         var staff = new Staff { Name = "John", Email = "john@example.com" };
  68.         await _staffRepository.AddStaffAsync(staff, CancellationToken.None); // 先添加一个 Staff
  69.                                                                              // Act
  70.         var retrievedStaff = await _staffRepository.GetStaffByIdAsync(staff.Id, CancellationToken.None); // 获取 Staff
  71.                                                                                                          // Assert
  72.         Assert.NotNull(retrievedStaff); // 确保成功获取 Staff
  74.     }
  76.     [Fact]
  77.     public async Task GetAllStaffAsync_WhenCalled_ShouldReturnAllStaffFromDatabase()
  78.     {
  79.         // Arrange
  80.         var staff1 = new Staff { Name = "John", Email = "john@example.com" };
  81.         var staff2 = new Staff { Name = "Alice", Email = "alice@example.com" };
  82.         await _staffRepository.AddStaffAsync(staff1, CancellationToken.None); // 先添加 Staff1
  83.         await _staffRepository.AddStaffAsync(staff2, CancellationToken.None); // 再添加 Staff2
  85.         // Act
  86.         var allStaff = await _staffRepository.GetAllStaffAsync(CancellationToken.None); // 获取所有 Staff
  88.         // Assert
  89.         List<Staff> addStaffs = [staff1, staff2];
  90.         Assert.True(addStaffs.All(_ => allStaff.Any(x => x.Id == _.Id))); // 确保成功获取所有 Staff
  91.     }
  92. }

Run Tests

image

可以看到单元测试已经都成功了，是不是很简单呢。

扩展

如何注入 ITestOutputHelper?

之前的示例不使用xUnit.DependencyInjection我们用ITestOutputHelper通过构造函数构造，现在是用ITestOutputHelperAccessor

  1. public class DependencyInjectionTest
  2. {
  3.     private readonly ITestOutputHelperAccessor _testOutputHelperAccessor;
  4.     public DependencyInjectionTest(ITestOutputHelperAccessor testOutputHelperAccessor)
  5.     {
  6.         _testOutputHelperAccessor = testOutputHelperAccessor;
  7.     }
  9.     [Fact]
  10.     public void TestOutPut_Console()
  11.     {
  12.         _testOutputHelperAccessor.Output?.WriteLine("测试ITestOutputHelperAccessor");
  13.         Assert.True(true);
  14.     }
  15. }

OutPut:

image

日志输出到 ITestOutputHelper

Nuget安装

  1. PM> NuGet\Install-Package Xunit.DependencyInjection.Logging -Version 9.0.0

ConfigureServices配置依赖

  1.  public void ConfigureServices(IServiceCollection services)
  2.         => services.AddLogging(lb => lb.AddXunitOutput());

使用:

  1. public class DependencyInjectionTest
  2. {
  3.     private readonly ILogger<DependencyInjectionTest> _logger;
  4.     public DependencyInjectionTest(ILogger<DependencyInjectionTest> logger)
  5.     {
  6.         _logger = logger;
  7.     }
  9.     [Fact]
  10.     public void Test()
  11.     {
  12.         _logger.LogDebug("LogDebug");
  13.         _logger.LogInformation("LogInformation");
  14.         _logger.LogError("LogError");
  15.     }
  16. }

OutPut：

  1.  标准输出:?
  2. [2024-04-12 16:00:24Z] info: dotNetParadise.DependencyInjection.DependencyInjectionTest[0]
  3.       LogInformation
  4. [2024-04-12 16:00:24Z] fail: dotNetParadise.DependencyInjection.DependencyInjectionTest[0]
  5.       LogError

startup 类中注入 IConfiguration 或 IHostEnvironment

通过ConfigureServices设置 EnvironmentName和使用IConfiguration

  1.    public void ConfigureServices(HostBuilderContext context)
  2.     {
  3.         context.HostingEnvironment.EnvironmentName = "test";
  4.            //使用配置
  5.         context.Configuration.GetChildren();
  6.     }

也可以使用Startup下的ConfigureHost设置

  1. public class Startup
  2. {
  3.     public void ConfigureHost(IHostBuilder hostBuilder) =>
  4.         hostBuilder
  5.             .ConfigureServices((context, services) => { context.XXXX });
  6. }

在 ConfigureHost 下可以对.Net IHostBuilder进行配置,可以对IConfiguration,IServiceCollection,Log等跟Asp.Net Core使用一致。

集成测试

xUnit.DependencyInjection 也可以对Asp.Net Core项目进行集成测试

安装 Microsoft.AspNetCore.TestHost

  1. PM> NuGet\Install-Package Microsoft.AspNetCore.TestHost -Version 9.0.0-preview.3.24172.13
  1.     public void ConfigureHost(IHostBuilder hostBuilder) =>
  2.         hostBuilder.ConfigureWebHost[Defaults](webHostBuilder => webHostBuilder
  3.             .UseTestServer(options => options.PreserveExecutionContext = true)
  4.             .UseStartup<AspNetCoreStartup>());

可以参考 xUnit 的官网实现，其实有更优雅的实现集成测试的方案，xUnit.DependencyInject 的集成测试方案仅做参考集合，在后面章节笔者会对集成测试做详细的介绍。

最后

希望本文对您在使用 Xunit.DependencyInjection 进行依赖注入和编写单元测试时有所帮助。通过本文的介绍，您可以更加灵活地管理测试项目中的依赖关系，提高测试代码的可维护性和可测试性

??欢迎关注笔者公众号一起学习交流，获取更多有用的知识~
image

原文链接：https://www.cnblogs.com/ruipeng/p/18134907

 友情链接：直通硅谷 　点职佳 　北美留学生论坛

Spring Boot热门文章

  • 史上最详 Thymeleaf 使用教程
  • Spring Boot如何通过java -jar启动
  • Spring Boot 2.x（六）：优雅的统一返回值
  • Springboot使用Logback实现日志配置与异常记录
  • 使用SpringBoot+EasyExcel+Vue实现excel表格的导入和导出详解
  • spring boot上传文件超出大小异常无法捕获问题
  • paging组件的用法和意义
  • springboot2.0集成rabbitmq的示例代码
  • Spring MVC学习step1——框架熟悉
  • spring boot ${}占位符不起作用的解决方案

    • Spring Boot推荐文章

  • 3分钟带你搞定Spring Boot中Schedule
  • 不单独部署注册中心，又要具备注册中心的功能，我能上天！
  • 从零开始学Spring Boot系列-集成Spring Security实现用户认证与授权
  • 不单独部署注册中心，又要具备注册中心的功能，咋不让我上天？
  • EasyExcel 无法读取图片？用poi写了一个工具类
  • 【进阶篇】使用 Stream 流对比两个集合的常用操作分享
  • 关于DDD和COLA的一些总结和思考
  • SnakeYaml反序列化分析
  • RestTemplate进行https请求时适配信任证书
  • Kryo反序列化链分析

    • 本站QQ群：前端 618073944 | Java 606181507 | Python 626812652 | C/C++ 612253063 | 微信 634508462 | 苹果 692586424 | C#/.net 182808419 | PHP 305140648 | 运维 608723728

    W3xue 的所有内容仅供测试，对任何法律问题及风险不承担任何责任。通过使用本站内容随之而来的风险与本站无关。
    关于我们  |  意见建议  |  捐助我们  |  报错有奖  |  广告合作、友情链接（目前9元/月）请联系QQ：27243702 沸活量
    皖ICP备17017327号-2　皖公网安备34020702000426号