首页
/ Newtonsoft.Json 中如何动态忽略 JsonProperty 属性名配置

Newtonsoft.Json 中如何动态忽略 JsonProperty 属性名配置

2025-05-21 12:27:59作者:鲍丁臣Ursa

在 Newtonsoft.Json 的实际应用中,我们经常会遇到需要动态控制 JSON 属性名称映射的场景。本文将深入探讨如何通过自定义 ContractResolver 来实现忽略 JsonProperty 属性配置的技术方案。

问题背景

在 JSON 序列化/反序列化过程中,我们通常会使用 [JsonProperty] 特性来指定属性在 JSON 中的名称。例如:

public class UserEvent
{
    [JsonProperty("s")] 
    public string ScheduleId { get; set; }
    
    [JsonProperty("i")] 
    public string EventId { get; set; }
}

默认情况下,这个类会被序列化为类似 {"s": "value1", "i": "value2"} 的 JSON 格式。但有时我们可能需要临时忽略这些自定义名称配置,让属性使用其原始名称进行序列化。

解决方案:自定义 ContractResolver

Newtonsoft.Json 提供了强大的扩展点 ContractResolver,我们可以通过继承 DefaultContractResolver 并重写其 CreateProperty 方法来实现自定义属性名称映射逻辑。

实现步骤

  1. 创建自定义 ContractResolver:
public class IgnoreJsonPropertyResolver : DefaultContractResolver
{
    protected override JsonProperty CreateProperty(MemberInfo member, MemberSerialization memberSerialization)
    {
        // 首先获取基类的属性配置
        JsonProperty property = base.CreateProperty(member, memberSerialization);
        
        // 将属性名重置为成员名称
        property.PropertyName = member.Name;
        
        return property;
    }
}
  1. 在序列化/反序列化时使用自定义解析器:
var settings = new JsonSerializerSettings
{
    ContractResolver = new IgnoreJsonPropertyResolver()
};

// 序列化
string json = JsonConvert.SerializeObject(userEvent, settings);

// 反序列化
var obj = JsonConvert.DeserializeObject<UserEvent>(json, settings);

进阶用法

如果需要更精细的控制,比如只对特定类型的属性忽略 JsonProperty 配置,可以修改 CreateProperty 方法:

protected override JsonProperty CreateProperty(MemberInfo member, MemberSerialization memberSerialization)
{
    JsonProperty property = base.CreateProperty(member, memberSerialization);
    
    // 仅对UserEvent类忽略JsonProperty配置
    if (property.DeclaringType == typeof(UserEvent))
    {
        property.PropertyName = member.Name;
    }
    
    return property;
}

应用场景

这种技术特别适用于以下情况:

  1. 需要临时切换 JSON 格式的 API 兼容场景
  2. 开发调试时希望看到原始属性名的 JSON 输出
  3. 在单元测试中验证对象结构
  4. 需要与不使用 Newtonsoft.Json 的系统交互时

注意事项

  1. 此方法会全局影响所有属性的名称映射,使用时需谨慎
  2. 性能考虑:自定义 ContractResolver 会略微增加序列化开销
  3. 对于大型项目,建议将自定义解析器设计为可配置的

通过这种灵活的方式,开发者可以在不修改原始类定义的情况下,动态控制 JSON 属性名的映射行为,为系统提供更大的灵活性。

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