【花雕学编程】Arduino JSON 之解析 JSON 数组

最新推荐文章于 2025-03-12 07:21:53 发布

驴友花雕

最新推荐文章于 2025-03-12 07:21:53 发布

阅读量1k

点赞数 30

CC 4.0 BY-SA版权

分类专栏：开源硬件文章标签： json 嵌入式硬件单片机 c++ 解析 JSON 数组 Arduino JSON

本文链接：https://blog.csdn.net/weixin_41659040/article/details/145177527

开源硬件专栏收录该内容

1761 篇文章

订阅专栏

在这里插入图片描述

Arduino是一个开放源码的电子原型平台，它可以让你用简单的硬件和软件来创建各种互动的项目。Arduino的核心是一个微控制器板，它可以通过一系列的引脚来连接各种传感器、执行器、显示器等外部设备。Arduino的编程是基于C/C++语言的，你可以使用Arduino IDE（集成开发环境）来编写、编译和上传代码到Arduino板上。Arduino还有一个丰富的库和社区，你可以利用它们来扩展Arduino的功能和学习Arduino的知识。

Arduino的特点是：
1、开放源码：Arduino的硬件和软件都是开放源码的，你可以自由地修改、复制和分享它们。
2、易用：Arduino的硬件和软件都是为初学者和非专业人士设计的，你可以轻松地上手和使用它们。
3、便宜：Arduino的硬件和软件都是非常经济的，你可以用很低的成本来实现你的想法。
4、多样：Arduino有多种型号和版本，你可以根据你的需要和喜好来选择合适的Arduino板。
5、创新：Arduino可以让你用电子的方式来表达你的创意和想象，你可以用Arduino来制作各种有趣和有用的项目，如机器人、智能家居、艺术装置等。

在这里插入图片描述
Arduino JSON 的全面详细科学解释

Arduino 概述
Arduino 是一个开源的电子原型平台，基于易用的硬件和软件。它由硬件（各种型号的 Arduino 板）和软件（Arduino IDE）组成，主要用于快速开发交互式项目。
JSON 概述
JSON（JavaScript Object Notation）是一种轻量级的数据交换格式，易于人阅读和编写，同时也易于机器解析和生成。它基于 JavaScript 的一个子集，但独立于语言，广泛用于 Web 应用和 IoT 设备之间的数据交换。
Arduino JSON 的定义
Arduino JSON 是指在 Arduino 平台上使用 JSON 格式进行数据交换和处理。通过 Arduino JSON 库，开发者可以轻松地在 Arduino 项目中解析和生成 JSON 数据。Arduino JSON是一个用于处理JSON数据的Arduino库，适用于嵌入式C++项目。它支持JSON的序列化和反序列化，能够在有限的内存环境中高效地解析和生成JSON数据。
关键特点：
简单的API：Arduino JSON提供了直观的语法，使开发者能够轻松地处理对象和数组。
序列化和反序列化：支持将JSON数据转换为字符串（序列化）和将字符串转换为JSON数据（反序列化）。
输入过滤：可以过滤大型输入，只保留与应用程序相关的字段，从而节省内存。
流式处理：支持从输入流（如串行端口、以太网连接等）中解析JSON数据。
缩进输出：可以生成紧凑的JSON文档或美化的JSON文档。
闪存字符串：可以直接使用存储在程序内存中的字符串（PROGMEM）。
字符串去重：去重JSON文档中的字符串，减少内存消耗。
隐式或显式转换：支持两种编码风格，可以选择隐式或显式转换。
主要功能
数据解析: 从 JSON 字符串中提取数据。
数据生成: 将数据转换为 JSON 格式的字符串。
数据交换: 通过 JSON 格式与外部服务进行数据交换。
技术实现
库支持: 使用 Arduino JSON 库（如 ArduinoJson）来解析和生成 JSON 数据。
数据格式: JSON 数据格式包括对象（用花括号 {} 表示）和数组（用方括号 [] 表示），键值对用冒号 : 分隔。
数据处理: 在 Arduino 上处理 JSON 数据，执行相应操作。
应用场景
物联网（IoT）: 与云平台进行数据交换。
Web 服务: 与 Web API 进行数据交互。
传感器数据: 处理和传输传感器数据。
配置文件: 存储和读取配置信息。
开发工具
Arduino IDE: 编写和上传代码到 Arduino 板。
ArduinoJson 库: 提供 JSON 解析和生成的库。
网络模块: 如 ESP8266、ESP32，用于连接互联网。
优势与挑战
优势:
轻量级: JSON 格式简洁，易于解析和生成。
跨平台: 独立于语言，适用于多种开发环境。
灵活性: 支持复杂的数据结构。
挑战:
内存限制: Arduino 内存有限，处理大 JSON 数据需优化。
性能限制: 解析和生成 JSON 数据可能占用较多资源。
数据安全: 需要确保数据完整性和安全性。
未来发展方向
优化性能: 提高 JSON 解析和生成的效率。
扩展功能: 支持更多的 JSON 特性（如 JSON Schema）。
增强安全性: 提供数据加密和验证机制。

