如何在Jackson与Spring绑定中无重复代码实现字符串转枚举

能否让Spring用@JsonProperty处理查询参数？ #

不行。Spring处理查询参数、路径参数这类非JSON格式的参数时，依赖的是自身的ConversionService转换体系；而@JsonProperty是Jackson的专属注解，仅在JSON序列化/反序列化流程中生效，两者属于不同的处理机制，无法直接复用该注解来完成查询参数的反序列化。

如何避免硬编码重复的字符串描述？ #

可以通过反射读取枚举常量上的@JsonProperty注解值，实现转换器的通用逻辑，既不用硬编码每个字符串，也无需给枚举额外添加描述字段。

改造后的转换器实现 #

@Component
public class StringToStateConverter implements Converter<String, State> {

    private final Map<String, State> jsonPropertyToEnumMap;

    // 初始化阶段通过反射构建注解值与枚举的映射
    public StringToStateConverter() {
        jsonPropertyToEnumMap = new HashMap<>();
        for (State state : State.values()) {
            try {
                JsonProperty annotation = state.getClass().getField(state.name()).getAnnotation(JsonProperty.class);
                if (annotation != null) {
                    jsonPropertyToEnumMap.put(annotation.value(), state);
                }
            } catch (NoSuchFieldException e) {
                // 理论上不会走到这里，因为枚举常量必然存在对应的字段
                throw new RuntimeException("Failed to get field for enum: " + state.name(), e);
            }
        }
    }

    @Override
    public State convert(String description) {
        // 直接从映射中匹配，找不到返回null（也可根据业务需求抛出参数非法异常）
        return jsonPropertyToEnumMap.getOrDefault(description, null);
    }
}

可选优化：支持大小写不敏感匹配 #

如果需要兼容客户端传入的大小写不一致的参数（比如at rest也能匹配At Rest），可以在初始化和转换时统一处理大小写：

// 构造方法中修改映射键为小写
jsonPropertyToEnumMap.put(annotation.value().toLowerCase(), state);

// convert方法中把输入转为小写再匹配
return jsonPropertyToEnumMap.getOrDefault(description.toLowerCase(), null);

这种方式下，所有客户端展示用的字符串都只在@JsonProperty注解中维护一次，转换器自动读取复用，彻底避免了代码重复，也符合你不想添加额外枚举字段的需求。

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