Jackson-databind中枚举类型的自定义序列化与反序列化方案

2025-06-20 11:05:39作者：董灵辛Dennis

引言

在使用Jackson-databind处理复杂JSON数据结构时，开发者经常会遇到需要自定义序列化/反序列化逻辑的场景。特别是在处理包含类型信息的协议数据时，如何正确处理枚举类型成为一个常见挑战。本文将深入探讨一种特殊的JSON格式处理方案，其中枚举类型需要以特定对象形式表示。

问题背景

在某些协议设计中，JSON数据会包含显式的类型信息（通过@class属性），但要求枚举类型以对象形式而非简单值形式呈现。典型数据结构如下：

{
  "@class": "com.protocol.Parameter",
  "id": "2",
  "value": {
    "@class": "com.protocol.BiometricType",
    "value": "FACE_ID"
  }
}

对应的Java模型为：

class Parameter {
    String id;
    Object value; // 可以是任意基本类型/对象/枚举
}

enum BiometricType {
    TOUCH_ID, FACE_ID
}

技术挑战

默认行为不足：Jackson默认将枚举序列化为简单字符串或索引值
类型信息处理：需要保留@class类型信息但排除基本类型和数组
格式一致性：要求枚举以对象形式而非数组形式呈现
双向转换：需要确保序列化和反序列化的对称性

解决方案

1. 自定义类型解析构建器

首先创建一个扩展自StdTypeResolverBuilder的构建器，控制哪些类型需要包含类型信息：

public class ObjectsAndEnumsTypeResolverBuilder extends StdTypeResolverBuilder {
    @Override
    public boolean useForType(JavaType t) {
        if (t.isPrimitive() || t.isArrayType()) {
            return false;
        }
        // 处理引用类型和最终类型
        while (t.isReferenceType()) {
            t = t.getReferencedType();
        }
        return !t.isFinal() && !TreeNode.class.isAssignableFrom(t.getRawClass());
    }
}

2. 枚举序列化处理

实现自定义的JsonSerializer来处理枚举序列化：

public class EnumAsObjectSerializer extends JsonSerializer<Enum> {
    @Override
    public void serializeWithType(Enum value, JsonGenerator gen, 
            SerializerProvider serializers, TypeSerializer typeSer) throws IOException {
        WritableTypeId typeIdDef = typeSer.writeTypePrefix(gen, 
                typeSer.typeId(value, JsonToken.START_OBJECT));
        gen.writeStringField("value", value.name());
        typeSer.writeTypeSuffix(gen, typeIdDef);
    }
}

3. 枚举反序列化处理

扩展AsPropertyTypeDeserializer实现自定义反序列化逻辑：

public class EnumAwareAsPropertyTypeDeserializer extends AsPropertyTypeDeserializer {
    @Override
    protected Object _deserializeTypedForId(JsonParser p, 
            DeserializationContext ctxt, TokenBuffer tb, String typeId) throws IOException {
        JsonDeserializer<Object> deser = _findDeserializer(ctxt, typeId);
        if (deser.handledType().isEnum()) {
            JsonNode node = ctxt.readTree(p);
            String value = node.get("value").asText();
            return Enum.valueOf((Class<Enum>) deser.handledType(), value);
        }
        return super._deserializeTypedForId(p, ctxt, tb, typeId);
    }
}

4. 完整配置方案

最终整合所有组件的配置方式：

ObjectMapper objectMapper = new ObjectMapper()
    .setDefaultTyping(new ObjectsAndEnumsTypeResolverBuilder("@class"))
    .registerModule(new SimpleModule()
        .addSerializer(Enum.class, new EnumAsObjectSerializer()));