利用 @JsonValue 注解，Jackson 能够将对象直接“拆解”为内部的列表值，省去一层嵌套，最终生成像 [ [123, 45.6], [789, 12.3] ] 这样的扁平数组。
通常，Jackson 在序列化一个 Java 对象时，默认会将所有字段以键值对形式输出成一个 JSON 对象。但在某些场景下，我们并不希望 DataPoint 被包装成 { "dataPoint": [...] } 的结构，而是希望它自身直接等价于内部的二维数值列表——换句话说，每个 DataPoint 实例应当被序列化为一个长度为 2 的数组 [long, double]，并作为 dataPoint 数组中的一个元素。
关键在于，解决方案简单得令人惊讶：只需在承载数据的字段（或其 getter 方法）上添加 @JsonValue 注解即可。
public class DataPoint {
private final List
✅ 需要留意的几个细节：
- @JsonValue 仅能标注一个非 void 且泛型非 void 的 public 方法或字段（推荐使用 getter）；
- 若同时标注两个，Jackson 会直接抛出错误；
- 该注解只负责序列化（Java → JSON），反序列化（JSON → Java）还需配合 @JsonCreator 或使用默认构造器加 setter。由于代码中的 data 是只读 final 字段，建议补充一个带参数的 @JsonCreator 构造器来支持反序列化；
- List 在序列化时类型不够明确，推荐使用 List
下面提供一个完整可运行的示例（已包含反序列化支持）：
public class DataPoint {
private final List data;
public DataPoint(long date, double counts) {
this.data = List.of(date, counts);
}
@JsonCreator
public DataPoint(@JsonProperty("data") List data) {
if (data == null || data.size() != 2) {
throw new IllegalArgumentException("DataPoint requires exactly 2 numbers");
}
this.data = data;
}
@JsonValue
public List getData() {
return data;
}
}
配置完成后，Entry 类无需任何修改，Jackson 便能直接输出预期的 JSON 结构：
{
"name": "20070480",
"dataPoint": [
[1681792679186, 1096.0],
[1681792680186, 1147.0]
]
}
总结来说，@JsonValue 是 Jackson 提供的一种轻量级声明机制，专门用于将对象“降维”为简单的 JSON 值（例如数组、字符串或数字）。对于“对象本身即数据元组”的场景特别适用，无需编写自定义序列化器，既保持了简洁性，又提升了可维护性。
