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
相关产品推荐
相关产品推荐