在这里插入图片描述
主要特点
数据格式兼容性好：JSON（JavaScript Object Notation）是一种轻量级的数据交换格式，具有良好的跨平台和跨语言兼容性。Arduino 能够很好地解析 JSON 数组，使得它可以方便地与各种不同类型的设备和系统进行数据交互，无论是在 Web 应用、移动应用还是其他嵌入式系统中产生的 JSON 数据，Arduino 都能进行处理。
数据结构清晰：JSON 数组以方括号 “[]” 表示，其中的元素可以是各种数据类型，如数字、字符串、布尔值、对象等，数据结构层次分明、清晰易懂。Arduino 在解析时能够准确地识别数组中的每个元素及其类型，方便对数据进行提取和处理，有利于开发者快速理解和操作数据。
灵活性高：可以处理不同长度和内容的 JSON 数组。无论是包含少量元素的简单数组，还是包含大量复杂数据的大型数组，Arduino 都能够根据实际情况进行解析。并且可以根据具体需求，灵活地获取数组中的特定元素或对整个数组进行遍历操作，满足各种不同的应用场景对数据处理的要求。
解析效率较高：借助 Arduino 的相关 JSON 库，如 ArduinoJson 库，能够高效地解析 JSON 数组。这些库经过了优化，在处理速度和内存占用方面都有较好的表现，可以在有限的硬件资源下快速地完成 JSON 数组的解析工作，确保系统的实时性和稳定性。
易于扩展和定制：在 Arduino 平台上，开发者可以根据具体项目的需求，方便地对 JSON 数组解析功能进行扩展和定制。例如，可以在解析过程中添加数据验证、数据转换等功能，或者将解析后的数据与 Arduino 的其他功能模块进行深度集成，实现更复杂的应用逻辑。

应用场景
物联网数据通信：在物联网项目中，Arduino 常作为传感器节点或控制终端，与服务器或其他设备进行数据交互。传感器采集到的数据通常以 JSON 数组的形式发送给 Arduino，例如多个传感器采集到的温度、湿度、光照等数据组成的数组。Arduino 解析 JSON 数组后，可以对这些数据进行处理、存储或根据数据做出相应的控制决策。
远程控制与监控：通过网络接收来自远程客户端或服务器发送的 JSON 格式控制指令数组。例如，一个包含多个电机控制参数的 JSON 数组，用于控制 Arduino 连接的多个电机的转速、转向等。Arduino 解析数组后，按照指令控制相应的设备，实现远程控制和监控的功能。
配置文件读取：将 Arduino 的系统配置信息以 JSON 数组的形式存储在配置文件中，如包含引脚配置、通信参数、传感器校准值等信息的数组。Arduino 在启动时可以读取并解析这个 JSON 数组，根据配置信息进行系统初始化，方便用户通过修改配置文件来灵活调整系统的参数，而无需修改代码。
多设备协作：在多个 Arduino 设备或 Arduino 与其他智能设备协作的场景中，JSON 数组可用于传递设备之间的协作信息。例如，在一个机器人团队中，各机器人之间通过 JSON 数组共享位置、任务状态等信息，Arduino 解析这些数组后，实现机器人之间的协同工作。
数据记录与分析：Arduino 可以从各种数据源获取数据并以 JSON 数组的形式存储在本地或上传到云端进行记录和分析。比如在环境监测项目中，将一段时间内采集到的环境数据以 JSON 数组形式保存，便于后续通过数据分析软件对数据进行处理和可视化展示，了解环境变化趋势。

注意事项
数据完整性：在接收和解析 JSON 数组时，要确保数据的完整性。网络传输过程中可能会出现数据丢失或损坏的情况，因此需要采取适当的措施，如添加校验和、使用可靠的传输协议等，以保证接收到的 JSON 数组是完整且正确的，否则可能导致解析错误。
内存管理：Arduino 的内存资源有限，在解析大型 JSON 数组时，要注意内存的分配和使用。避免因分配过多内存而导致系统崩溃，或者因内存不足而无法完整解析数据。可以通过合理设置缓冲区大小、及时释放不再使用的内存空间等方式来优化内存管理。
数据类型匹配：JSON 数组中的元素可能有多种数据类型，在解析时要确保将数据正确地转换为 Arduino 能够处理的数据类型。例如，JSON 中的数字可能需要根据实际情况转换为 Arduino 中的整数或浮点数，字符串要正确地存储和处理，否则可能会导致数据处理错误。
JSON 格式验证：在解析 JSON 数组之前，最好对数据进行格式验证，确保其符合 JSON 的语法规范。可以使用 ArduinoJson 库中的相关函数进行验证，防止因接收到不合法的 JSON 数据而导致程序出错。
库的版本兼容性：使用的 Arduino JSON 库可能会有不同的版本，不同版本在功能和性能上可能会有所差异。要确保所使用的库版本与 Arduino 的开发环境以及其他相关库兼容，避免出现兼容性问题导致解析失败或出现异常行为。
错误处理：在解析 JSON 数组过程中，可能会出现各种错误，如格式错误、数据类型不匹配等。要编写完善的错误处理代码，当出现错误时能够及时捕获并进行适当的处理，如给出错误提示、进行重试或采取默认操作等，以保证程序的稳定性和可靠性。

