You need to enable JavaScript to run this app. Spring@RequestBody下Jackson反序列化数组型坐标为Point的方案
优惠活动
大模型
产品
解决方案
定价
更多

Spring@RequestBody下Jackson反序列化数组型坐标为Point的方案

适配二维数组坐标结构的Jackson反序列化方案

报错原因

默认情况下Jackson解析java.awt.Point时,会按照JSON对象的格式匹配x、y字段完成映射,遇到入参中的二维数组结构时,因为token类型是数组(START_ARRAY),无法匹配对象解析逻辑,直接抛出序列化异常。

实现步骤

1. 编写自定义Point反序列化器

针对二维数组的坐标格式,实现Jackson的反序列化逻辑:

  • 校验输入的坐标节点必须是长度为2的数字数组
  • 按数组顺序取第一个值为x坐标、第二个值为y坐标
  • 封装为Point类型对象返回
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.awt.Point;
import java.io.IOException;

public class PointArrayDeserializer extends JsonDeserializer<Point> {
    @Override
    public Point deserialize(JsonParser jsonParser, DeserializationContext deserializationContext) throws IOException {
        JsonNode coordinateNode = jsonParser.getCodec().readTree(jsonParser);
        if (!coordinateNode.isArray() || coordinateNode.size() != 2) {
            throw new IOException("坐标格式非法,需为长度为2的数字数组,格式参考 [经度, 纬度]");
        }
        double x = coordinateNode.get(0).asDouble();
        double y = coordinateNode.get(1).asDouble();
        return new Point((int) x, (int) y);
    }
}

2. 注册自定义反序列化器到Jackson全局配置

通过Spring配置将自定义的反序列化逻辑绑定到Point类型,让Jackson全局生效:

import com.fasterxml.jackson.databind.module.SimpleModule;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import java.awt.Point;

@Configuration
public class JacksonGlobalConfig {
    @Bean
    public SimpleModule customPointDeserializerModule() {
        SimpleModule module = new SimpleModule();
        module.addDeserializer(Point.class, new PointArrayDeserializer());
        return module;
    }
}

3. 原有接口无需修改

完成上述配置后,原有的findSpatialResults接口可以直接接收二维数组格式的JSON入参,Jackson会自动将每个坐标小数组映射为Point对象,最终组装为List<Point>结构注入到接口方法中,不需要调整接口方法签名、也不需要修改前端/调用方的传参格式。

注意事项

JDK自带的java.awt.Point是为桌面UI场景设计的,x、y字段为整型,用来存储地理经纬度这类小数值会出现精度截断的问题,生产环境更推荐自定义带有double类型坐标字段的独立类,将反序列化器的泛型替换为自定义类,即可完全适配业务场景,避免精度丢失。

内容的提问来源于stack exchange,提问作者nonNumericalFloat

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.06 15:36:02