有道无术，术尚可求，有术无道，止于术。
本系列Jackson 版本 2.17.0
源码地址：https://gitee.com/pearl-organization/study-jaskson-demo
1. 概述
JsonDeserializer是一个用于将JSON反序列化为任意类型的对象的抽象类，是Jackson中的重要组件之一。
2. 方法
JsonDeserializer声明了很多方法。
2.1 构造
Fluent风格的工厂方法用于构建经过装饰或增强的对象（和JsonSerializer类似）。
public JsonDeserializer<T> unwrappingDeserializer(NameTransformer unwrapper) {
return this;
}
public JsonDeserializer<?> replaceDelegatee(JsonDeserializer<?> delegatee) {
throw new UnsupportedOperationException();
}
2.2 反序列化
声明了核心的反序列化方法：
/**
* 反序列化
*
* @param p Json解析器
* @param ctxt 反序列化上下文
* @return 反序列化后的对象
*/
public abstract T deserialize(JsonParser p, DeserializationContext ctxt)
throws IOException, JacksonException;
/**
* 反序列化
*
* @param p Json解析器
* @param ctxt 反序列化上下文
* @param intoValue 已经初始化的值实例
* @return 反序列化后的对象
*/
public T deserialize(JsonParser p, DeserializationContext ctxt, T intoValue)
throws IOException, JacksonException {
ctxt.handleBadMerge(this);
return deserialize(p, ctxt);
}
/**
* 反序列化
*
* @param p Json解析器
* @param ctxt 反序列化上下文
* @param typeDeserializer 反序列化类型
* @return 反序列化后的对象
*/
public Object deserializeWithType(JsonParser p, DeserializationContext ctxt,
TypeDeserializer typeDeserializer)
throws IOException, JacksonException {
// We could try calling
return typeDeserializer.deserializeTypedFromAny(p, ctxt);
}
/**
* 反序列化
*
* @param p Json解析器
* @param ctxt 反序列化上下文
* @param typeDeserializer 反序列化类型
* @param intoValue 已经初始化的值实例
* @return 反序列化后的对象
*/
public Object deserializeWithType(JsonParser p, DeserializationContext ctxt,
TypeDeserializer typeDeserializer, T intoValue)
throws IOException, JacksonException {
ctxt.handleBadMerge(this);
return deserializeWithType(p, ctxt, typeDeserializer);
}
2.3 null 处理
JSON中的null值在反序列时，需要一种可控和可预测的方式确定应该使用什么值来表示这个null，对于引用类型（如对象或数组），通常直接使用Java的null。但对于原始数据类型（如int、double等），Java没有null的概念，因此需要一个特殊的策略来处理这种情况。
JsonDeserializer声明了处理null的方法：
/**
* 处理null，默认返回null
*/
@Override
public T getNullValue(DeserializationContext ctxt) throws JsonMappingException {
// Change the direction in 2.7
return getNullValue(); // 返回null
}
/**
* 处理null，getNullValue(DeserializationContext)方法的优化版
* 当getNullValue返回的值是静态的时，反序列化器可以缓存这个值，避免在每次需要时都重新计算。
*/
@Override
public AccessPattern getNullAccessPattern() {
// Default implementation assumes that the null value does not vary, which
// is usually the case for most implementations. But it is not necessarily
// `null`; so sub-classes may want to refine further.
return AccessPattern.CONSTANT;
}
/**
* 确定在没有从输入中获得值但需要传递值时所使用的占位符值。
* 目的：该方法用于处理一种特定情况，即当创建者（Creator）方法需要为每个参数传递一个值，但输入中并没有提供值时，我们需要提供一个占位符值。
* 常见情况：创建者方法通常指的是构造函数、工厂方法或其他用于创建对象实例的方法。这些方法可能要求为所有参数提供值，即使某些值在输入数据中并不存在。
* 占位符值：占位符值用于替代缺失的输入值。它通常与getNullValue方法返回的值相同（这通常就是Java的null），但对于特定类型，可能需要使用不同的“默认值”。
* 特定类型：对于某些类型（特别是原始数据类型或不能设置为null的类型），使用null作为占位符值是不合适的。因此，对于这些类型，可能需要重写此方法以提供适当的默认值（例如，对于整数类型，可能是0；对于布尔类型，可能是false等）。
* 调用频率：该方法每次需要确定占位符值时都会被调用。这意味着，在创建对象实例时，对于每个缺失的输入值，都可能调用此方法。
* 默认实现：该方法的默认实现是简单地调用getNullValue方法并返回其结果。这意味着，在大多数情况下，占位符值将与null值相同，除非特定类型重写了此方法。
*
* @since 2.13
*/
@Override
public Object getAbsentValue(DeserializationContext ctxt) throws JsonMappingException {
return getNullValue(ctxt);
}
2.4 空值
/**
* 空值处理
*/
public Object getEmptyValue(DeserializationContext ctxt) throws JsonMappingException {
return getNullValue(ctxt);
}
/**
* 检查是否需要仅调用一次（静态值），或者每次需要空值时都调用。
*
* @since 2.9
*/
public AccessPattern getEmptyAccessPattern() {
return AccessPattern.DYNAMIC;
}
2.5 其他
/**
* 获取处理类型
*
* @since 2.3
*/
public Class<?> handledType() {
return null;
}
/**
* 获取生成值的逻辑类型
*/
public LogicalType logicalType() {
return null;
}
/**
* 检查反序列化器实例是否可缓存，并可用于相同类型（创建实例的类型）的其他属性
*/
public boolean isCachable() {
return false;
}
/**
* 获取代理的反序列化器
*
* @since 2.1
*/
public JsonDeserializer<?> getDelegatee() {
return null;
}
/**
* 获取属性名称，仅用于错误报告和诊断目的
*
* @since 2.0
*/
public Collection<Object> getKnownPropertyNames() {
return null;
}
/**
* 获取对象标识符值，将其解析为实际的对象实例，并返回为反序列化值。
* @since 2.0
*/
public ObjectIdReader getObjectIdReader() {
return null;
}
/**
* 供 BeanDeserializerFactory 用于处理循环引用问题
*/
public SettableBeanProperty findBackReference(String refName) {
throw new IllegalArgumentException("Cannot handle managed/back reference '" + refName
+ "': type: value deserializer of type " + getClass().getName() + " does not support them");
}
/**
* 查看反序列化器是否支持现有值的更新（也称为“合并”）功能（@JavaMerge）
*
* @since 2.9
*/
public Boolean supportsUpdate(DeserializationConfig config) {
return null;
}
3. 实现类
JsonDeserializer有很多的实现类，用于处理各种数据类型。
3.1 StdDeserializer
StdDeserializer即标准的反序列化器，也是一个抽象类，是在JsonDeserializer的基础上封装了一些通用方法，实现反序列化器时，应该继承该类，而不是JsonDeserializer。
3.1.1 成员属性
掩码（Bitmask）是一种位操作技术，它允许通过单个整数值来同时设置、检查或清除多个标志位。Jackson允许使用掩码在单个操作中检查多个特性，从而提高性能。
F_MASK_INT_COERCIONS声明的掩码用于于覆盖两个特定的反序列化特性：USE_BIG_INTEGER_FOR_INTS 和 USE_LONG_FOR_INTS：
protected final static int F_MASK_INT_COERCIONS =
DeserializationFeature.USE_BIG_INTEGER_FOR_INTS.getMask()
| DeserializationFeature.USE_LONG_FOR_INTS.getMask();
StdDeserializer还提供了两个成员属性，描述当前处理的值类型和Java对象的类型，便于正确地将JSON数据转换为Java对象：
// 反序列化器处理的值类型
final protected Class<?> _valueClass;
// Java对象的类型信息
final protected JavaType _valueType;
3.1.2 构造
StdDeserializer构造函数则比较简单，主要是对成员属性进行赋值：
protected StdDeserializer(Class<?> vc) {
_valueClass = vc;
_valueType = null;
}
protected StdDeserializer(JavaType valueType) {
// 26-Sep-2017, tatu: [databind#1764] need to add null-check back until 3.x
_valueClass = (valueType == null) ? Object.class : valueType.getRawClass();
_valueType = valueType;
}
protected StdDeserializer(StdDeserializer<?> src) {
_valueClass = src._valueClass;
_valueType = src._valueType;
}
3.1.3 反序列化
StdDeserializer提供了一个不特定的类型反序列化方法，子类需要处理类型信息时，需要重写该方法：
@Override
public Object deserializeWithType(JsonParser p, DeserializationContext ctxt,
TypeDeserializer typeDeserializer) throws IOException {
return typeDeserializer.deserializeTypedFromAny(p, ctxt);
}
此外还提供了很多特定类型的反序列化方法：
protected T _deserializeFromArray(JsonParser p, DeserializationContext ctxt)
protected T _deserializeFromString(JsonParser p, DeserializationContext ctxt)
protected T _deserializeFromString(JsonParser p, DeserializationContext ctxt)
protected T _deserializeWrappedValue(JsonParser p, DeserializationContext ctxt)
protected final boolean _parseBooleanPrimitive(DeserializationContext ctxt, JsonParser p, Class<?> targetType)
protected final Boolean _parseBoolean(JsonParser p, DeserializationContext ctxt, Class<?> targetType)
protected final short _parseShortPrimitive(JsonParser p, DeserializationContext ctxt)
protected final int _parseIntPrimitive(JsonParser p, DeserializationContext ctxt)
protected final int _parseIntPrimitive(DeserializationContext ctxt, String text)
protected final int _parseIntPrimitive(DeserializationContext ctxt, String text)
protected final Integer _parseInteger(JsonParser p, DeserializationContext ctxt,Class<?> targetType)
protected final Integer _parseInteger(DeserializationContext ctxt, String text)
protected final long _parseLongPrimitive(JsonParser p, DeserializationContext ctxt)
protected final long _parseLongPrimitive(DeserializationContext ctxt, String text)
protected final Long _parseLong(JsonParser p, DeserializationContext ctxt, Class<?> targetType)
protected final Long _parseLong(DeserializationContext ctxt, String text)
//......................
3.1.4 辅助方法
检查特殊字符串的相关方法：
// 字符串值 "null"，并且进一步确定是否应将其强制转换为 null
protected boolean _hasTextualNull(String value) {
return "null".equals(value);
}
protected final boolean _isNegInf(String text) {
return "-Infinity".equals(text) || "-INF".equals(text);
}
protected final boolean _isPosInf(String text) {
return "Infinity".equals(text) || "INF".equals(text);
}
protected final boolean _isNaN(String text) {
return "NaN".equals(text);
}
也提供了很多辅助方法，用于校验、查询、判断等，供子类直接调用（太多，这里只列举几个）：
protected Object _coerceIntegral(JsonParser p, DeserializationContext ctxt) throws IOException {
if (ctxt.isEnabled(DeserializationFeature.USE_BIG_INTEGER_FOR_INTS)) {
return p.getBigIntegerValue();
} else {
return ctxt.isEnabled(DeserializationFeature.USE_LONG_FOR_INTS) ? p.getLongValue() : p.getNumberValue();
}
}
protected final void _verifyNullForPrimitive(DeserializationContext ctxt) throws JsonMappingException {
if (ctxt.isEnabled(DeserializationFeature.FAIL_ON_NULL_FOR_PRIMITIVES)) {
ctxt.reportInputMismatch(this, "Cannot coerce `null` to %s (disable `DeserializationFeature.FAIL_ON_NULL_FOR_PRIMITIVES` to allow)", new Object[]{this._coercedTypeDesc()});
}
}
3.1.5 实现类
StdDeserializer也包含了多个子实现类，和JsonSerializer类似，只不过是用于反序列化，这里就不再详细解析每个子类了：
3.2 None
和JsonSerializer.None作用一样，是@JsonDeserializer的标记类
3.3 TypeWrappedDeserializer
和TypeWrappedSerializer一样，基于包装模式实现。
3.4 AbstractDeserializer
AbstractDeserializer是一个仅用于处理处理反序列化过程中的多态类型的抽象类。
3.5 ErrorThrowingDeserializer
ErrorThrowingDeserializer用于存储在构建反序列化器过程中捕获的 {@link Error}，该错误需要被延迟处理，直到实际尝试反序列化给定类型的值时。
