jackson null值 序列化

jackson null值 序列化

将 null 转换为 字符串

在Jackson中，序列化时将null值转换为字符串（例如，输出为"null"而不是忽略或输出null）通常不是标准行为，但可以通过自定义序列化处理器来实现。

以下是一个简单的示例，演示如何创建一个自定义JsonSerializer，用于将所有类型的null值序列化为字符串 "null"：

import com.fasterxml.jackson.core.JsonGenerator;
import com.fasterxml.jackson.databind.JsonSerializer;
import com.fasterxml.jackson.databind.SerializerProvider;
import com.fasterxml.jackson.databind.ser.std.StdSerializer;

import java.io.IOException;

public class NullToStringSerializer extends StdSerializer<Object> {

    public NullToStringSerializer() {
        // 泛型指定为Object，以便可以处理所有类型的null值
        this(null);
    }

    protected NullToStringSerializer(Class<Object> t) {
        super(t);
    }

    @Override
    public void serialize(Object value, JsonGenerator gen, SerializerProvider provider) throws IOException {
        if (value == null) {
            gen.writeString("null");
        } else {
            // 如果不是null，则调用默认的序列化器
            provider.defaultSerializeValue(value, gen);
        }
    }
}

全局注册 null 序列化为 空字符串

然后，在配置ObjectMapper时注册这个自定义序列化器：

import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.module.SimpleModule;

public class JacksonConfig {

    public ObjectMapper configureObjectMapper(ObjectMapper objectMapper) {
        SimpleModule module = new SimpleModule();
        module.addSerializer(Object.class, new NullToStringSerializer());
        objectMapper.registerModule(module);

        return objectMapper;
    }
}

请注意，这个配置会影响所有类型的null值，可能并不总是理想的结果。如果你只希望针对特定类型的字段这么做，可以修改自定义序列化器，使其只处理特定类型的null值，或者通过@JsonSerialize注解在特定类或属性上使用自定义的序列化器。

另外，这个做法在某些情况下可能会导致JSON结果不符合预期，特别是在JSON解析时，"null"字符串通常不会被解析为null值，而是作为一个包含字符串"null"的对象。所以在实际应用中要谨慎对待此类需求，确保符合应用程序的设计规范。

指定字段的序列化

在Jackson中，可以通过 @JsonSerialize 注解来指定字段的序列化行为。例如，你可以使用它来指定如何序列化 null 值：

要在特定字段上使用NullToStringSerializer，可以通过在该字段上使用@JsonSerialize注解来指定。假设你有一个类MyClass，其中有一个字段myField，你希望当myField为null时，在序列化时输出为字符串"null"，可以这样做：

import com.fasterxml.jackson.databind.annotation.JsonSerialize;
import com.yourpackage.NullToStringSerializer; // 请替换为你的NullToStringSerializer全限定名

public class MyClass {

    private String myField;

    // ... 其他字段和方法 ...

    // 使用@JsonSerialize注解指定自定义序列化器
    @JsonSerialize(using = NullToStringSerializer.class)
    public String getMyField() {
        return myField;
    }

    // ... setter 方法 ...
}

这里的NullToStringSerializer需要是你之前定义的那个实现类。如此一来，只有myField字段在序列化为JSON时，当其值为null时才会被转换为字符串"null"。

！注意:

当默认null 序列化 不输出时，@JsonSerialize(using = NullToStringSerializer.class) 不生效

null值 序列化时 默认不显示

Jackson 默认在序列化时，对于对象的属性值为 null 的情况不会将它们写入 JSON 输出。如果你希望改变这一行为，可以使用 @JsonInclude 注解来控制是否包含 null 值：

import com.fasterxml.jackson.annotation.JsonInclude;

public class User {
    @JsonInclude(JsonInclude.Include.NON_NULL) // 不包含 null 值
    private String name;

    @JsonInclude(JsonInclude.Include.ALWAYS) // 总是包含，即使值为 null
    private Integer age;

    // 构造函数、getter 和 setter 省略
}

在这个例子中：

• name 字段只有当它的值不为 null 时才会被序列化到 JSON 中。
• age 字段无论其值是否为 null 都会被序列化到 JSON 中。

如果你想全局更改这个行为（即所有字段都按同样的规则处理），可以在 ObjectMapper 上设置全局默认值：

import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.SerializationFeature;

ObjectMapper objectMapper = new ObjectMapper();
objectMapper.setSerializationInclusion(JsonInclude.Include.NON_NULL); // 或 JsonInclude.Include.ALWAYS

// 现在，使用此 objectMapper 进行序列化的任何对象都将遵循指定的规则
String json = objectMapper.writeValueAsString(user);

这样配置后，所有的 null 值要么都会被忽略（NON_NULL），要么都会被输出（ALWAYS）。