Dotnet选项模式的全球化与本地化

前言

选项模式 Options 是Dotnet非常重要的一个基础概念，在应用开发过程中很多Service都关联着其 Options。

我们有个AI Agent使用 Options 来配置AI的一部分功能，原需求是只需要支持英文语言，现需求改为要支持其它共6种语言。我决定开发一个类库，使 Options 完整地得到多语言支持。

设计思路

1 具体语言的Configuration

使用OptionsLocalization:{OptionsName}:{culture}做为配置的key前缀，例如AIOptions选项的ModelId属性，在配置里的zh-CN对应的key是OptionsLocalization:AIOptions:zh-CN:ModelId

2 简化的 json 配置文件

未简化前的 AIOptions/zh-CN.json

/* by yours.tools - online tools website : yours.tools/zh/calctime.html */
{
	"OptionsLocalization": {
		"AIOptions": {
			"zh-CN": {
				"ModelId": "gemini2.5",
                "Prompt": "你好世界"
			}
		}
	}
}

期待简化后的 AIOptions/zh-CN.json

/* by yours.tools - online tools website : yours.tools/zh/calctime.html */
{	 
	"ModelId": "gemini2.5",
    "Prompt": "你好世界"
}

3 语言区域别名化的 Options

// 选项绑定到别名化的配置
// 如果是默认语言区域，则注册成别名为Options.DefaultName
services.Configure<AIOptions>("zh-CN", configuration.GetSection("OptionsLocalization:AIOptions:zh-CN"));

// 使用别名获取选项
IOptionsMonitor<AIOptions>().Get("zh-CN");

4 支持父语言区域回退

假设注册"en"默认语言和zh语言

services.Configure<AIOptions>("zh", zhSection);
services.Configure<AIOptions>(Options.DefaultName, enSection);

现在前端的语言区域为"zh-CN"，IOptionsMonitor<AIOptions>().Get("zh-CN")会存在以下问题：

1. zh-CN不存在，要回退到zh-Hans
2. zh-Hans不存在，要回退到zh
3. zh下的ModelId没有配置项，要回退使用默认的en下的ModelId项

我们需要实现自定义的IOptionsFactory<TOptions>，把指定的语言区域别名的AIOptions构建正确。

sealed class CultureOptionsFactory<TOptions> : IOptionsFactory<TOptions>
     where TOptions : class, new()
{
    private readonly IConfigureOptions<TOptions>[] _setups;
    private readonly IPostConfigureOptions<TOptions>[] _postConfigures;
    private readonly IValidateOptions<TOptions>[] _validations;

    public CultureOptionsFactory(IEnumerable<IConfigureOptions<TOptions>> setups, IEnumerable<IPostConfigureOptions<TOptions>> postConfigures, IEnumerable<IValidateOptions<TOptions>> validations)
    {
        _setups = setups as IConfigureOptions<TOptions>[] ?? setups.ToArray();
        _postConfigures = postConfigures as IPostConfigureOptions<TOptions>[] ?? postConfigures.ToArray();
        _validations = validations as IValidateOptions<TOptions>[] ?? validations.ToArray();
    }


    public TOptions Create(string name)
    {
        var defaultOptions = this.CreateOptions(Options.DefaultName, default);
        if (string.IsNullOrEmpty(name))
        {
            return defaultOptions;
        }

        var culture = CultureInfo.GetCultureInfo(name);
        var cultureStack = new Stack<CultureInfo>();

        cultureStack.Push(culture);
        while (culture.Parent.Name.AsSpan().Length > 0)
        {
            culture = culture.Parent;
            cultureStack.Push(culture);
        }

        var options = defaultOptions;
        while (cultureStack.TryPop(out var next))
        {
            options = this.CreateOptions(next.Name, options);
        }

        return options;
    }


    private TOptions CreateOptions(string name, TOptions? options)
    {
        if (options == null)
        {
            options = new TOptions();
        }

        foreach (var setup in _setups)
        {
            if (setup is IConfigureNamedOptions<TOptions> namedSetup)
            {
                namedSetup.Configure(name, options);
            }
            else if (name == Options.DefaultName)
            {
                setup.Configure(options);
            }
        }

        foreach (var post in _postConfigures)
        {
            post.PostConfigure(name, options);
        }

        if (_validations != null)
        {
            var failures = new List<string>();
            foreach (var validate in _validations)
            {
                var result = validate.Validate(name, options);
                if (result != null && result.Failed)
                {
                    failures.AddRange(result.Failures);
                }
            }
            if (failures.Count > 0)
            {
                throw new OptionsValidationException(name, typeof(TOptions), failures);
            }
        }

        return options;
    }
}

工程实现

                            -----------------
                            |               |
 JsonConfigurationSource -> | Configuration |  -> IOptionsLocalizer<TOptions>
                            |               |
                            -----------------

项目地址：
OptionsLocalization