# AutoFixture进阶：自修正化测试数据生成策略 ## 适用于 * 自动夹具定制 * 自动夹具定制 * ISpecimenBuilder * 样本生成器 * 数据注释自动固定装置 * 属性范围控制 * 夹具.定制 * 插入(0) * 随机日期时间序列生成器 * 数字范围生成器 * 自订浏览器 * 定制构建器自动装置 ## 概述本技能原理AutoFixture的进阶自修正功能，让您能够根据业务需求精准控制测试数据的生成逻辑。从DataAnnotations自动整合到自订`ISpecimenBuilder`实作，掌握这些技术可以让测试数据更符合实际业务需求。 ###核心技术 1. **DataAnnotations集成** ：AutoFixture自动识别`[StringLength]`、`[Range]`等验证属性 2. **属性范围控制** ：使用`.With()`配合`Random.Shared`动态产生随机值 3. **自订ISpecimenBuilder**：实作精确控制特定属性的照明器 4. **优先顺序管理**：理解 `Insert(0)` 与 `Add()` 的差异 5. **泛型化设计**：建立支持多种数值型的其他可重用器 ## 安装套件 ## DataAnnotations 自动集成 AutoFixture 能够自动识别 `System.ComponentModel.DataAnnotations` 的验证属性：使用 System.ComponentModel.DataAnnotations；公开课人物 { 公共 Guid Id { 获取；放; } [字符串长度(10)] 公共字符串名称{获取;放; } = 字符串.Empty; [范围(10, 80)] 公共 int 年龄 { 得到;放; } 公共日期时间创建时间{获取;放; } } [事实] public void AutoFixture_应能识别DataAnnotations() { var 固定装置 = 新固定装置(); var person = Fixture.Create(); person.Name.Length.Should().Be(10); // 字符串长度(10) person.Age.Should().BeInRange(10, 80); // 范围(10, 80) } [事实] public void AutoFixture_批量产生_都符合限制() { var 固定装置 = 新固定装置(); var people = Fixture.CreateMany(10).ToList(); people.Should().AllSatisfy(人 => { person.Name.Length.Should().Be(10); person.Age.Should().BeInRange(10, 80); }); } ## 使用 .With() 控制属性范围 ### 固定值与动态值 // ❌固定值：只执行一次，所有对象值相同 .With(x => x.Age, Random.Shared.Next(30, 50)) // ✅ 动态值：每个物品都重新计算 .With(x => x.Age, () => Random.Shared.Next(30, 50)) ### 完整示例 [事实] public void With Method_固定值与动态值的差异() { var 固定装置 = 新固定装置(); // 固定值：所有物品年龄相同 varfixedAgeMembers=fixture.Build() .With(x => x.Age, Random.Shared.Next(30, 50)) .CreateMany(5) .ToList(); // 动态值：每个物品年龄不同 vardynamicAgeMembers=fixture.Build() .With(x => x.Age, () => Random.Shared.Next(30, 50)) .CreateMany(5) .ToList(); // 固定值：只有一个年龄 fixedAgeMembers.Select(m => m.Age).Distinct().Count().Should().Be(1); // 动态值：通常有多个年龄 DynamicAgeMembers.Select(m => m.Age).Distinct().Count().Should().BeGreaterThan(1); } ### Random.Shared 的优点特性 | `new Random()` | `随机.共享` ---|---|--- 实例化方式 | 最后建立新实例| 全域共享实例单一执行绪安全 | ❌不是 | ✅ 是正是 | 多重建立有负担，可能重复值 | 情况更佳，避免重复值用途建议 | 单执行绪、短期用途 | 多执行绪、全域消费 ## 自订ISpecimenBuilder ### RandomRangedDateTimeBuilder：精确控制DateTime属性 `RandomDateTimeSequenceGenerator` 会影响**所有** DateTime 属性。若需控制特定属性，需自订当前器：使用 AutoFixture.Kernel；使用系统反射；公共类 RandomRangedDateTimeBuilder ：ISpecimenBuilder { 私有只读日期时间_minDate；私有只读日期时间_maxDate；私有只读 HashSet _targetProperties; 公共RandomRangedDateTimeBuilder（日期时间分钟日期，日期时间最大日期，参数 string[] targetProperties) { _minDate = minDate; _maxDate = 最大日期； _targetProperties = new HashSet<字符串>(targetProperties); } 公共对象创建（对象请求，ISpecimenContext上下文） { if (请求是PropertyInfo propertyInfo && propertyInfo.PropertyType == typeof(DateTime) && _targetProperties.Contains(propertyInfo.Name)) { var 范围 = _maxDate - _minDate； var randomTicks = (long)(Random.Shared.NextDouble() * range.Ticks); 返回 _minDate.AddTicks(randomTicks); } 返回新的NoSpecimen()； } } ### 使用示例 [事实] public void 只控制特定DateTime属性() { var 固定装置 = 新固定装置(); var minDate = new DateTime(2025, 1, 1); var maxDate = new DateTime(2025, 12, 31); // 只控制UpdateTime属性固定装置.定制.添加( 新的 RandomRangedDateTimeBuilder(minDate, maxDate, "UpdateTime")); var member = Fixture.Create(); // 更新时间在指定范围内 member.UpdateTime.Should().BeOnOrAfter(minDate).And.BeOnOrBefore(maxDate); // CreateTime 不出行 } ### NoSpecimen 的重要性 `NoSpecimen` 表示当前当前器无法处理请求，由责任链中下一个器处理：公共对象创建（对象请求，ISpecimenContext上下文） { // 不是我们的目标 → 回传 NoSpecimen if（请求的不是PropertyInfo propertyInfo）返回新的NoSpecimen()； if (propertyInfo.PropertyType != typeof(DateTime)) 返回新的NoSpecimen()； if (!_targetProperties.Contains(propertyInfo.Name)) 返回新的NoSpecimen()； // 是我们的目标→产生值返回生成随机日期时间（）； } ## 优先顺序管理：Insert(0) vs Add() ### 问题：内建当前器优先顺序更高 AutoFixture 内建的 `RangeAttributeRelay`、`NumericSequenceGenerator` 可能比目前自订的器有更高的优先顺序： // ❌可能失效：被内建拦截器拦截 Fixture.Customizations.Add(new MyNumericBuilder(30, 50, "年龄")); // ✅ 正确：确保最高优先顺序 Fixture.Customizations.Insert(0, new MyNumericBuilder(30, 50, "年龄")); ### 改进版本的数值范围浏览器公共类ImprovedRandomRangedNumericSequenceBuilder：ISpecimenBuilder { 私有只读 int _min; 私有只读 int _max；私有只读 Func _predicate; 公共改进的RandomRangedNumericSequenceBuilder（整数分钟，整数最大值， Func 谓词） { _分钟=分钟； _max = 最大值； _谓词=谓词； } 公共对象创建（对象请求，ISpecimenContext上下文） { if (请求是PropertyInfo propertyInfo && propertyInfo.PropertyType == typeof(int) && _谓词（属性信息）） { 返回 Random.Shared.Next(_min, _max); } 返回新的NoSpecimen()； } } ### 使用Insert(0)确保优先顺序 [事实] public void 使用Insert0确保优先顺序() { var 固定装置 = 新固定装置(); // 使用Insert(0)确保最高优先顺序夹具.定制.插入(0, 新的改进的RandomRangedNumericSequenceBuilder（ 30、50、 prop => prop.Name == "年龄" && prop.DeclaringType == typeof(Member))); varmembers=fixture.CreateMany(20).ToList(); 成员.Should().AllSatisfy(m => m.Age.Should().BeInRange(30, 49)); } ## 泛型化数值范围当前器 ### 数字范围生成器公共类 NumericRangeBuilder : ISpecimenBuilder 其中 TValue ：结构、IComparable、IConvertible { 私有只读 TValue _min；私有只读 TValue _max；私有只读 Func _predicate; 公共数字范围生成器（ T值最小值， T值最大值， Func 谓词） { _分钟=分钟； _max = 最大值； _谓词=谓词； } 公共对象创建（对象请求，ISpecimenContext上下文） { if (请求是PropertyInfo propertyInfo && propertyInfo.PropertyType == typeof(TValue) && _谓词（属性信息）） { 返回生成随机值（）； } 返回新的NoSpecimen()； } 私有 TValue 生成随机值（） { var minDecimal = Convert.ToDecimal(_min); var maxDecimal = Convert.ToDecimal(_max); var range = maxDecimal - minDecimal； var randomValue = minDecimal + (decimal)Random.Shared.NextDouble() * range; 返回 typeof(TValue). 名称开关 { nameof(Int32) => (TValue)(object)(int)randomValue, nameof(Int64) => (TValue)(object)(long)randomValue, nameof(Int16) => (TValue)(object)(short)randomValue, nameof(Byte) => (TValue)(object)(byte)randomValue, nameof(Single) => (TValue)(object)(float)randomValue, nameof(Double) => (TValue)(object)(double)randomValue, nameof(十进制) => (TValue)(object)randomValue, _ => throw new NotSupportedException($"不支持类型 {typeof(TValue).Name}") }; } } ###平滑介面增强方法公共静态类 FixtureRangedNumericExtensions { 公共静态 IFixture AddRandomRange( 这个 IFixture 夹具， T值最小值， T值最大值， Func 谓词）其中 TValue ：结构、IComparable、IConvertible { 夹具.定制.插入(0, 新的 NumericRangeBuilder(min, max, predicate)); 返回夹具； } } ### 完整使用示例公开课产品 { 公共字符串名称{获取;放; } = 字符串.Empty; 公共小数价格 { get;放; } 公共 int 数量 { 获取;放; } 公共双重评级{得到;放; } 公共浮动折扣{获取;放; } } [事实] public void 数值类型其他范围控制() { var 固定装置 = 新固定装置(); 夹具 .AddRandomRange<产品，小数>( 50m、500m、 prop => prop.Name == "价格" && prop.DeclaringType == typeof(Product)) .AddRandomRange<产品，整数>( 1, 50, prop => prop.Name == "数量" && prop.DeclaringType == typeof(Product)) .AddRandomRange<产品，双>( 1.0、5.0、 prop => prop.Name == "评级" && prop.DeclaringType == typeof(Product)) .AddRandomRange<产品，浮点数>( 0.0f、0.5f、 prop => prop.Name == "折扣" && prop.DeclaringType == typeof(Product)); var products = Fixture.CreateMany(10).ToList(); 产品.Should().AllSatisfy(产品 => { 产品.Price.Should().BeInRange(50m, 500m); 产品.Quantity.Should().BeInRange(1, 49); 产品.Rating.Should().BeInRange(1.0, 5.0); 产品.Discount.Should().BeInRange(0.0f, 0.5f); }); } ## int vs DateTime 处理差异 ### 为何 DateTime 器用 Add() 即可生效？型别 | 内建陈列器 | 优先顺序影响 ---|---|--- `int` | `RangeAttributeRelay`、`NumericSequenceGenerator` | 会被拦截，需用 `Insert(0)` `日期时间` | 无特定浏览器 | 不会被拦截，`Add()`即可 ## 最佳实践 ### 应该做 1. **善用DataAnnotations** * 充分利用现有模型验证规则 * AutoFixture自动产生符合限制的数据 2. **使用随机共享** * 避免重复值问题 * 执行绪安全、效果更好 3. **插入(0)预留优先顺序** * 自订数值当前器务必使用 `Insert(0)` *避免被内建设备覆盖 4. **泛型化设计** * 建立可重用的泛型浏览器 * 使用增强方法提供流畅界面 ### 应该避免 1. **忽略当前器优先顺序** * 不要假设 `Add()` 一定生效 * 测试当前验证器是否正常运行 2. **过于复杂的逻辑** *浏览器保持单一职责 * 复杂业务逻辑置于测试或服务层 3. **使用新的Random()** * 可能产生重复值 *执行非绪安全 ## 课程代码范本请参考[templates]()资料夹中的示例文件： * [dataannotations-integration.cs]() \- DataAnnotations 集成自动 * [custom-specimen-builders.cs]() \- 自订 ISpecimenBuilder 实作 * [numeric-range-extensions.cs]() \- 泛型化数值范围现有器与扩充方法 ## 与其他技能的关系 * **autofixture-basics** ：本技能的前置知识，需先掌握基础掌握 * **autodata-xunit-integration** ：下一步学习目标，将自订化与xUnit整合 * **autofixture-nsubstitute-integration** ：进阶整合，结合Mock与自订数据生成 ## 参考资源 ### 原始文章本技能内容提炼自「老派软体工程师的测试修练 - 30天挑战」系列文章： * **Day 11 - AutoFixture进阶：自修正化测试数据生成策略** * 铁人赛文章： * 示例程序代码： ### 官方文件 * [AutoFixture GitHub]() * [AutoFixture官方文件]() * [ISpecimenBuilder 介面]()

Dotnet 测试自动夹具定制

包含技能