在这里插入图片描述
1、解析简单 JSON 数组

#include <ArduinoJson.h>

const char* json = "[\"Apple\", \"Banana\", \"Cherry\"]";

void setup() {
    Serial.begin(115200);
    while (!Serial);

    // 创建 JSON 文档
    StaticJsonDocument<200> doc;
    
    // 解析 JSON
    DeserializationError error = deserializeJson(doc, json);
    
    if (error) {
        Serial.print(F("解析失败: "));
        Serial.println(error.f_str());
        return;
    }

    // 获取数组
    JsonArray array = doc.as<JsonArray>();
    
    // 输出数组元素
    for (JsonVariant value : array) {
        Serial.println(value.as<const char*>());
    }
}

void loop() {
    // 不需要在 loop 中做任何事情
}

2、解析带有对象的 JSON 数组

#include <ArduinoJson.h>

const char* json = R"([
    {"name": "Alice", "age": 30},
    {"name": "Bob", "age": 25},
    {"name": "Charlie", "age": 35}
])";

void setup() {
    Serial.begin(115200);
    while (!Serial);

    // 创建 JSON 文档
    StaticJsonDocument<200> doc;
    
    // 解析 JSON
    DeserializationError error = deserializeJson(doc, json);
    
    if (error) {
        Serial.print(F("解析失败: "));
        Serial.println(error.f_str());
        return;
    }

    // 获取数组
    JsonArray array = doc.as<JsonArray>();
    
    // 输出对象的属性
    for (JsonObject obj : array) {
        Serial.print("Name: ");
        Serial.print(obj["name"].as<const char*>());
        Serial.print(", Age: ");
        Serial.println(obj["age"].as<int>());
    }
}

void loop() {
    // 不需要在 loop 中做任何事情
}

3、解析嵌套 JSON 数组

#include <ArduinoJson.h>

const char* json = R"({
    "fruits": ["Apple", "Banana", "Cherry"],
    "vegetables": ["Carrot", "Lettuce", "Spinach"]
})";

void setup() {
    Serial.begin(115200);
    while (!Serial);

    // 创建 JSON 文档
    StaticJsonDocument<200> doc;
    
    // 解析 JSON
    DeserializationError error = deserializeJson(doc, json);
    
    if (error) {
        Serial.print(F("解析失败: "));
        Serial.println(error.f_str());
        return;
    }

    // 获取数组
    JsonArray fruits = doc["fruits"].as<JsonArray>();
    JsonArray vegetables = doc["vegetables"].as<JsonArray>();
    
    // 输出水果
    Serial.println("Fruits:");
    for (JsonVariant value : fruits) {
        Serial.println(value.as<const char*>());
    }

    // 输出蔬菜
    Serial.println("Vegetables:");
    for (JsonVariant value : vegetables) {
        Serial.println(value.as<const char*>());
    }
}

void loop() {
    // 不需要在 loop 中做任何事情
}

要点解读
ArduinoJson 库：
所有示例都使用 ArduinoJson 库来解析 JSON 数据。该库提供了一种方便的方式来处理 JSON 格式的数据，适合在 Arduino 环境中使用。
简单 JSON 数组解析：
示例 1 展示了如何解析一个简单的 JSON 数组，并输出每个元素。通过 deserializeJson() 函数将 JSON 数据解析到一个 StaticJsonDocument 中，然后使用 JsonArray 来访问数组元素。
带有对象的 JSON 数组：
示例 2 解析一个包含对象的 JSON 数组，提取每个对象的属性（如名字和年龄）。这展示了如何处理更复杂的 JSON 结构，并访问嵌套的数据。
嵌套 JSON 数组解析：
示例 3 展示了如何解析一个包含嵌套数组的 JSON 对象。通过访问 JSON 对象中的不同数组，能够灵活地处理多层结构的数据。
错误处理：
在每个示例中，使用 DeserializationError 来检查解析过程中的错误。这是保证程序健壮性的重要措施，有助于调试和排查问题。

在这里插入图片描述

