Sparkdo.Json.SystemTextJson 1.0.1

Sparkdo.Json.SystemTextJson

Sparkdo SystemTextJson模块，提供基于System.Text.Json的JSON序列化和反序列化功能。

功能特性

• 基于System.Text.Json的高性能JSON序列化
• 自定义JSON转换器支持
• 日期时间标准化处理
• 枚举序列化支持
• 扩展属性序列化支持
• 与 Sparkdo 框架无缝集成

安装

<PackageReference Include="Sparkdo.Json.SystemTextJson" Version="x.x.x" />

核心组件

JSON序列化器

• SparkdoSystemTextJsonSerializer: SystemTextJson序列化器实现

JSON转换器

• ObjectToInferredTypesConverter: 对象到推断类型转换器
• SparkdoDateTimeConverter: 日期时间转换器
• SparkdoNullableDateTimeConverter: 可空日期时间转换器
• SparkdoStringToBooleanConverter: 字符串到布尔值转换器
• SparkdoStringToEnumConverter: 字符串到枚举转换器
• SparkdoStringToEnumFactory: 字符串到枚举转换器工厂
• SparkdoStringToGuidConverter: 字符串到Guid转换器
• SparkdoNullableStringToGuidConverter: 可空字符串到Guid转换器

JSON修饰符

• SparkdoDateTimeConverterModifier: 日期时间转换器修饰符
• SparkdoIgnorePropertiesModifiers: 忽略属性修饰符
• SparkdoIncludeExtraPropertiesModifiers: 包含额外属性修饰符
• SparkdoIncludeNonPublicPropertiesModifiers: 包含非公共属性修饰符

使用方法

基本序列化

// 注入JSON序列化器
public class MyService
{
    private readonly IJsonSerializer _jsonSerializer;
    
    public MyService(IJsonSerializer jsonSerializer)
    {
        _jsonSerializer = jsonSerializer;
    }
    
    public string SerializeObject()
    {
        var obj = new MyObject { Name = "Test", Value = 123 };
        return _jsonSerializer.Serialize(obj);
    }
    
    public MyObject DeserializeObject(string json)
    {
        return _jsonSerializer.Deserialize<MyObject>(json);
    }
}

自定义转换器

// 添加自定义转换器
public override void Configure(IConfigureContext context)
{
    context.Services.AddOptions<SparkdoSystemTextJsonSerializerOptions>()
        .Configure(options =>
        {
            options.JsonSerializerOptions.Converters.Add(new MyCustomConverter());
        });
}

使用修饰符

// 配置JSON修饰符
public override void Configure(IConfigureContext context)
{
    context.Services.AddOptions<SparkdoSystemTextJsonSerializerModifiersOptions>()
        .Configure(options =>
        {
            options.Modifiers.Add(new MyCustomModifier().CreateModifyAction());
        });
}

扩展性

该库提供了完整的SystemTextJson功能实现，可以通过以下方式扩展：

1. 实现自定义的 JsonConverter 来提供特定类型的序列化逻辑
2. 实现自定义的 JsonConverterFactory 来提供转换器工厂
3. 实现自定义的修饰符来修改序列化行为
4. 实现自定义的JSON序列化选项

代码结构说明

本项目包含以下主要组件：

JSON序列化核心

• SparkdoSystemTextJsonSerializer: JSON序列化器实现，提供序列化和反序列化功能
• SparkdoSystemTextJsonSerializerOptions: JSON序列化选项，配置序列化器行为
• SparkdoDefaultJsonTypeInfoResolver: 默认JSON类型信息解析器

JSON转换器

• ObjectToInferredTypesConverter: 对象到推断类型转换器，处理动态类型
• SparkdoDateTimeConverter: 日期时间转换器，支持时区标准化
• SparkdoNullableDateTimeConverter: 可空日期时间转换器
• SparkdoStringToBooleanConverter: 字符串到布尔值转换器
• SparkdoStringToEnumConverter: 字符串到枚举转换器
• SparkdoStringToEnumFactory: 字符串到枚举转换器工厂
• SparkdoStringToGuidConverter: 字符串到Guid转换器
• SparkdoNullableStringToGuidConverter: 可空字符串到Guid转换器

JSON修饰符

• SparkdoDateTimeConverterModifier: 日期时间转换器修饰符，为日期时间属性应用自定义转换器
• SparkdoIgnorePropertiesModifiers: 忽略属性修饰符，忽略指定属性的序列化
• SparkdoIncludeExtraPropertiesModifiers: 包含额外属性修饰符，处理扩展属性的序列化
• SparkdoIncludeNonPublicPropertiesModifiers: 包含非公共属性修饰符，处理非公共属性的序列化

所有公共接口和类都添加了详细的 XML 文档注释，便于开发者理解和使用。