Jackson互转Data类与Map时NULL与"--"自动转换的实现问询

嘿，你这个需求Jackson完全能轻松搞定！你一开始尝试用@JsonSerialize和@JsonDeserialize的思路是对的，大概率是用法没踩对点子上，我来给你捋捋正确的实现方式，还有更省心的全局方案哦～

一、字段级转换（适合个别字段特殊处理） #

你之前可能把转换器加在了类上，而没有针对单个String类型字段配置，导致转换器没生效。正确姿势是给需要处理的字段单独绑定转换器：

1. 实现序列化转换器（实体null → Map的"--"）

public class NullToDashConverter extends StdConverter<String, String> {
    @Override
    public String convert(String value) {
        return value == null ? "--" : value;
    }
}

2. 实现反序列化转换器（Map的"--" → 实体null）

public class DashToNullConverter extends StdConverter<String, String> {
    @Override
    public String convert(String value) {
        return "--".equals(value) ? null : value;
    }
}

3. 在实体字段上绑定注解

public class MyData {
    @JsonSerialize(converter = NullToDashConverter.class)
    @JsonDeserialize(converter = DashToNullConverter.class)
    private String username;

    @JsonSerialize(converter = NullToDashConverter.class)
    @JsonDeserialize(converter = DashToNullConverter.class)
    private String email;

    // 其他字段、getter/setter省略
}

这样用ObjectMapper做互转时，这些字段的null和"--"就会自动完成转换。

二、全局配置（适合所有String字段统一处理） #

如果大部分String字段都需要这个规则，挨个加注解太麻烦，直接给ObjectMapper注册自定义模块就能全局生效：

ObjectMapper mapper = new ObjectMapper();
SimpleModule customModule = new SimpleModule();

// 全局序列化：所有String类型的null转成"--"
customModule.addSerializer(String.class, new StdSerializer<String>(String.class) {
    @Override
    public void serialize(String value, JsonGenerator gen, SerializerProvider provider) throws IOException {
        gen.writeString(value == null ? "--" : value);
    }
});

// 全局反序列化：所有"--"转成null
customModule.addDeserializer(String.class, new StdDeserializer<String>(String.class) {
    @Override
    public String deserialize(JsonParser p, DeserializationContext ctxt) throws IOException {
        String value = p.getText();
        return "--".equals(value) ? null : value;
    }
});

mapper.registerModule(customModule);

之后不管是mapper.convertValue(map, MyData.class)还是mapper.convertValue(myData, new TypeReference<Map<String, String>>(){})，所有String字段都会自动处理null和"--"的转换，比手动遍历Map更简洁，也更符合Jackson的设计逻辑。

为什么你之前的转换器没生效？ #

大概率是你把@JsonSerialize(converter=...)加在了类上，这种情况下转换器是处理整个MyData对象和目标类型（比如Map）的整体转换，而非单个字段的null值处理。只有绑定到具体String字段，或者全局注册针对String类型的序列化/反序列化器，才能触发你想要的逻辑。

内容的提问来源于stack exchange，提问作者lathspell