为什么 Jackson 的 ObjectMapper 方法采用原始的 TypeReference

Question

Jackson 2 ObjectMapper 类定义了许多通用方法，用于将 JSON 字符串、字节数组、文件等反序列化为给定的 Java 类型。

目标类型在这些方法的参数中给出。

例如。类型可以以Class<T> 的形式给出，就像在方法中一样

public <T> T readValue(String content, Class<T> valueType)

它返回相同的T 对象（因此是类型安全的）。

但它也可以以TypeReference<T> 的形式给出（可以编码复杂的泛型类型），因此可以构建例如。 new TypeReference<List<Long>> { } 告诉 ObjectMapper 输入需要反序列化为 long 列表——它可以传递，例如。进入方法：

@SuppressWarnings({ "unchecked", "rawtypes" })
public <T> T readValue(String content, TypeReference valueTypeRef)

但该方法采用 raw TypeReference 而不是泛型 TypeReference<T>，因此需要手动向调用添加泛型参数：

objectMapper.<List<Long>>readValue(input, listOfLongs)

如果在提供的类型中出现错误，编译器将无法捕捉到。如果方法签名是，那将不是问题

public <T> T readValue(String content, TypeReference<T> valueTypeRef)

这将告诉编译器返回的值始终与提供的TypeReference 的泛型参数的类型相同，类似于它与Class<T> 的工作方式。

我的问题是——这种 API 背后的原因是什么？ 为什么 Jackson 方法采用原始的 TypeReference？当返回的对象确实与TypeReference的泛型参数引用的类型不同时，是否存在任何有效情况？

PS：同样令我困惑的是，对应的convertValue 方法采用的不是原始类型，而是通配符：

public <T> T convertValue(Object fromValue, TypeReference<?> toValueTypeRef)

同样readValues:

public <T> MappingIterator<T> readValues(JsonParser p, TypeReference<?> valueTypeRef)

而readValue(JsonParser, TypeReference)实际上是takes a fully qualified generic parameter：

public <T> T readValue(JsonParser p, TypeReference<T> valueTypeRef)

Answer 1

它已经是reported as an issue，但被标记为3.x。

该库的作者有一条评论解释了为什么尚未更正此问题：

看起来像ObjectMapper API（也许还有ObjectReader）省略了与TypeReference 匹配的类型变量。这将是有意义的更改，但可能会导致一些源兼容性问题（不是二进制），所以也许在 3.0 中而不是更早的版本中这样做。

Answer 2

TypeReference 抽象类并不意味着直接用作通用信息的容器。这是来自javadoc：

这个泛型抽象类用于获取完整的泛型类型 按子分类的信息；它必须转换为 ResolvedType 实现（由“databind”包中的 JavaType 实现）为 用过。

即使 ObjectMapper 接受了参数化的 TypeReference ，它也无法完成这项工作，因为像 new TypeReference<List<Long>> { } 这样的所有通用规范在运行时都会被完全删除。

要将通用信息传递给杰克逊的ObjectMapper，您需要创建一个JavaType 实例：

JavaType type = mapper.getTypeFactory().constructCollectionType(List.class, Long.class);

然后

List<Long> list = mapper.readValue(..., type);