首页
/ ASP.NET Boilerplate 中 System.Text.Json 处理继承类型的解决方案

ASP.NET Boilerplate 中 System.Text.Json 处理继承类型的解决方案

2025-05-19 23:28:14作者:彭桢灵Jeremy

问题背景

在 ASP.NET Boilerplate 项目中,当开发者从 Newtonsoft.Json 迁移到 System.Text.Json 时,可能会遇到一个常见问题:JSON 序列化无法正确处理接口继承和多态类型。具体表现为,当返回包含接口类型集合的 DTO 时,System.Text.Json 默认只会序列化接口定义的属性,而忽略了实现类的特有属性。

问题重现

考虑以下数据模型结构:

public class TestResutDto : EntityDto
{
    public DateTime TestDate { get; set; }
    public IEnumerable<ISubItem> SubItems { get; set; }
}

public interface ISubItem
{
    int Prop1 { get; set; }
    bool Prop2 { get; set; }
}

public class SubItemModel1 : ISubItem
{
    public int Prop1 { get; set; }
    public bool Prop2 { get; set; }
    public int PropModel1Prop1 { get; set; }
    public bool PropModel1Prop2 { get; set; }
}

public class SubItemModel2 : ISubItem
{
    public int Prop1 { get; set; }
    public bool Prop2 { get; set; }
    public int PropModel2Prop1 { get; set; }
    public bool PropModel2Prop2 { get; set; }
}

使用 System.Text.Json 时,返回的 JSON 结果会丢失实现类的特有属性,而 Newtonsoft.Json 则能正确序列化所有属性。

原因分析

System.Text.Json 在设计上更加注重性能和安全性,因此在默认情况下不支持多态序列化。这与 Newtonsoft.Json 的行为不同,后者会自动处理继承和多态场景。

解决方案

为了解决这个问题,我们需要为 System.Text.Json 实现一个自定义的多态转换器(PolymorphicConverter)。这个转换器能够识别接口类型,并在序列化时正确处理其具体实现类的所有属性。

实现多态转换器

public class PolymorphicConverter<T> : JsonConverter<T>
{
    public override bool CanConvert(Type typeToConvert)
    {
        return typeof(T).IsAssignableFrom(typeToConvert);
    }

    public override T Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
    {
        throw new NotImplementedException("Deserialization is not implemented for polymorphic types.");
    }

    public override void Write(Utf8JsonWriter writer, T value, JsonSerializerOptions options)
    {
        if (value == null)
        {
            writer.WriteNullValue();
            return;
        }

        var actualType = value.GetType();

        var runtimeOptions = new JsonSerializerOptions
        {
            PropertyNamingPolicy = options.PropertyNamingPolicy,
            DefaultIgnoreCondition = options.DefaultIgnoreCondition
        };

        foreach (var converter in options.Converters)
        {
            if (converter.GetType() != typeof(PolymorphicConverter<T>))
            {
                runtimeOptions.Converters.Add(converter);
            }
        }

        JsonSerializer.Serialize(writer, value, actualType, runtimeOptions);
    }
}

配置使用转换器

在 ASP.NET Core 的 Startup 类中配置 JsonOptions 时,添加这个自定义转换器:

services.AddControllers()
    .AddJsonOptions(options =>
    {
        options.JsonSerializerOptions.PropertyNamingPolicy = JsonNamingPolicy.CamelCase;
        // 添加其他必要的转换器...
        options.JsonSerializerOptions.Converters.Add(new PolymorphicConverter<ISubItem>());
    });

技术原理

这个解决方案的核心在于:

  1. 运行时类型识别:通过 value.GetType() 获取对象实际的运行时类型,而不是使用编译时类型。

  2. 选项继承:创建新的 JsonSerializerOptions 实例,继承父选项的命名策略和忽略条件,确保序列化行为一致。

  3. 转换器过滤:复制其他转换器到新选项中,但排除当前的多态转换器,避免无限递归。

  4. 类型特定序列化:使用 JsonSerializer.Serialize 的重载版本,显式指定实际类型进行序列化。

注意事项

  1. 反序列化限制:当前实现仅支持序列化,反序列化需要额外实现。

  2. 性能考虑:每次序列化创建新的 JsonSerializerOptions 实例会有轻微性能开销,但对于大多数应用场景可以接受。

  3. 复杂类型处理:如果继承体系中有更复杂的场景,可能需要进一步扩展转换器逻辑。

结论

通过实现自定义的 PolymorphicConverter,我们可以在 ASP.NET Boilerplate 项目中使 System.Text.Json 达到与 Newtonsoft.Json 相似的多态序列化行为。这种解决方案既保持了 System.Text.Json 的性能优势,又提供了必要的灵活性来处理复杂的继承和多态场景。

登录后查看全文
热门项目推荐
相关项目推荐

项目优选

收起
kernelkernel
deepin linux kernel
C
22
6
docsdocs
OpenHarmony documentation | OpenHarmony开发者文档
Dockerfile
163
2.05 K
nop-entropynop-entropy
Nop Platform 2.0是基于可逆计算理论实现的采用面向语言编程范式的新一代低代码开发平台,包含基于全新原理从零开始研发的GraphQL引擎、ORM引擎、工作流引擎、报表引擎、规则引擎、批处理引引擎等完整设计。nop-entropy是它的后端部分,采用java语言实现,可选择集成Spring框架或者Quarkus框架。中小企业可以免费商用
Java
8
0
leetcodeleetcode
🔥LeetCode solutions in any programming language | 多种编程语言实现 LeetCode、《剑指 Offer(第 2 版)》、《程序员面试金典(第 6 版)》题解
Java
60
16
ohos_react_nativeohos_react_native
React Native鸿蒙化仓库
C++
199
279
RuoYi-Vue3RuoYi-Vue3
🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
951
557
ShopXO开源商城ShopXO开源商城
🔥🔥🔥ShopXO企业级免费开源商城系统,可视化DIY拖拽装修、包含PC、H5、多端小程序(微信+支付宝+百度+头条&抖音+QQ+快手)、APP、多仓库、多商户、多门店、IM客服、进销存,遵循MIT开源协议发布、基于ThinkPHP8框架研发
JavaScript
96
15
apintoapinto
基于golang开发的网关。具有各种插件,可以自行扩展,即插即用。此外,它可以快速帮助企业管理API服务,提高API服务的稳定性和安全性。
Go
22
0
金融AI编程实战金融AI编程实战
为非计算机科班出身 (例如财经类高校金融学院) 同学量身定制,新手友好,让学生以亲身实践开源开发的方式,学会使用计算机自动化自己的科研/创新工作。案例以量化投资为主线,涉及 Bash、Python、SQL、BI、AI 等全技术栈,培养面向未来的数智化人才 (如数据工程师、数据分析师、数据科学家、数据决策者、量化投资人)。
Python
77
70
giteagitea
喝着茶写代码!最易用的自托管一站式代码托管平台,包含Git托管,代码审查,团队协作,软件包和CI/CD。
Go
17
0