如何用Jackson将多种JSON格式解析为同一SpeechAction对象？

我来帮你解决这个需求——让Jackson同时支持单字符串和数组两种格式的speech字段，都解析到你的SpeechAction对象里。这里有两种实用的方案，先从最简洁的setter重载方式说起：

方案一：用重载的Setter方法+@JsonSetter（推荐） #

只需要给SpeechAction类添加两个重载的setter方法，分别处理单个字符串和数组类型的speech字段，再用@JsonSetter把它们和JSON里的speech字段绑定起来：

import com.fasterxml.jackson.annotation.JsonSetter;

public class SpeechAction extends Action {
    public String[] speechText;

    // 处理JSON里的数组格式speech
    @JsonSetter("speech")
    public void setSpeechText(String[] speechText) {
        this.speechText = speechText;
    }

    // 处理JSON里的单字符串格式speech，自动转成单元素数组
    @JsonSetter("speech")
    public void setSpeechText(String speechText) {
        this.speechText = new String[]{speechText};
    }
}

你的父类Action保持原样就行：

public class Action {
    public String onCompletedEvent;
}

测试一下两种格式的解析 #

用ObjectMapper写个测试代码验证效果：

import com.fasterxml.jackson.databind.ObjectMapper;

public class TestSpeechParsing {
    public static void main(String[] args) throws Exception {
        ObjectMapper mapper = new ObjectMapper();

        // 测试单字符串格式的JSON
        String singleSpeechJson = "{\"speech\": \"你好，世界\", \"onCompletedEvent\": \"speechFinished\"}";
        SpeechAction singleAction = mapper.readValue(singleSpeechJson, SpeechAction.class);
        System.out.println("单字符串解析结果：" + singleAction.speechText[0]); // 输出"你好，世界"

        // 测试数组格式的JSON
        String arraySpeechJson = "{\"speech\": [\"Hi\", \"How's it going?\"], \"onCompletedEvent\": \"speechFinished\"}";
        SpeechAction arrayAction = mapper.readValue(arraySpeechJson, SpeechAction.class);
        System.out.println("数组解析结果：" + arrayAction.speechText[0] + ", " + arrayAction.speechText[1]); // 输出"Hi, How's it going?"
    }
}

Jackson会自动根据JSON里speech字段的类型，匹配对应的setter方法：字符串就调用String参数的setter，自动包装成数组；数组就直接调用数组参数的setter，完美适配两种格式。

如果需要处理空值或者异常情况，还可以在setter里加校验逻辑，比如：

@JsonSetter("speech")
public void setSpeechText(String speechText) {
    if (speechText == null || speechText.isBlank()) {
        this.speechText = new String[0]; // 空字符串转成空数组
    } else {
        this.speechText = new String[]{speechText};
    }
}

方案二：自定义反序列化器（适合复杂场景） #

如果你的需求后续有更复杂的格式要兼容，也可以写一个自定义的JsonDeserializer来控制解析逻辑：

import com.fasterxml.jackson.core.JsonParser;
import com.fasterxml.jackson.databind.DeserializationContext;
import com.fasterxml.jackson.databind.JsonDeserializer;
import com.fasterxml.jackson.databind.JsonNode;

import java.io.IOException;

public class SpeechTextDeserializer extends JsonDeserializer<String[]> {
    @Override
    public String[] deserialize(JsonParser p, DeserializationContext ctxt) throws IOException {
        JsonNode node = p.getCodec().readTree(p);
        if (node.isTextual()) {
            return new String[]{node.asText()};
        } else if (node.isArray()) {
            return p.getCodec().treeToValue(node, String[].class);
        }
        // 遇到其他类型的话，返回空数组或者抛出异常，根据你的需求调整
        return new String[0];
    }
}

然后在SpeechAction的字段上加上注解，指定用这个反序列化器：

import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
import com.fasterxml.jackson.annotation.JsonSetter;

public class SpeechAction extends Action {
    @JsonDeserialize(using = SpeechTextDeserializer.class)
    @JsonSetter("speech")
    public String[] speechText;
}

这种方式灵活性更高，但对于当前的需求来说，方案一已经足够简单好用了。

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