4、解析简单的整数数组

#include <ArduinoJson.h>

const char* json = "[1, 2, 3, 4, 5]";

void setup() {
    Serial.begin(115200);
    StaticJsonDocument<64> doc; // 创建一个静态JSON文档
    deserializeJson(doc, json); // 解析JSON字符串

    JsonArray array = doc.as<JsonArray>(); // 获取JSON数组

    Serial.println("解析的整数数组：");
    for (JsonVariant value : array) {
        Serial.println(value.as<int>()); // 打印每个元素
    }
}

void loop() {
    // 循环中不执行任何操作
}

要点解读：
简单解析：这个示例展示了如何解析一个简单的整数数组，适合初学者。
静态JSON文档：使用StaticJsonDocument，内存分配在编译时，适合小型数据。
数组迭代：通过JsonArray和JsonVariant轻松遍历数组元素。
内存管理：适合嵌入式系统，避免动态内存分配的复杂性。
易于扩展：可以添加更多功能，例如处理不同类型的数组或增加错误处理。

5、解析包含对象的JSON数组

#include <ArduinoJson.h>

const char* json = "[{\"name\":\"Alice\",\"age\":30},{\"name\":\"Bob\",\"age\":25}]";

void setup() {
    Serial.begin(115200);
    StaticJsonDocument<200> doc; // 创建一个静态JSON文档
    deserializeJson(doc, json); // 解析JSON字符串

    JsonArray array = doc.as<JsonArray>(); // 获取JSON数组

    Serial.println("解析的对象数组：");
    for (JsonObject obj : array) {
        const char* name = obj["name"]; // 获取name字段
        int age = obj["age"]; // 获取age字段
        Serial.print("Name: ");
        Serial.print(name);
        Serial.print(", Age: ");
        Serial.println(age); // 打印每个对象的属性
    }
}

void loop() {
    // 循环中不执行任何操作
}

要点解读：
对象数组解析：该示例展示了如何解析包含对象的JSON数组，适合处理更复杂的数据结构。
字段访问：通过JsonObject轻松访问对象的属性，增强了数据处理的灵活性。
动态内存管理：使用StaticJsonDocument有助于控制内存使用，适合资源有限的设备。
可读性：代码结构清晰，易于理解，适合进行数据的增删改查操作。
扩展性：可以轻松扩展以处理更多字段或嵌套对象。

6、解析嵌套的JSON数组

#include <ArduinoJson.h>

const char* json = "{\"users\":[{\"name\":\"Alice\",\"age\":30},{\"name\":\"Bob\",\"age\":25}]}";

void setup() {
    Serial.begin(115200);
    StaticJsonDocument<256> doc; // 创建一个静态JSON文档
    deserializeJson(doc, json); // 解析JSON字符串

    JsonObject root = doc.as<JsonObject>(); // 获取根对象
    JsonArray users = root["users"]; // 获取嵌套的用户数组

    Serial.println("解析的嵌套对象数组：");
    for (JsonObject user : users) {
        const char* name = user["name"]; // 获取name字段
        int age = user["age"]; // 获取age字段
        Serial.print("Name: ");
        Serial.print(name);
        Serial.print(", Age: ");
        Serial.println(age); // 打印每个对象的属性
    }
}

void loop() {
    // 循环中不执行任何操作
}

要点解读：
嵌套结构解析：示例展示了如何解析嵌套的JSON结构，适合处理复杂数据。
根对象访问：通过JsonObject访问根对象和嵌套数组，增强了数据处理的灵活性。
内存管理：静态JSON文档适合嵌入式开发，控制内存使用。
数据提取：通过遍历嵌套数组，轻松提取所需数据，适合实际应用场景。
易于扩展：可以扩展以处理更多嵌套层级或不同的结构。

总结
以上几个示例展示了如何使用Arduino解析JSON数组。关键要点包括：
多样化的解析能力：支持解析简单数组、对象数组和嵌套数组，适应不同的数据结构。
易用性：通过ArduinoJson库，简化JSON数据处理，适合初学者和开发者。
内存管理：使用StaticJsonDocument控制内存使用，适合资源有限的设备。
数据访问：通过简单的API访问和遍历JSON数据，增强了灵活性和可读性。
扩展性：可以轻松扩展以支持更多功能和复杂数据结构，适合实际应用。

注意，以上案例只是为了拓展思路，仅供参考。它们可能有错误、不适用或者无法编译。您的硬件平台、使用场景和Arduino版本可能影响使用方法的选择。实际编程时，您要根据自己的硬件配置、使用场景和具体需求进行调整，并多次实际测试。您还要正确连接硬件，了解所用传感器和设备的规范和特性。涉及硬件操作的代码，您要在使用前确认引脚和电平等参数的正确性和安全性。

在这里插入图片描述