您如何修改未注释枚举的默认枚举（反）序列化，但在 Jackson 中保留标准行为（@JsonProperty/@JsonValue/...）？

Question

目前 jackson (uncustomized) 像这样序列化枚举：

1. 如果有@JsonProperty或@JsonValue ，它们用于派生序列化名称
2. 否则，执行标准序列化：可能使用 index 或toString() （取决于映射器设置），或默认调用.name()

对于反序列化，是这样的：

1. 如果有@JsonProperty 、 @JsonValue或@JsonCreator ，它们会影响反序列化
2. 否则，使用标准反序列化来反映序列化。

我想在这两种情况下都保留第 1 项（即仍然支持所有 3 个注释，如果我遗漏了一些注释，或者更多），但修改“默认情况”的行为：例如，始终将枚举序列化为.name().toLowercase()如果没有注释。

我可以使用addSerializer() 、 addDeserializer()或 (de)serializer 修改机制，但这些都不允许简单而优雅的解决方案。 我所能发明的只是从 jackson 复制/粘贴大量代码（这是丑陋和脆弱的），或者，使用修改机制，内省模拟 jackson 涉及的逻辑的枚举类，以识别“默认”逻辑何时适用的情况，然后使用我的“小写”策略。

有没有更好的方法来修改“默认”序列化策略，同时仍然保留所有“非默认”情况？

Answer 1

您可以插入一个新的AnnotationIntrospector，其findEnumValues方法会更改枚举名称。 该EnumRenamingModule从therapi-JSON-RPC项目使用了这种技术。 （免责声明：这是我的宠物项目。）这是从 GitHub 存储库复制的代码：

package com.github.therapi.jackson.enums;

import com.fasterxml.jackson.databind.Module;
import com.fasterxml.jackson.databind.introspect.NopAnnotationIntrospector;
import com.fasterxml.jackson.databind.module.SimpleModule;

/**
 * Customizes the way Jackson serializes enums.
 */
public abstract class EnumRenamingModule extends SimpleModule {
    private boolean overrideExistingNames;

    public EnumRenamingModule() {
        super("therapi-enum-renaming");
    }

    /**
     * Configures the module to clobber any enum names set by
     * a previous annotation introspector.
     */
    public EnumRenamingModule overrideExistingNames() {
        this.overrideExistingNames = true;
        return this;
    }

    @Override
    public void setupModule(Module.SetupContext context) {
        super.setupModule(context);
        context.insertAnnotationIntrospector(new EnumNamingAnnotationIntrospector());
    }

    private class EnumNamingAnnotationIntrospector extends NopAnnotationIntrospector {
        public String[] findEnumValues(Class<?> enumType, Enum<?>[] enumValues, String[] names) {
            for (int i = 0; i < enumValues.length; i++) {
                if (names[i] == null || overrideExistingNames) {
                    names[i] = EnumRenamingModule.this.getName(enumValues[i]);
                }
            }
            return names;
        }
    }

    /**
     * @param value the enum value to inspect
     * @return the JSON name for the enum value, or {@code null} to delegate to the next introspector
     */
    protected abstract String getName(Enum<?> value);
}

创建一个子类来做你想要的转换：

public class LowerCaseEnumModule extends EnumRenamingModule {
    @Override protected String getName(Enum<?> value) {
        return value.name().toLowerCase(Locale.ROOT);
    }
}

并使用您的 ObjectMapper 注册它：

ObjectMapper mapper = new ObjectMapper();
mapper.registerModule(new LowerCaseEnumModule());

Answer 2

注解@JsonCreator用于反序列化（它是一个静态工厂）。
注解@JsonValue用于序列化。
给定的例子对我有用：

class MyException extends RuntimeException {}
enum MyEnum {
    TEST;

    private final String value;

    private MyEnum() {
        this.value = this.name().toLowerCase();
    }

    @JsonValue
    public final String value() {
        return this.value;
    }

    @JsonCreator
    public static MyEnum forValue(String value) {
        return Arrays.stream(MyEnum.values()).filter(myEnum -> myEnum.value.equals(value)).findFirst().orElseThrow(MyException::new);
    }
}