5

在 asp.net core 3.1 中,使用新的 System.Text.Json,我试图在 appsettings 部分使用自定义 JsonConverter。手动序列化/反序列化可以很好地尊重转换器,但通过选项模式从 appSettings 读取则不行。这是我所拥有的:

Json 转换器。为简单起见,这只是将字符串值转换为大写:

    public class UpperConverter : JsonConverter<string>
    {
        public override string Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) =>
            reader.GetString().ToUpper();

        public override void Write(Utf8JsonWriter writer, string value, JsonSerializerOptions options) =>
            writer.WriteStringValue(value == null ? "" : value.ToUpper());
    }

appsettings 类,在字符串属性上声明转换器:

    public class MyOptions
    {
        public const string Name = "MyOptions";
        [JsonConverter(typeof(UpperConverter))]
        public string MyString { get; set; }
    }

Startup.cs 更改以准备一切:

       public void ConfigureServices(IServiceCollection services)
        {
            services.AddControllersWithViews()
                .AddJsonOptions(options =>
                {
                    options.JsonSerializerOptions.Converters.Add(new UpperConverter());
                });

            services.Configure<MyOptions>(Configuration.GetSection(MyOptions.Name));
        }

当我将一个IOptions<MyOptions>注入 HomeController 时,它会读取一个小写的值。如果我手动执行JsonSerializer.Deserialize<MyOptions>("{\"MyString\":\"lowercase_manual\"}"),我会得到一个大写字符串。即使我删除了 JsonSerializerOptions 的启动声明。

有谁知道如何让 appsettings / options 模式尊重 JsonConverter?我必须在其他地方声明 JsonSerializerOptions 吗?谢谢。

4

1 回答 1

6

重要的是要理解选项模式是作为两个独立的步骤实现的:从配置源读取数据,然后将该数据绑定到强类型对象。

读取步骤由各种配置提供程序实现,其中只有一个是 JSON。您可能期望 JSON 提供程序会尊重您JsonConverter的 .

那么,绑定步骤似乎是该在意的地方JsonConverter。但是这一步故意完全不知道任何特定的配置提供者,因为它只是从提供者那里接收通用格式的数据,而它故意对. 因此,它不会关心特定于 JSON 的转换器。

然而,它会关心更多的通用转换器来处理其通用数据,幸运的是.NET 已经为此内置了基础设施:类型转换器。这些几乎从一开始就在 .NET 中,虽然它们很旧,但它们非常简单、可维护,并且确实非常适合这种特定场景。

如何实现类型转换器的完整示例超出了此答案的范围,但要点是您从 派生,覆盖适当的方法,并通过指向您的实现TypeConverter来装饰要转换的类。那么它应该都是 Just Work™。TypeConverterAttributeTypeConverter


您提供的示例需要注意的是,您实际上并未尝试转换任何内容,而是尝试转换字符串,并且显然TypeConverter不会调用 a ,因为来自配置提供程序的源值是字符串,而您的选项类的目标类型也是一个字符串。

您可以做的是创建一个新类,该类包装一个字符串以将其强制为大写:

public class UppercaseString
{
    public string Value { get; }

    public UppercaseString(string str)
    {
        Value = str.ToUpper();
    }

    public static implicit operator string(UppercaseString upper)
        => upper.Value;
}

然后更改您的选项类以使用该包装器:

public class MyOptions
{
    public const string Name = "MyOptions";

    public UppercaseString MyString { get; set; }
}

最后,实现TypeConverter从 转换string为 的a UppercaseString

请注意implicit operator string- 这允许您在任何预期UppercaseString标准的地方使用 a的定义string,这样您就不必更改MyOptions.MyString引用MyOptions.MyString.Value.

于 2020-10-09T14:40:00.573 回答