using System.IO; using GFramework.Game.Abstractions.Config; using GFramework.Game.Config; namespace GFramework.Game.Tests.Config; /// /// 验证 YAML 配置加载器的目录扫描与注册行为。 /// [TestFixture] public class YamlConfigLoaderTests { /// /// 为每个测试创建独立临时目录，避免文件系统状态互相污染。 /// [SetUp] public void SetUp() { _rootPath = Path.Combine(Path.GetTempPath(), "GFramework.ConfigTests", Guid.NewGuid().ToString("N")); Directory.CreateDirectory(_rootPath); } /// /// 清理测试期间创建的临时目录。 /// [TearDown] public void TearDown() { if (Directory.Exists(_rootPath)) { Directory.Delete(_rootPath, true); } } private string _rootPath = null!; /// /// 验证加载器能够扫描 YAML 文件并将结果写入注册表。 /// [Test] public async Task LoadAsync_Should_Register_Table_From_Yaml_Files() { CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime hp: 10 """); CreateConfigFile( "monster/goblin.yml", """ id: 2 name: Goblin hp: 30 """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", static config => config.Id); var registry = new ConfigRegistry(); await loader.LoadAsync(registry); var table = registry.GetTable("monster"); Assert.Multiple(() => { Assert.That(table.Count, Is.EqualTo(2)); Assert.That(table.Get(1).Name, Is.EqualTo("Slime")); Assert.That(table.Get(2).Hp, Is.EqualTo(30)); }); } /// /// 验证加载器支持通过选项对象注册带 schema 校验的配置表。 /// [Test] public async Task RegisterTable_Should_Support_Options_Object() { CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime hp: 10 """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "hp": { "type": "integer" } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable( new YamlConfigTableRegistrationOptions( "monster", "monster", static config => config.Id) { SchemaRelativePath = "schemas/monster.schema.json" }); var registry = new ConfigRegistry(); await loader.LoadAsync(registry); var table = registry.GetTable("monster"); Assert.Multiple(() => { Assert.That(table.Count, Is.EqualTo(1)); Assert.That(table.Get(1).Name, Is.EqualTo("Slime")); Assert.That(table.Get(1).Hp, Is.EqualTo(10)); }); } /// /// 验证加载器会拒绝空的配置表注册选项对象。 /// [Test] public void RegisterTable_Should_Throw_When_Options_Are_Null() { var loader = new YamlConfigLoader(_rootPath); Assert.Throws(() => loader.RegisterTable(null!)); } /// /// 验证注册的配置目录不存在时会抛出清晰错误。 /// [Test] public void LoadAsync_Should_Throw_When_Config_Directory_Does_Not_Exist() { var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", static config => config.Id); var registry = new ConfigRegistry(); var exception = Assert.ThrowsAsync(async () => await loader.LoadAsync(registry)); Assert.Multiple(() => { Assert.That(exception, Is.Not.Null); Assert.That(exception!.Message, Does.Contain("monster")); Assert.That(exception.Diagnostic.FailureKind, Is.EqualTo(ConfigLoadFailureKind.ConfigDirectoryNotFound)); Assert.That(exception.Diagnostic.TableName, Is.EqualTo("monster")); Assert.That(exception.Diagnostic.ConfigDirectoryPath, Is.EqualTo(Path.Combine(_rootPath, "monster"))); Assert.That(registry.Count, Is.EqualTo(0)); }); } /// /// 验证某个配置表加载失败时，注册表不会留下部分成功的中间状态。 /// [Test] public void LoadAsync_Should_Not_Mutate_Registry_When_A_Later_Table_Fails() { CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime hp: 10 """); var registry = new ConfigRegistry(); registry.RegisterTable( "existing", new InMemoryConfigTable( new[] { new ExistingConfigStub(100, "Original") }, static config => config.Id)); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", static config => config.Id) .RegisterTable("broken", "broken", static config => config.Id); var exception = Assert.ThrowsAsync(async () => await loader.LoadAsync(registry)); Assert.Multiple(() => { Assert.That(exception, Is.Not.Null); Assert.That(exception!.Diagnostic.FailureKind, Is.EqualTo(ConfigLoadFailureKind.ConfigDirectoryNotFound)); Assert.That(exception.Diagnostic.TableName, Is.EqualTo("broken")); Assert.That(registry.Count, Is.EqualTo(1)); Assert.That(registry.HasTable("monster"), Is.False); Assert.That(registry.GetTable("existing").Get(100).Name, Is.EqualTo("Original")); }); } /// /// 验证非法 YAML 会被包装成带文件路径的反序列化错误。 /// [Test] public void LoadAsync_Should_Throw_With_File_Path_When_Yaml_Is_Invalid() { CreateConfigFile( "monster/slime.yaml", """ id: [1 name: Slime """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", static config => config.Id); var registry = new ConfigRegistry(); var exception = Assert.ThrowsAsync(async () => await loader.LoadAsync(registry)); Assert.Multiple(() => { Assert.That(exception, Is.Not.Null); Assert.That(exception!.Message, Does.Contain("slime.yaml")); Assert.That(registry.Count, Is.EqualTo(0)); }); } /// /// 验证启用 schema 校验后，缺失必填字段会在反序列化前被拒绝。 /// [Test] public void LoadAsync_Should_Throw_When_Required_Property_Is_Missing_According_To_Schema() { CreateConfigFile( "monster/slime.yaml", """ id: 1 hp: 10 """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "hp": { "type": "integer" } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); var exception = Assert.ThrowsAsync(async () => await loader.LoadAsync(registry)); Assert.Multiple(() => { Assert.That(exception, Is.Not.Null); Assert.That(exception!.Message, Does.Contain("name")); Assert.That(exception.Diagnostic.FailureKind, Is.EqualTo(ConfigLoadFailureKind.MissingRequiredProperty)); Assert.That(exception.Diagnostic.TableName, Is.EqualTo("monster")); Assert.That(exception.Diagnostic.YamlPath, Does.EndWith("monster/slime.yaml").Or.EndWith("monster\\slime.yaml")); Assert.That(exception.Diagnostic.SchemaPath, Does.EndWith("schemas/monster.schema.json").Or.EndWith("schemas\\monster.schema.json")); Assert.That(exception.Diagnostic.DisplayPath, Is.EqualTo("name")); Assert.That(registry.Count, Is.EqualTo(0)); }); } /// /// 验证启用 schema 校验后，类型不匹配的标量字段会被拒绝。 /// [Test] public void LoadAsync_Should_Throw_When_Property_Type_Does_Not_Match_Schema() { CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime hp: high """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "hp": { "type": "integer" } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); var exception = Assert.ThrowsAsync(async () => await loader.LoadAsync(registry)); Assert.Multiple(() => { Assert.That(exception, Is.Not.Null); Assert.That(exception!.Message, Does.Contain("hp")); Assert.That(exception!.Message, Does.Contain("integer")); Assert.That(registry.Count, Is.EqualTo(0)); }); } /// /// 验证启用 schema 校验后，标量 enum 限制会在运行时被拒绝。 /// [Test] public void LoadAsync_Should_Throw_When_Scalar_Value_Is_Not_Declared_In_Schema_Enum() { CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime rarity: epic """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name", "rarity"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "rarity": { "type": "string", "enum": ["common", "rare"] } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); var exception = Assert.ThrowsAsync(async () => await loader.LoadAsync(registry)); Assert.Multiple(() => { Assert.That(exception, Is.Not.Null); Assert.That(exception!.Message, Does.Contain("common")); Assert.That(exception!.Message, Does.Contain("rare")); Assert.That(registry.Count, Is.EqualTo(0)); }); } /// /// 验证标量 const 限制会在运行时被拒绝。 /// [Test] public void LoadAsync_Should_Throw_When_Scalar_Value_Does_Not_Match_Schema_Const() { CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime rarity: rare """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name", "rarity"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "rarity": { "type": "string", "const": "common" } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); var exception = Assert.ThrowsAsync(async () => await loader.LoadAsync(registry)); Assert.Multiple(() => { Assert.That(exception, Is.Not.Null); Assert.That(exception!.Message, Does.Contain("constant value")); Assert.That(exception.Message, Does.Contain("\"common\"")); Assert.That(registry.Count, Is.EqualTo(0)); }); } /// /// 验证数值最小值与最大值约束会在运行时被统一拒绝。 /// [Test] public void LoadAsync_Should_Throw_When_Number_Violates_Minimum_Or_Maximum() { CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime hp: 101 """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name", "hp"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "hp": { "type": "integer", "minimum": 1, "maximum": 100 } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); var exception = Assert.ThrowsAsync(async () => await loader.LoadAsync(registry)); Assert.Multiple(() => { Assert.That(exception, Is.Not.Null); Assert.That(exception!.Diagnostic.FailureKind, Is.EqualTo(ConfigLoadFailureKind.ConstraintViolation)); Assert.That(exception.Diagnostic.DisplayPath, Is.EqualTo("hp")); Assert.That(exception.Diagnostic.RawValue, Is.EqualTo("101")); Assert.That(exception.Message, Does.Contain("100")); Assert.That(registry.Count, Is.EqualTo(0)); }); } /// /// 验证数值命中开区间下界时会按 schema 在运行时被拒绝。 /// [Test] public void LoadAsync_Should_Throw_When_Number_Violates_Exclusive_Minimum() { CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime hp: 10 """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name", "hp"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "hp": { "type": "integer", "exclusiveMinimum": 10, "exclusiveMaximum": 100 } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); var exception = Assert.ThrowsAsync(async () => await loader.LoadAsync(registry)); Assert.Multiple(() => { Assert.That(exception, Is.Not.Null); Assert.That(exception!.Diagnostic.FailureKind, Is.EqualTo(ConfigLoadFailureKind.ConstraintViolation)); Assert.That(exception.Diagnostic.DisplayPath, Is.EqualTo("hp")); Assert.That(exception.Diagnostic.RawValue, Is.EqualTo("10")); Assert.That(exception.Message, Does.Contain("greater than 10")); Assert.That(registry.Count, Is.EqualTo(0)); }); } /// /// 验证数值命中开区间上界时会按 schema 在运行时被拒绝。 /// [Test] public void LoadAsync_Should_Throw_When_Number_Violates_Exclusive_Maximum() { CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime hp: 100 """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name", "hp"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "hp": { "type": "integer", "exclusiveMinimum": 10, "exclusiveMaximum": 100 } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); var exception = Assert.ThrowsAsync(async () => await loader.LoadAsync(registry)); Assert.Multiple(() => { Assert.That(exception, Is.Not.Null); Assert.That(exception!.Diagnostic.FailureKind, Is.EqualTo(ConfigLoadFailureKind.ConstraintViolation)); Assert.That(exception.Diagnostic.DisplayPath, Is.EqualTo("hp")); Assert.That(exception.Diagnostic.RawValue, Is.EqualTo("100")); Assert.That(exception.Message, Does.Contain("less than 100")); Assert.That(registry.Count, Is.EqualTo(0)); }); } /// /// 验证数值不满足 multipleOf 时会在运行时被拒绝。 /// [Test] public void LoadAsync_Should_Throw_When_Number_Violates_MultipleOf() { CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime hp: 12 """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name", "hp"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "hp": { "type": "integer", "multipleOf": 5 } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); var exception = Assert.ThrowsAsync(async () => await loader.LoadAsync(registry)); Assert.Multiple(() => { Assert.That(exception, Is.Not.Null); Assert.That(exception!.Diagnostic.FailureKind, Is.EqualTo(ConfigLoadFailureKind.ConstraintViolation)); Assert.That(exception.Diagnostic.DisplayPath, Is.EqualTo("hp")); Assert.That(exception.Diagnostic.RawValue, Is.EqualTo("12")); Assert.That(exception.Message, Does.Contain("multiple of 5")); Assert.That(registry.Count, Is.EqualTo(0)); }); } /// /// 验证大数值配合十进制步进时，会按十进制精确整倍数规则被运行时接受。 /// [Test] public async Task LoadAsync_Should_Accept_Large_Decimal_Number_When_MultipleOf_Matches_Exact_Decimal_Step() { CreateConfigFile( "monster/slime.yaml", """ id: 1 dropRate: 10000000.2 """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "dropRate"], "properties": { "id": { "type": "integer" }, "dropRate": { "type": "number", "multipleOf": 0.1 } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); await loader.LoadAsync(registry); var table = registry.GetTable("monster"); Assert.Multiple(() => { Assert.That(table.Count, Is.EqualTo(1)); Assert.That(table.Get(1).DropRate, Is.EqualTo(10000000.2d)); }); } /// /// 验证大数量级但实际不满足 multipleOf 的数值会被运行时拒绝。 /// [Test] public void LoadAsync_Should_Throw_When_Large_Number_Is_Not_Actually_MultipleOf() { CreateConfigFile( "monster/slime.yaml", """ id: 1 dropRate: 1000000000000.4 """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "dropRate"], "properties": { "id": { "type": "integer" }, "dropRate": { "type": "number", "multipleOf": 1 } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); var exception = Assert.ThrowsAsync(async () => await loader.LoadAsync(registry)); Assert.Multiple(() => { Assert.That(exception, Is.Not.Null); Assert.That(exception!.Diagnostic.FailureKind, Is.EqualTo(ConfigLoadFailureKind.ConstraintViolation)); Assert.That(exception.Diagnostic.DisplayPath, Is.EqualTo("dropRate")); Assert.That(registry.Count, Is.EqualTo(0)); }); } /// /// 验证科学计数法数值会按 number 类型被运行时接受。 /// [Test] public async Task LoadAsync_Should_Accept_Scientific_Notation_Number() { CreateConfigFile( "monster/slime.yaml", """ id: 1 dropRate: 1.5e10 """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "dropRate"], "properties": { "id": { "type": "integer" }, "dropRate": { "type": "number" } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); await loader.LoadAsync(registry); var table = registry.GetTable("monster"); Assert.Multiple(() => { Assert.That(table.Count, Is.EqualTo(1)); Assert.That(table.Get(1).DropRate, Is.EqualTo(1.5e10)); }); } /// /// 验证字符串最小长度与最大长度约束会在运行时被统一拒绝。 /// [Test] public void LoadAsync_Should_Throw_When_String_Violates_MinLength_Or_MaxLength() { CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Sl hp: 10 """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name", "hp"], "properties": { "id": { "type": "integer" }, "name": { "type": "string", "minLength": 3, "maxLength": 12 }, "hp": { "type": "integer" } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); var exception = Assert.ThrowsAsync(async () => await loader.LoadAsync(registry)); Assert.Multiple(() => { Assert.That(exception, Is.Not.Null); Assert.That(exception!.Diagnostic.FailureKind, Is.EqualTo(ConfigLoadFailureKind.ConstraintViolation)); Assert.That(exception.Diagnostic.DisplayPath, Is.EqualTo("name")); Assert.That(exception.Diagnostic.RawValue, Is.EqualTo("Sl")); Assert.That(exception.Message, Does.Contain("at least 3 characters")); Assert.That(registry.Count, Is.EqualTo(0)); }); } /// /// 验证字符串正则模式约束会在运行时被统一拒绝。 /// [Test] public void LoadAsync_Should_Throw_When_String_Does_Not_Match_Pattern() { CreateConfigFile( "monster/slime.yaml", """ id: 1 name: slime hp: 10 """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name", "hp"], "properties": { "id": { "type": "integer" }, "name": { "type": "string", "pattern": "^[A-Z][a-z]+$" }, "hp": { "type": "integer" } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); var exception = Assert.ThrowsAsync(async () => await loader.LoadAsync(registry)); Assert.Multiple(() => { Assert.That(exception, Is.Not.Null); Assert.That(exception!.Diagnostic.FailureKind, Is.EqualTo(ConfigLoadFailureKind.ConstraintViolation)); Assert.That(exception.Diagnostic.DisplayPath, Is.EqualTo("name")); Assert.That(exception.Diagnostic.RawValue, Is.EqualTo("slime")); Assert.That(exception.Message, Does.Contain("regular expression")); Assert.That(exception.Message, Does.Contain("^[A-Z][a-z]+$")); Assert.That(registry.Count, Is.EqualTo(0)); }); } /// /// 验证运行时 schema 校验与 JS 工具对反向引用模式保持一致。 /// [Test] public async Task LoadAsync_Should_Accept_Backreference_Pattern_When_Value_Matches() { CreateConfigFile( "monster/slime.yaml", """ id: 1 name: aa hp: 10 """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name", "hp"], "properties": { "id": { "type": "integer" }, "name": { "type": "string", "pattern": "^(a)\\1$" }, "hp": { "type": "integer" } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); await loader.LoadAsync(registry); var table = registry.GetTable("monster"); Assert.Multiple(() => { Assert.That(table.Count, Is.EqualTo(1)); Assert.That(table.Get(1).Name, Is.EqualTo("aa")); }); } /// /// 验证数组元素数量命中上界时会在运行时被统一拒绝。 /// [Test] public void LoadAsync_Should_Throw_When_Array_Violates_MaxItems() { CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime dropRates: - 1 - 2 - 3 - 4 """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name", "dropRates"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "dropRates": { "type": "array", "minItems": 1, "maxItems": 3, "items": { "type": "integer" } } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); var exception = Assert.ThrowsAsync(async () => await loader.LoadAsync(registry)); Assert.Multiple(() => { Assert.That(exception, Is.Not.Null); Assert.That(exception!.Diagnostic.FailureKind, Is.EqualTo(ConfigLoadFailureKind.ConstraintViolation)); Assert.That(exception.Diagnostic.DisplayPath, Is.EqualTo("dropRates")); Assert.That(exception.Diagnostic.RawValue, Is.EqualTo("4")); Assert.That(exception.Message, Does.Contain("at most 3 items")); Assert.That(registry.Count, Is.EqualTo(0)); }); } /// /// 验证数组元素数量命中下界时会在运行时被统一拒绝。 /// [Test] public void LoadAsync_Should_Throw_When_Array_Violates_MinItems() { CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime dropRates: [] """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name", "dropRates"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "dropRates": { "type": "array", "minItems": 1, "maxItems": 3, "items": { "type": "integer" } } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); var exception = Assert.ThrowsAsync(async () => await loader.LoadAsync(registry)); Assert.Multiple(() => { Assert.That(exception, Is.Not.Null); Assert.That(exception!.Diagnostic.FailureKind, Is.EqualTo(ConfigLoadFailureKind.ConstraintViolation)); Assert.That(exception.Diagnostic.DisplayPath, Is.EqualTo("dropRates")); Assert.That(exception.Diagnostic.RawValue, Is.EqualTo("0")); Assert.That(exception.Message, Does.Contain("at least 1 items")); Assert.That(registry.Count, Is.EqualTo(0)); }); } /// /// 验证数组声明 uniqueItems 后，重复元素会在运行时被拒绝。 /// [Test] public void LoadAsync_Should_Throw_When_Array_Violates_UniqueItems() { CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime dropRates: - 5 - 10 - 5 """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name", "dropRates"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "dropRates": { "type": "array", "uniqueItems": true, "items": { "type": "integer" } } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); var exception = Assert.ThrowsAsync(async () => await loader.LoadAsync(registry)); Assert.Multiple(() => { Assert.That(exception, Is.Not.Null); Assert.That(exception!.Diagnostic.FailureKind, Is.EqualTo(ConfigLoadFailureKind.ConstraintViolation)); Assert.That(exception.Diagnostic.DisplayPath, Is.EqualTo("dropRates[2]")); Assert.That(exception.Diagnostic.RawValue, Is.EqualTo("5")); Assert.That(exception.Message, Does.Contain("unique array items")); Assert.That(registry.Count, Is.EqualTo(0)); }); } /// /// 验证数组声明 contains 后，默认至少要有一个匹配元素。 /// [Test] public void LoadAsync_Should_Throw_When_Array_Violates_Default_Contains_Match_Count() { CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime dropRates: - 1 - 2 """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name", "dropRates"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "dropRates": { "type": "array", "contains": { "type": "integer", "const": 5 }, "items": { "type": "integer" } } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); var exception = Assert.ThrowsAsync(async () => await loader.LoadAsync(registry)); Assert.Multiple(() => { Assert.That(exception, Is.Not.Null); Assert.That(exception!.Diagnostic.FailureKind, Is.EqualTo(ConfigLoadFailureKind.ConstraintViolation)); Assert.That(exception.Diagnostic.DisplayPath, Is.EqualTo("dropRates")); Assert.That(exception.Diagnostic.RawValue, Is.EqualTo("0")); Assert.That(exception.Message, Does.Contain("at least 1 items matching the 'contains' schema")); Assert.That(registry.Count, Is.EqualTo(0)); }); } /// /// 验证数组声明 minContains 后，会按匹配数量而不是总元素数做约束判断。 /// [Test] public void LoadAsync_Should_Throw_When_Array_Violates_MinContains() { CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime dropRates: - 5 - 7 - 9 """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name", "dropRates"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "dropRates": { "type": "array", "minContains": 2, "contains": { "type": "integer", "const": 5 }, "items": { "type": "integer" } } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); var exception = Assert.ThrowsAsync(async () => await loader.LoadAsync(registry)); Assert.Multiple(() => { Assert.That(exception, Is.Not.Null); Assert.That(exception!.Diagnostic.FailureKind, Is.EqualTo(ConfigLoadFailureKind.ConstraintViolation)); Assert.That(exception.Diagnostic.DisplayPath, Is.EqualTo("dropRates")); Assert.That(exception.Diagnostic.RawValue, Is.EqualTo("1")); Assert.That(exception.Message, Does.Contain("at least 2 items matching the 'contains' schema")); Assert.That(registry.Count, Is.EqualTo(0)); }); } /// /// 验证数组声明 maxContains 后，会拒绝匹配元素过多的序列。 /// [Test] public void LoadAsync_Should_Throw_When_Array_Violates_MaxContains() { CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime dropRates: - 5 - 5 - 7 """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name", "dropRates"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "dropRates": { "type": "array", "maxContains": 1, "contains": { "type": "integer", "const": 5 }, "items": { "type": "integer" } } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); var exception = Assert.ThrowsAsync(async () => await loader.LoadAsync(registry)); Assert.Multiple(() => { Assert.That(exception, Is.Not.Null); Assert.That(exception!.Diagnostic.FailureKind, Is.EqualTo(ConfigLoadFailureKind.ConstraintViolation)); Assert.That(exception.Diagnostic.DisplayPath, Is.EqualTo("dropRates")); Assert.That(exception.Diagnostic.RawValue, Is.EqualTo("2")); Assert.That(exception.Message, Does.Contain("at most 1 items matching the 'contains' schema")); Assert.That(registry.Count, Is.EqualTo(0)); }); } /// /// 验证匹配数量刚好等于 minContains / maxContains 时会被视为合法边界。 /// [Test] public async Task LoadAsync_Should_Accept_Array_When_Contains_Match_Count_Equals_Min_And_Max_Bounds() { CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime dropRates: - 5 - 7 - 5 """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name", "dropRates"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "dropRates": { "type": "array", "minContains": 2, "maxContains": 2, "contains": { "type": "integer", "const": 5 }, "items": { "type": "integer" } } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); await loader.LoadAsync(registry); var table = registry.GetTable("monster"); Assert.Multiple(() => { Assert.That(table.Count, Is.EqualTo(1)); Assert.That(table.Get(1).DropRates, Is.EqualTo(new[] { 5, 7, 5 })); }); } /// /// 验证数组字段将 contains 声明为非对象 schema 时，会在 schema 解析阶段被拒绝。 /// [Test] public void LoadAsync_Should_Throw_When_Contains_Is_Not_Object_Schema() { CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime dropRates: - 5 """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name", "dropRates"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "dropRates": { "type": "array", "contains": 5, "items": { "type": "integer" } } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); var exception = Assert.ThrowsAsync(async () => await loader.LoadAsync(registry)); Assert.Multiple(() => { Assert.That(exception, Is.Not.Null); Assert.That(exception!.Diagnostic.FailureKind, Is.EqualTo(ConfigLoadFailureKind.SchemaUnsupported)); Assert.That(exception.Diagnostic.DisplayPath, Is.EqualTo("dropRates")); Assert.That(exception.Message, Does.Contain("'contains' as an object-valued schema")); Assert.That(registry.Count, Is.EqualTo(0)); }); } /// /// 验证数组字段将 contains 声明为嵌套数组 schema 时，会在 schema 解析阶段被拒绝。 /// [Test] public void LoadAsync_Should_Throw_When_Contains_Uses_Nested_Array_Schema() { CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime dropRates: - 5 """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name", "dropRates"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "dropRates": { "type": "array", "contains": { "type": "array", "items": { "type": "integer" } }, "items": { "type": "integer" } } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); var exception = Assert.ThrowsAsync(async () => await loader.LoadAsync(registry)); Assert.Multiple(() => { Assert.That(exception, Is.Not.Null); Assert.That(exception!.Diagnostic.FailureKind, Is.EqualTo(ConfigLoadFailureKind.SchemaUnsupported)); Assert.That(exception.Diagnostic.DisplayPath, Is.EqualTo("dropRates")); Assert.That(exception.Message, Does.Contain("unsupported nested array 'contains' schemas")); Assert.That(registry.Count, Is.EqualTo(0)); }); } /// /// 验证对象数组的 contains 试匹配会按声明属性子集工作，而不会因额外字段误判为不匹配。 /// [Test] public async Task LoadAsync_Should_Accept_Object_Array_When_Contains_Matches_Declared_Subset_Properties() { CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime entries: - id: 1 weight: 2 - id: 2 weight: 3 """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name", "entries"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "entries": { "type": "array", "minContains": 1, "contains": { "type": "object", "required": ["id"], "properties": { "id": { "type": "integer", "const": 1 } } }, "items": { "type": "object", "required": ["id", "weight"], "properties": { "id": { "type": "integer" }, "weight": { "type": "integer" } } } } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); await loader.LoadAsync(registry); var table = registry.GetTable("monster"); Assert.Multiple(() => { Assert.That(table.Count, Is.EqualTo(1)); Assert.That(table.Get(1).Entries.Count, Is.EqualTo(2)); Assert.That(table.Get(1).Entries[0].Id, Is.EqualTo(1)); Assert.That(table.Get(1).Entries[0].Weight, Is.EqualTo(2)); }); } /// /// 验证数组在未声明 contains 时不能单独使用 minContains。 /// [Test] public void LoadAsync_Should_Throw_When_MinContains_Is_Declared_Without_Contains() { CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime dropRates: - 5 """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name", "dropRates"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "dropRates": { "type": "array", "minContains": 1, "items": { "type": "integer" } } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); var exception = Assert.ThrowsAsync(async () => await loader.LoadAsync(registry)); Assert.Multiple(() => { Assert.That(exception, Is.Not.Null); Assert.That(exception!.Diagnostic.FailureKind, Is.EqualTo(ConfigLoadFailureKind.SchemaUnsupported)); Assert.That(exception.Diagnostic.DisplayPath, Is.EqualTo("dropRates")); Assert.That(exception.Message, Does.Contain("minContains")); Assert.That(exception.Message, Does.Contain("without a companion 'contains' schema")); Assert.That(registry.Count, Is.EqualTo(0)); }); } /// /// 验证数组字段将 minContains 声明为大于 maxContains 时，会在 schema 解析阶段被拒绝。 /// [Test] public void LoadAsync_Should_Throw_When_Array_Contains_Count_Constraints_Are_Inverted() { CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime dropRates: - 5 """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name", "dropRates"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "dropRates": { "type": "array", "minContains": 2, "maxContains": 1, "contains": { "type": "integer", "const": 5 }, "items": { "type": "integer" } } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); var exception = Assert.ThrowsAsync(async () => await loader.LoadAsync(registry)); Assert.Multiple(() => { Assert.That(exception, Is.Not.Null); Assert.That(exception!.Diagnostic.FailureKind, Is.EqualTo(ConfigLoadFailureKind.SchemaUnsupported)); Assert.That(exception.Diagnostic.DisplayPath, Is.EqualTo("dropRates")); Assert.That(exception.Message, Does.Contain("minContains")); Assert.That(exception.Message, Does.Contain("greater than 'maxContains'")); Assert.That(registry.Count, Is.EqualTo(0)); }); } /// /// 验证 uniqueItems 的归一化键不会把带分隔符的不同对象值误判为重复项。 /// [Test] public async Task LoadAsync_Should_Accept_Distinct_Object_Items_When_Comparable_Values_Contain_Separators() { CreateConfigFile( "monster/slime.yaml", """ id: 1 entries: - a: "x|1:b=string:yz" - a: x b: yz """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "entries"], "properties": { "id": { "type": "integer" }, "entries": { "type": "array", "uniqueItems": true, "items": { "type": "object", "properties": { "a": { "type": "string" }, "b": { "type": "string" } } } } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable( "monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); await loader.LoadAsync(registry); var table = registry.GetTable("monster"); Assert.Multiple(() => { Assert.That(table.Count, Is.EqualTo(1)); Assert.That(table.Get(1).Entries.Count, Is.EqualTo(2)); Assert.That(table.Get(1).Entries[0].A, Is.EqualTo("x|1:b=string:yz")); Assert.That(table.Get(1).Entries[1].A, Is.EqualTo("x")); Assert.That(table.Get(1).Entries[1].B, Is.EqualTo("yz")); }); } /// /// 验证启用 schema 校验后，未知字段不会再被静默忽略。 /// [Test] public void LoadAsync_Should_Throw_When_Unknown_Property_Is_Present_In_Schema_Bound_Mode() { CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime attackPower: 2 """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "hp": { "type": "integer" } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); var exception = Assert.ThrowsAsync(async () => await loader.LoadAsync(registry)); Assert.Multiple(() => { Assert.That(exception, Is.Not.Null); Assert.That(exception!.Message, Does.Contain("attackPower")); Assert.That(registry.Count, Is.EqualTo(0)); }); } /// /// 验证数组字段的元素类型会按 schema 校验。 /// [Test] public void LoadAsync_Should_Throw_When_Array_Item_Type_Does_Not_Match_Schema() { CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime dropRates: - 1 - potion """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "dropRates": { "type": "array", "items": { "type": "integer" } } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable( "monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); var exception = Assert.ThrowsAsync(async () => await loader.LoadAsync(registry)); Assert.Multiple(() => { Assert.That(exception, Is.Not.Null); Assert.That(exception!.Message, Does.Contain("dropRates")); Assert.That(registry.Count, Is.EqualTo(0)); }); } /// /// 验证数组元素上的 enum 限制会按 schema 在运行时生效。 /// [Test] public void LoadAsync_Should_Throw_When_Array_Item_Is_Not_Declared_In_Schema_Enum() { CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime tags: - fire - poison """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "tags": { "type": "array", "items": { "type": "string", "enum": ["fire", "ice"] } } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); var exception = Assert.ThrowsAsync(async () => await loader.LoadAsync(registry)); Assert.Multiple(() => { Assert.That(exception, Is.Not.Null); Assert.That(exception!.Message, Does.Contain("fire")); Assert.That(exception!.Message, Does.Contain("ice")); Assert.That(registry.Count, Is.EqualTo(0)); }); } /// /// 验证数组 const 限制会保留元素顺序并按完整序列比较。 /// [Test] public void LoadAsync_Should_Throw_When_Array_Value_Does_Not_Match_Schema_Const() { CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime dropItemIds: - gem - potion """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "dropItemIds": { "type": "array", "const": ["potion", "gem"], "items": { "type": "string" } } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); var exception = Assert.ThrowsAsync(async () => await loader.LoadAsync(registry)); Assert.Multiple(() => { Assert.That(exception, Is.Not.Null); Assert.That(exception!.Message, Does.Contain("dropItemIds")); Assert.That(exception.Message, Does.Contain("potion")); Assert.That(exception.Message, Does.Contain("gem")); Assert.That(registry.Count, Is.EqualTo(0)); }); } /// /// 验证嵌套对象中的必填字段同样会按 schema 在运行时生效。 /// [Test] public void LoadAsync_Should_Throw_When_Nested_Object_Is_Missing_Required_Property() { CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime reward: gold: 10 """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name", "reward"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "reward": { "type": "object", "required": ["gold", "currency"], "properties": { "gold": { "type": "integer" }, "currency": { "type": "string" } } } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); var exception = Assert.ThrowsAsync(async () => await loader.LoadAsync(registry)); Assert.Multiple(() => { Assert.That(exception, Is.Not.Null); Assert.That(exception!.Message, Does.Contain("reward.currency")); Assert.That(registry.Count, Is.EqualTo(0)); }); } /// /// 验证嵌套对象 const 限制会按完整对象内容比较。 /// [Test] public void LoadAsync_Should_Throw_When_Nested_Object_Does_Not_Match_Schema_Const() { CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime reward: gold: 10 currency: gem """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name", "reward"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "reward": { "type": "object", "properties": { "gold": { "type": "integer" }, "currency": { "type": "string" } }, "const": { "gold": 10, "currency": "coin" } } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); var exception = Assert.ThrowsAsync(async () => await loader.LoadAsync(registry)); Assert.Multiple(() => { Assert.That(exception, Is.Not.Null); Assert.That(exception!.Message, Does.Contain("reward")); Assert.That(exception.Message, Does.Contain("\"gold\"")); Assert.That(exception.Message, Does.Contain("\"currency\"")); Assert.That(exception.Message, Does.Contain("\"coin\"")); Assert.That(registry.Count, Is.EqualTo(0)); }); } /// /// 验证空对象 const 约束会被视为合法 schema，并与空 YAML 映射正确匹配。 /// [Test] public async Task LoadAsync_Should_Accept_Empty_Object_Schema_Const() { CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime reward: {} """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name", "reward"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "reward": { "type": "object", "properties": {}, "const": {} } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); await loader.LoadAsync(registry); var table = registry.GetTable("monster"); Assert.Multiple(() => { Assert.That(table.Count, Is.EqualTo(1)); Assert.That(table.Get(1).Name, Is.EqualTo("Slime")); }); } /// /// 验证对象字段不满足 minProperties 时会在运行时被拒绝。 /// [Test] public void LoadAsync_Should_Throw_When_Object_Violates_MinProperties() { CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime reward: gold: 10 """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name", "reward"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "reward": { "type": "object", "minProperties": 2, "properties": { "gold": { "type": "integer" }, "currency": { "type": "string" } } } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); var exception = Assert.ThrowsAsync(async () => await loader.LoadAsync(registry)); Assert.Multiple(() => { Assert.That(exception, Is.Not.Null); Assert.That(exception!.Diagnostic.FailureKind, Is.EqualTo(ConfigLoadFailureKind.ConstraintViolation)); Assert.That(exception.Diagnostic.DisplayPath, Is.EqualTo("reward")); Assert.That(exception.Diagnostic.RawValue, Is.EqualTo("1")); Assert.That(exception.Message, Does.Contain("at least 2 properties")); Assert.That(registry.Count, Is.EqualTo(0)); }); } /// /// 验证对象字段不满足 maxProperties 时会在运行时被拒绝。 /// [Test] public void LoadAsync_Should_Throw_When_Object_Violates_MaxProperties() { CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime reward: gold: 10 currency: coin tier: epic """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name", "reward"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "reward": { "type": "object", "maxProperties": 2, "properties": { "gold": { "type": "integer" }, "currency": { "type": "string" }, "tier": { "type": "string" } } } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); var exception = Assert.ThrowsAsync(async () => await loader.LoadAsync(registry)); Assert.Multiple(() => { Assert.That(exception, Is.Not.Null); Assert.That(exception!.Diagnostic.FailureKind, Is.EqualTo(ConfigLoadFailureKind.ConstraintViolation)); Assert.That(exception.Diagnostic.DisplayPath, Is.EqualTo("reward")); Assert.That(exception.Diagnostic.RawValue, Is.EqualTo("3")); Assert.That(exception.Message, Does.Contain("at most 2 properties")); Assert.That(registry.Count, Is.EqualTo(0)); }); } /// /// 验证对象字段将 minProperties 声明为非法值时，会在 schema 解析阶段被拒绝。 /// [Test] public void LoadAsync_Should_Throw_When_Object_Property_Count_Constraint_Is_Not_NonNegative_Integer() { CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime reward: gold: 10 """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name", "reward"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "reward": { "type": "object", "minProperties": -1, "properties": { "gold": { "type": "integer" } } } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); var exception = Assert.ThrowsAsync(async () => await loader.LoadAsync(registry)); Assert.Multiple(() => { Assert.That(exception, Is.Not.Null); Assert.That(exception!.Diagnostic.FailureKind, Is.EqualTo(ConfigLoadFailureKind.SchemaUnsupported)); Assert.That(exception.Diagnostic.DisplayPath, Is.EqualTo("reward")); Assert.That(exception.Message, Does.Contain("minProperties")); Assert.That(exception.Message, Does.Contain("non-negative integer")); Assert.That(registry.Count, Is.EqualTo(0)); }); } /// /// 验证对象字段将 maxProperties 声明为非整数数值时，会在 schema 解析阶段被拒绝。 /// [Test] public void LoadAsync_Should_Throw_When_Object_MaxProperties_Constraint_Is_Not_Integer() { CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime reward: gold: 10 currency: coin """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name", "reward"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "reward": { "type": "object", "maxProperties": 1.5, "properties": { "gold": { "type": "integer" }, "currency": { "type": "string" } } } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); var exception = Assert.ThrowsAsync(async () => await loader.LoadAsync(registry)); Assert.Multiple(() => { Assert.That(exception, Is.Not.Null); Assert.That(exception!.Diagnostic.FailureKind, Is.EqualTo(ConfigLoadFailureKind.SchemaUnsupported)); Assert.That(exception.Diagnostic.DisplayPath, Is.EqualTo("reward")); Assert.That(exception.Message, Does.Contain("maxProperties")); Assert.That(exception.Message, Does.Contain("non-negative integer")); Assert.That(registry.Count, Is.EqualTo(0)); }); } /// /// 验证对象字段将 minProperties 声明为大于 maxProperties 时，会在 schema 解析阶段被拒绝。 /// [Test] public void LoadAsync_Should_Throw_When_Object_Property_Count_Constraints_Are_Inverted() { CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime reward: gold: 10 """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name", "reward"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "reward": { "type": "object", "minProperties": 3, "maxProperties": 2, "properties": { "gold": { "type": "integer" }, "currency": { "type": "string" }, "tier": { "type": "string" } } } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); var exception = Assert.ThrowsAsync(async () => await loader.LoadAsync(registry)); Assert.Multiple(() => { Assert.That(exception, Is.Not.Null); Assert.That(exception!.Diagnostic.FailureKind, Is.EqualTo(ConfigLoadFailureKind.SchemaUnsupported)); Assert.That(exception.Diagnostic.DisplayPath, Is.EqualTo("reward")); Assert.That(exception.Message, Does.Contain("minProperties")); Assert.That(exception.Message, Does.Contain("greater than 'maxProperties'")); Assert.That(registry.Count, Is.EqualTo(0)); }); } /// /// 验证对象数组中的嵌套字段也会按 schema 递归校验。 /// [Test] public void LoadAsync_Should_Throw_When_Object_Array_Item_Contains_Unknown_Property() { CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime phases: - wave: 1 monsterId: slime hpScale: 1.5 """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name", "phases"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "phases": { "type": "array", "items": { "type": "object", "required": ["wave", "monsterId"], "properties": { "wave": { "type": "integer" }, "monsterId": { "type": "string" } } } } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); var exception = Assert.ThrowsAsync(async () => await loader.LoadAsync(registry)); Assert.Multiple(() => { Assert.That(exception, Is.Not.Null); Assert.That(exception!.Message, Does.Contain("phases[0].hpScale")); Assert.That(registry.Count, Is.EqualTo(0)); }); } /// /// 验证深层对象数组中的跨表引用也会参与整批加载校验。 /// [Test] public void LoadAsync_Should_Throw_When_Nested_Object_Array_Reference_Target_Is_Missing() { CreateConfigFile( "item/potion.yaml", """ id: potion name: Potion """); CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime phases: - wave: 1 dropItemId: potion - wave: 2 dropItemId: bomb """); CreateSchemaFile( "schemas/item.schema.json", """ { "type": "object", "required": ["id", "name"], "properties": { "id": { "type": "string" }, "name": { "type": "string" } } } """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name", "phases"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "phases": { "type": "array", "items": { "type": "object", "required": ["wave", "dropItemId"], "properties": { "wave": { "type": "integer" }, "dropItemId": { "type": "string", "x-gframework-ref-table": "item" } } } } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("item", "item", "schemas/item.schema.json", static config => config.Id) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); var exception = Assert.ThrowsAsync(async () => await loader.LoadAsync(registry)); Assert.Multiple(() => { Assert.That(exception, Is.Not.Null); Assert.That(exception!.Message, Does.Contain("phases[1].dropItemId")); Assert.That(exception!.Message, Does.Contain("bomb")); Assert.That(registry.Count, Is.EqualTo(0)); }); } /// /// 验证绑定跨表引用 schema 时，存在的目标行可以通过加载校验。 /// [Test] public async Task LoadAsync_Should_Accept_Existing_Cross_Table_Reference() { CreateConfigFile( "item/potion.yaml", """ id: potion name: Potion """); CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime dropItemId: potion """); CreateSchemaFile( "schemas/item.schema.json", """ { "type": "object", "required": ["id", "name"], "properties": { "id": { "type": "string" }, "name": { "type": "string" } } } """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name", "dropItemId"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "dropItemId": { "type": "string", "x-gframework-ref-table": "item" } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("item", "item", "schemas/item.schema.json", static config => config.Id) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); await loader.LoadAsync(registry); Assert.Multiple(() => { Assert.That(registry.GetTable("item").ContainsKey("potion"), Is.True); Assert.That(registry.GetTable("monster").Get(1).DropItemId, Is.EqualTo("potion")); }); } /// /// 验证缺失的跨表引用会阻止整批配置写入注册表。 /// [Test] public void LoadAsync_Should_Throw_When_Cross_Table_Reference_Target_Is_Missing() { CreateConfigFile( "item/slime-gel.yaml", """ id: slime_gel name: Slime Gel """); CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime dropItemId: potion """); CreateSchemaFile( "schemas/item.schema.json", """ { "type": "object", "required": ["id", "name"], "properties": { "id": { "type": "string" }, "name": { "type": "string" } } } """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name", "dropItemId"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "dropItemId": { "type": "string", "x-gframework-ref-table": "item" } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("item", "item", "schemas/item.schema.json", static config => config.Id) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); var exception = Assert.ThrowsAsync(async () => await loader.LoadAsync(registry)); Assert.Multiple(() => { Assert.That(exception, Is.Not.Null); Assert.That(exception!.Message, Does.Contain("dropItemId")); Assert.That(exception!.Message, Does.Contain("potion")); Assert.That(registry.Count, Is.EqualTo(0)); }); } /// /// 验证跨表引用同样支持标量数组中的每个元素。 /// [Test] public void LoadAsync_Should_Throw_When_Array_Reference_Item_Is_Missing() { CreateConfigFile( "item/potion.yaml", """ id: potion name: Potion """); CreateConfigFile( "item/slime-gel.yaml", """ id: slime_gel name: Slime Gel """); CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime dropItemIds: - potion - missing_item """); CreateSchemaFile( "schemas/item.schema.json", """ { "type": "object", "required": ["id", "name"], "properties": { "id": { "type": "string" }, "name": { "type": "string" } } } """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name", "dropItemIds"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "dropItemIds": { "type": "array", "items": { "type": "string" }, "x-gframework-ref-table": "item" } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("item", "item", "schemas/item.schema.json", static config => config.Id) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); var exception = Assert.ThrowsAsync(async () => await loader.LoadAsync(registry)); Assert.Multiple(() => { Assert.That(exception, Is.Not.Null); Assert.That(exception!.Message, Does.Contain("dropItemIds[1]")); Assert.That(exception!.Message, Does.Contain("missing_item")); Assert.That(registry.Count, Is.EqualTo(0)); }); } /// /// 验证仅声明在 contains 子 schema 里的跨表引用也会参与整批加载校验。 /// [Test] public void LoadAsync_Should_Throw_When_Contains_Matched_Reference_Target_Is_Missing() { CreateConfigFile( "item/potion.yaml", """ id: potion name: Potion """); CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime dropItemIds: - potion - missing_item """); CreateSchemaFile( "schemas/item.schema.json", """ { "type": "object", "required": ["id", "name"], "properties": { "id": { "type": "string" }, "name": { "type": "string" } } } """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name", "dropItemIds"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "dropItemIds": { "type": "array", "minContains": 1, "contains": { "type": "string", "x-gframework-ref-table": "item" }, "items": { "type": "string" } } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("item", "item", "schemas/item.schema.json", static config => config.Id) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); var exception = Assert.ThrowsAsync(async () => await loader.LoadAsync(registry)); Assert.Multiple(() => { Assert.That(exception, Is.Not.Null); Assert.That(exception!.Diagnostic.FailureKind, Is.EqualTo(ConfigLoadFailureKind.ReferencedKeyNotFound)); Assert.That(exception.Diagnostic.TableName, Is.EqualTo("monster")); Assert.That(exception.Diagnostic.ReferencedTableName, Is.EqualTo("item")); Assert.That(exception.Diagnostic.DisplayPath, Is.EqualTo("dropItemIds[1]")); Assert.That(exception.Diagnostic.RawValue, Is.EqualTo("missing_item")); Assert.That(registry.Count, Is.EqualTo(0)); }); } /// /// 验证依赖关系仅来自 contains 子 schema 时，热重载仍会追踪该依赖并在目标表破坏引用后回滚。 /// [Test] public async Task EnableHotReload_Should_Keep_Previous_State_When_Contains_Reference_Dependency_Breaks() { CreateConfigFile( "item/potion.yaml", """ id: potion name: Potion """); CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime dropItemIds: - potion """); CreateSchemaFile( "schemas/item.schema.json", """ { "type": "object", "required": ["id", "name"], "properties": { "id": { "type": "string" }, "name": { "type": "string" } } } """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name", "dropItemIds"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "dropItemIds": { "type": "array", "minContains": 1, "contains": { "type": "string", "x-gframework-ref-table": "item" }, "items": { "type": "string" } } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("item", "item", "schemas/item.schema.json", static config => config.Id) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); await loader.LoadAsync(registry); var reloadFailureTaskSource = new TaskCompletionSource<(string TableName, Exception Exception)>(TaskCreationOptions .RunContinuationsAsynchronously); var hotReload = loader.EnableHotReload( registry, onTableReloadFailed: (tableName, exception) => reloadFailureTaskSource.TrySetResult((tableName, exception)), debounceDelay: TimeSpan.FromMilliseconds(150)); try { CreateConfigFile( "item/potion.yaml", """ id: elixir name: Elixir """); var failure = await WaitForTaskWithinAsync(reloadFailureTaskSource.Task, TimeSpan.FromSeconds(5)); var diagnosticException = failure.Exception as ConfigLoadException; Assert.Multiple(() => { Assert.That(failure.TableName, Is.EqualTo("item")); Assert.That(diagnosticException, Is.Not.Null); Assert.That(diagnosticException!.Diagnostic.FailureKind, Is.EqualTo(ConfigLoadFailureKind.ReferencedKeyNotFound)); Assert.That(diagnosticException.Diagnostic.TableName, Is.EqualTo("monster")); Assert.That(diagnosticException.Diagnostic.ReferencedTableName, Is.EqualTo("item")); Assert.That(diagnosticException.Diagnostic.DisplayPath, Is.EqualTo("dropItemIds[0]")); Assert.That(diagnosticException.Diagnostic.RawValue, Is.EqualTo("potion")); Assert.That(registry.GetTable("item").ContainsKey("potion"), Is.True); Assert.That(registry.GetTable("monster").Get(1).DropItemIds, Is.EqualTo(new[] { "potion" })); }); } finally { hotReload.UnRegister(); } } /// /// 验证启用热重载后，配置文件内容变更会刷新已注册配置表。 /// [Test] public async Task EnableHotReload_Should_Update_Registered_Table_When_Config_File_Changes() { CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime hp: 10 """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "hp": { "type": "integer" } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); await loader.LoadAsync(registry); var reloadTaskSource = new TaskCompletionSource(TaskCreationOptions.RunContinuationsAsynchronously); var hotReload = loader.EnableHotReload( registry, onTableReloaded: tableName => reloadTaskSource.TrySetResult(tableName), debounceDelay: TimeSpan.FromMilliseconds(150)); try { CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime hp: 25 """); var tableName = await WaitForTaskWithinAsync(reloadTaskSource.Task, TimeSpan.FromSeconds(5)); Assert.Multiple(() => { Assert.That(tableName, Is.EqualTo("monster")); Assert.That(registry.GetTable("monster").Get(1).Hp, Is.EqualTo(25)); }); } finally { hotReload.UnRegister(); } } /// /// 验证热重载支持通过选项对象配置回调和防抖延迟。 /// [Test] public async Task EnableHotReload_Should_Support_Options_Object() { CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime hp: 10 """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "hp": { "type": "integer" } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable( new YamlConfigTableRegistrationOptions( "monster", "monster", static config => config.Id) { SchemaRelativePath = "schemas/monster.schema.json" }); var registry = new ConfigRegistry(); await loader.LoadAsync(registry); var reloadTaskSource = new TaskCompletionSource(TaskCreationOptions.RunContinuationsAsynchronously); var hotReload = loader.EnableHotReload( registry, new YamlConfigHotReloadOptions { OnTableReloaded = tableName => reloadTaskSource.TrySetResult(tableName), DebounceDelay = TimeSpan.FromMilliseconds(150) }); try { CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime hp: 25 """); var tableName = await WaitForTaskWithinAsync(reloadTaskSource.Task, TimeSpan.FromSeconds(5)); Assert.Multiple(() => { Assert.That(tableName, Is.EqualTo("monster")); Assert.That(registry.GetTable("monster").Get(1).Hp, Is.EqualTo(25)); }); } finally { hotReload.UnRegister(); } } /// /// 验证热重载会在启动前拒绝负的防抖延迟，避免后台延迟任务才暴露参数错误。 /// [Test] public void EnableHotReload_Should_Throw_When_Debounce_Delay_Is_Negative() { var loader = new YamlConfigLoader(_rootPath); var registry = new ConfigRegistry(); var exception = Assert.Throws(() => loader.EnableHotReload( registry, new YamlConfigHotReloadOptions { DebounceDelay = TimeSpan.FromMilliseconds(-1) })); Assert.That(exception!.ParamName, Is.EqualTo("options")); } /// /// 验证热重载失败时会保留旧表状态，并通过失败回调暴露诊断信息。 /// [Test] public async Task EnableHotReload_Should_Keep_Previous_Table_When_Schema_Change_Makes_Reload_Fail() { CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime hp: 10 """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "hp": { "type": "integer" } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); await loader.LoadAsync(registry); var reloadFailureTaskSource = new TaskCompletionSource<(string TableName, Exception Exception)>(TaskCreationOptions .RunContinuationsAsynchronously); var hotReload = loader.EnableHotReload( registry, onTableReloadFailed: (tableName, exception) => reloadFailureTaskSource.TrySetResult((tableName, exception)), debounceDelay: TimeSpan.FromMilliseconds(150)); try { CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name", "rarity"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "hp": { "type": "integer" }, "rarity": { "type": "string" } } } """); var failure = await WaitForTaskWithinAsync(reloadFailureTaskSource.Task, TimeSpan.FromSeconds(5)); var diagnosticException = failure.Exception as ConfigLoadException; Assert.Multiple(() => { Assert.That(failure.TableName, Is.EqualTo("monster")); Assert.That(failure.Exception.Message, Does.Contain("rarity")); Assert.That(diagnosticException, Is.Not.Null); Assert.That(diagnosticException!.Diagnostic.FailureKind, Is.EqualTo(ConfigLoadFailureKind.MissingRequiredProperty)); Assert.That(diagnosticException.Diagnostic.TableName, Is.EqualTo("monster")); Assert.That(diagnosticException.Diagnostic.DisplayPath, Is.EqualTo("rarity")); Assert.That(registry.GetTable("monster").Get(1).Hp, Is.EqualTo(10)); }); } finally { hotReload.UnRegister(); } } /// /// 验证当被引用表变更导致依赖表引用失效时，热重载会整体回滚受影响表。 /// [Test] public async Task EnableHotReload_Should_Keep_Previous_State_When_Dependency_Table_Breaks_Cross_Table_Reference() { CreateConfigFile( "item/potion.yaml", """ id: potion name: Potion """); CreateConfigFile( "monster/slime.yaml", """ id: 1 name: Slime dropItemId: potion """); CreateSchemaFile( "schemas/item.schema.json", """ { "type": "object", "required": ["id", "name"], "properties": { "id": { "type": "string" }, "name": { "type": "string" } } } """); CreateSchemaFile( "schemas/monster.schema.json", """ { "type": "object", "required": ["id", "name", "dropItemId"], "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "dropItemId": { "type": "string", "x-gframework-ref-table": "item" } } } """); var loader = new YamlConfigLoader(_rootPath) .RegisterTable("item", "item", "schemas/item.schema.json", static config => config.Id) .RegisterTable("monster", "monster", "schemas/monster.schema.json", static config => config.Id); var registry = new ConfigRegistry(); await loader.LoadAsync(registry); var reloadFailureTaskSource = new TaskCompletionSource<(string TableName, Exception Exception)>(TaskCreationOptions .RunContinuationsAsynchronously); var hotReload = loader.EnableHotReload( registry, onTableReloadFailed: (tableName, exception) => reloadFailureTaskSource.TrySetResult((tableName, exception)), debounceDelay: TimeSpan.FromMilliseconds(150)); try { CreateConfigFile( "item/potion.yaml", """ id: elixir name: Elixir """); var failure = await WaitForTaskWithinAsync(reloadFailureTaskSource.Task, TimeSpan.FromSeconds(5)); var diagnosticException = failure.Exception as ConfigLoadException; Assert.Multiple(() => { Assert.That(failure.TableName, Is.EqualTo("item")); Assert.That(failure.Exception.Message, Does.Contain("dropItemId")); Assert.That(diagnosticException, Is.Not.Null); Assert.That(diagnosticException!.Diagnostic.FailureKind, Is.EqualTo(ConfigLoadFailureKind.ReferencedKeyNotFound)); Assert.That(diagnosticException.Diagnostic.TableName, Is.EqualTo("monster")); Assert.That(diagnosticException.Diagnostic.ReferencedTableName, Is.EqualTo("item")); Assert.That(diagnosticException.Diagnostic.DisplayPath, Is.EqualTo("dropItemId")); Assert.That(diagnosticException.Diagnostic.RawValue, Is.EqualTo("potion")); Assert.That(registry.GetTable("item").ContainsKey("potion"), Is.True); Assert.That(registry.GetTable("monster").Get(1).DropItemId, Is.EqualTo("potion")); }); } finally { hotReload.UnRegister(); } } /// /// 创建测试用配置文件。 /// /// 相对根目录的文件路径。 /// 文件内容。 private void CreateConfigFile(string relativePath, string content) { var fullPath = Path.Combine(_rootPath, relativePath.Replace('/', Path.DirectorySeparatorChar)); var directory = Path.GetDirectoryName(fullPath); if (!string.IsNullOrEmpty(directory)) { Directory.CreateDirectory(directory); } File.WriteAllText(fullPath, content); } /// /// 创建测试用 schema 文件。 /// /// 相对根目录的文件路径。 /// 文件内容。 private void CreateSchemaFile(string relativePath, string content) { CreateConfigFile(relativePath, content); } /// /// 在限定时间内等待异步任务完成，避免文件监听测试无限挂起。 /// /// 任务结果类型。 /// 要等待的任务。 /// 超时时间。 /// 任务结果。 private static async Task WaitForTaskWithinAsync(Task task, TimeSpan timeout) { var completedTask = await Task.WhenAny(task, Task.Delay(timeout)); if (!ReferenceEquals(completedTask, task)) { Assert.Fail($"Timed out after {timeout} while waiting for file watcher notification."); } return await task; } /// /// 用于 YAML 加载测试的最小怪物配置类型。 /// private sealed class MonsterConfigStub { /// /// 获取或设置主键。 /// public int Id { get; set; } /// /// 获取或设置名称。 /// public string Name { get; set; } = string.Empty; /// /// 获取或设置生命值。 /// public int Hp { get; set; } } /// /// 用于浮点数 schema 校验测试的最小怪物配置类型。 /// private sealed class MonsterNumberConfigStub { /// /// 获取或设置主键。 /// public int Id { get; set; } /// /// 获取或设置浮点掉落率。 /// public double DropRate { get; set; } } /// /// 用于数组 schema 校验测试的最小怪物配置类型。 /// private sealed class MonsterConfigIntegerArrayStub { /// /// 获取或设置主键。 /// public int Id { get; set; } /// /// 获取或设置名称。 /// public string Name { get; set; } = string.Empty; /// /// 获取或设置掉落率列表。 /// public List DropRates { get; set; } = new(); } /// /// 用于嵌套对象 schema 校验测试的最小怪物配置类型。 /// private sealed class MonsterNestedConfigStub { /// /// 获取或设置主键。 /// public int Id { get; set; } /// /// 获取或设置名称。 /// public string Name { get; set; } = string.Empty; /// /// 获取或设置奖励对象。 /// public RewardConfigStub Reward { get; set; } = new(); } /// /// 表示嵌套奖励对象的测试桩类型。 /// private sealed class RewardConfigStub { /// /// 获取或设置金币数量。 /// public int Gold { get; set; } /// /// 获取或设置货币类型。 /// public string Currency { get; set; } = string.Empty; } /// /// 用于对象数组 schema 校验测试的怪物配置类型。 /// private sealed class MonsterPhaseArrayConfigStub { /// /// 获取或设置主键。 /// public int Id { get; set; } /// /// 获取或设置名称。 /// public string Name { get; set; } = string.Empty; /// /// 获取或设置阶段数组。 /// public IReadOnlyList Phases { get; set; } = Array.Empty(); } /// /// 用于 uniqueItems 比较键碰撞回归测试的最小配置类型。 /// private sealed class MonsterComparableEntryArrayConfigStub { /// /// 获取或设置主键。 /// public int Id { get; set; } /// /// 获取或设置待比较对象数组。 /// public List Entries { get; set; } = new(); } /// /// 用于对象数组 contains 子集匹配回归测试的最小配置类型。 /// private sealed class MonsterWeightedEntryArrayConfigStub { /// /// 获取或设置主键。 /// public int Id { get; set; } /// /// 获取或设置名称。 /// public string Name { get; set; } = string.Empty; /// /// 获取或设置对象数组条目。 /// public List Entries { get; set; } = new(); } /// /// 表示对象数组 contains 子集匹配回归测试中的条目元素。 /// private sealed class WeightedEntryConfigStub { /// /// 获取或设置条目标识。 /// public int Id { get; set; } /// /// 获取或设置权重。 /// public int Weight { get; set; } } /// /// 表示对象数组中的阶段元素。 /// private sealed class PhaseConfigStub { /// /// 获取或设置波次编号。 /// public int Wave { get; set; } /// /// 获取或设置怪物主键。 /// public string MonsterId { get; set; } = string.Empty; } /// /// 表示用于比较键碰撞回归测试的对象数组元素。 /// private sealed class ComparableEntryConfigStub { /// /// 获取或设置字段 A。 /// public string A { get; set; } = string.Empty; /// /// 获取或设置字段 B。 /// public string B { get; set; } = string.Empty; } /// /// 用于深层跨表引用测试的怪物配置类型。 /// private sealed class MonsterPhaseDropConfigStub { /// /// 获取或设置主键。 /// public int Id { get; set; } /// /// 获取或设置名称。 /// public string Name { get; set; } = string.Empty; /// /// 获取或设置阶段数组。 /// public List Phases { get; set; } = new(); } /// /// 表示带有掉落引用的阶段元素。 /// private sealed class PhaseDropConfigStub { /// /// 获取或设置波次编号。 /// public int Wave { get; set; } /// /// 获取或设置掉落物品主键。 /// public string DropItemId { get; set; } = string.Empty; } /// /// 用于跨表引用测试的最小物品配置类型。 /// private sealed class ItemConfigStub { /// /// 获取或设置主键。 /// public string Id { get; set; } = string.Empty; /// /// 获取或设置名称。 /// public string Name { get; set; } = string.Empty; } /// /// 用于单值跨表引用测试的怪物配置类型。 /// private sealed class MonsterDropConfigStub { /// /// 获取或设置主键。 /// public int Id { get; set; } /// /// 获取或设置名称。 /// public string Name { get; set; } = string.Empty; /// /// 获取或设置掉落物品主键。 /// public string DropItemId { get; set; } = string.Empty; } /// /// 用于数组跨表引用测试的怪物配置类型。 /// private sealed class MonsterDropArrayConfigStub { /// /// 获取或设置主键。 /// public int Id { get; set; } /// /// 获取或设置名称。 /// public string Name { get; set; } = string.Empty; /// /// 获取或设置掉落物品主键列表。 /// public List DropItemIds { get; set; } = new(); } /// /// 用于验证注册表一致性的现有配置类型。 /// /// 配置主键。 /// 配置名称。 private sealed record ExistingConfigStub(int Id, string Name); }