GFramework/GFramework.Game/Config/YamlConfigStringFormatConstraint.cs
gewuyou f5f2c251e5 fix(pr-review): 修复当前评审中仍然成立的问题
- 修复 Mediator 集成测试中的阻塞等待、缓存竞态与共享状态原子性问题

- 补充 YamlConfig 运行时模型的构造期约束与 exception XML 文档

- 新增 模型契约回归测试并更新 analyzer warning reduction 恢复文档
2026-04-29 09:19:24 +08:00

36 lines
1.3 KiB
C#

namespace GFramework.Game.Config;
/// <summary>
/// 表示一个已归一化的字符串 format 约束。
/// 该模型同时保留 schema 原文与共享枚举,方便诊断信息稳定展示,又避免运行时校验反复解析字符串。
/// </summary>
internal sealed class YamlConfigStringFormatConstraint
{
/// <summary>
/// 初始化字符串 format 约束模型。
/// </summary>
/// <param name="schemaName">schema 中声明的 format 名称。</param>
/// <param name="kind">归一化后的共享 format 枚举。</param>
/// <exception cref="ArgumentNullException">当 <paramref name="schemaName"/> 为 <see langword="null" /> 时抛出。</exception>
/// <exception cref="ArgumentException">当 <paramref name="schemaName"/> 为空或仅包含空白字符时抛出。</exception>
public YamlConfigStringFormatConstraint(
string schemaName,
YamlConfigStringFormatKind kind)
{
ArgumentException.ThrowIfNullOrWhiteSpace(schemaName);
SchemaName = schemaName;
Kind = kind;
}
/// <summary>
/// 获取 schema 中声明的 format 名称。
/// </summary>
public string SchemaName { get; }
/// <summary>
/// 获取归一化后的共享 format 枚举。
/// </summary>
public YamlConfigStringFormatKind Kind { get; }
}