使用 CollectionFixture 参数化测试套件

XUnit 是一个流行的 C# 统一测试框架。它允许测试人员使用一致的模式定义并运行各种类型的测试。其中之一是 CollectionFixture，它可以被用来测试需要依赖于传递参数的测试套件。

什么是 CollectionFixture？

CollectionFixture 是一个允许多个测试方法之间共享同一个固定对象实例的 xunit 特性。我们可以使用 CollectionFixture 来处理需要共享资源的测试套件。比如，在多个测试用例进行 IO 操作时，我们可能需要使用相同的测试数据/配置，那么我们可以使用 CollectionFixture 来避免每个测试用例都读取资源，从而提高测试效率。

如何使用 CollectionFixture?

以下是使用 CollectionFixture 参数化的测试套件的步骤：

1. 定义类：

    public class MyCollectionFixture : IDisposable {
        public MyCollectionFixture () {
            // CollectionFixture 的构造函数用于准备资源并初始化连接/配置/文件等。
        }
   
        public void Dispose () {
            // Dispose 方法通常用于在测试结束后释放资源。
        }
    }
   

2. 在测试类中将 CollectionFixture 作为集合属性声明:

    [CollectionDefinition ("MyCollectionFixture")]
    public class MyCollectionFixtureInstance : ICollectionFixture<MyCollectionFixture> {}
   

   这个属性的名称可以与 CollectionFixture 类的名称不同。

3. 在测试类上使用 CollectionFixture 属性:

    [Collection ("MyCollectionFixture")]
    public class MyTestCollection {
        private readonly MyCollectionFixture _fixture;
   
        public MyTestCollection (MyCollectionFixture fixture) {
            _fixture = fixture;
        }
   
        [Fact]
        public void Test1 () {
            // Test 1 通过 _fixture 使用共享资源
        }
   
        [Fact]
        public void Test2 () {
            // Test 2 通过 _fixture 使用共享资源
        }
    }
   

   每一个测试用例都会获取 CollectionFixture（MyCollectionFixture）作为参数初始化资源，并在调用方法之前释放资源。

CollectionFixture 的优点

• 避免了每个测试用例都读取和准备测试数据和资源。
• 有助于提高测试效率和性能。
• 简化了测试的准备过程。
• 避免了测试数据上的冲突，从而能够更加准确地测试每个测试用例。

总结

CollectionFixture 提供了一种有效的方式，使测试套件能够共享规范、连接或配置，从而加快测试速度。由于这些测试数据或连接共享，它们不会被多个测试用例重复读取或初始化。如果你需要测试套件的各种测试之间互相独立，同时使用共享连接或规范，那么 CollectionFixture 参数化测试套件是个非常好的选择。