ArduinoJson中JsonVariantConst类型检查的正确使用方式

问题背景

在使用ArduinoJson库进行JSON数据深度合并时，开发者经常会遇到需要判断JSON节点类型的情况。在7.2.0版本中，一个常见的问题是使用is<JsonArray>()方法对JsonVariantConst对象进行类型检查时总是返回false，这导致深度合并功能无法正常工作。

根本原因分析

这个问题源于ArduinoJson库中常量对象和可变对象的区别。JsonVariantConst是一个只读的JSON变体类型，而JsonArray是一个可变的JSON数组类型。当尝试使用is<JsonArray>()检查一个只读对象时，由于类型不匹配，方法会始终返回false。

解决方案

正确的做法是使用is<JsonArrayConst>()来检查只读JSON数组类型。JsonArrayConst是专门为只读操作设计的JSON数组类型，与JsonVariantConst的类型系统完全兼容。

代码示例

void deepMerge(JsonVariantConst src, JsonVariant dst) {
    if (src.is<JsonObjectConst>()) {
        // 处理对象类型
        JsonObject dstObj = dst.as<JsonObject>();
        for (JsonPairConst srcPair : src.as<JsonObjectConst>()) {
            const char* key = srcPair.key().c_str();
            if (dst.containsKey(key)) {
                deepMerge(srcPair.value(), dst[key]);
            } else {
                dst[key] = srcPair.value();
            }
        }
    } 
    else if (src.is<JsonArrayConst>()) {  // 正确使用JsonArrayConst
        // 处理数组类型
        JsonArray dstArr = dst.as<JsonArray>();
        for (JsonVariantConst srcItem : src.as<JsonArrayConst>()) {
            dstArr.add(srcItem);
        }
    } 
    else {
        // 处理基本类型
        dst.set(src);
    }
}

最佳实践

1. 当处理只读JSON数据时，始终使用JsonXxxConst系列类型（如JsonObjectConst、JsonArrayConst）
2. 类型检查方法is<T>()中的模板参数必须与变量的常量性匹配
3. 在深度合并等操作中，注意区分源数据（通常为只读）和目标数据（通常为可写）的不同类型要求

总结

理解ArduinoJson中常量类型和可变类型的区别对于编写正确的JSON处理代码至关重要。通过使用正确的类型检查方法，可以避免许多常见的陷阱，确保JSON数据处理逻辑的可靠性。特别是在深度合并这种复杂操作中，精确的类型判断是保证功能正确性的关键。