嵌入式开发,常用库介绍:cJSON
JSON(JavaScript Object Notation)是一种轻量级、可读性高且跨平台的数据交换格式。它采用完全独立于编程语言的文本格式来存储和表示数据,常用于设备与云端、上位机、网页和小程序之间的数据通信。在嵌入式项目开发中,若需要进行复杂的数据交互,引入一个高效的C语言JSON库通常是必要的选择。cJSON作为该领域广泛使用的超轻量级解析库,以其极简的设计和良好的兼容性,成为了很多开发者的首选工具。
01cJSON库核心特点与移植
cJSON项目创建于2009年,设计上一直坚持极简路线。为了支持尽可能多的平台和编译器,cJSON严格采用ANSI C(C89/C90)标准编写,这使其成为C语言环境中的“最大公约数”,具备极佳的可移植性。该库主要由一个C文件(cJSON.c)和一个头文件(cJSON.h)组成,没有复杂的构建系统和配置过程,开发者只需将这两个文件加入工程即可直接使用。
- 单文件结构
仅包含一个源文件和一个头文件,无需复杂的构建配置,复制即可使用。 - 标准兼容
基于C89标准编写,兼容几乎所有支持C语言的嵌入式平台和编译器。 - 链表实现
底层采用双向链表结构,节点保存JSON字段信息,通过节点连接表达层级关系。
需要注意的是,cJSON依赖动态内存分配,默认情况下调用标准库的malloc和free接口。在资源受限的嵌入式环境中,或者工程采用了统一的内存管理策略(如FreeRTOS的heap接口)时,需要对cJSON的内存管理机制进行替换。
cJSON内存管理替换方案
直接修改源码
在cJSON源码中找到internal_malloc等宏定义
将其重定义为自定义的内存分配函数(如SramMalloc)
无需额外调用初始化函数,编译即生效


使用Hooks接口
定义cJSON_Hooks结构体,填入自定义malloc/free函数
在程序初始化阶段调用cJSON_InitHooks进行注册
不修改库源码,便于库文件的版本更新与维护
02cJSON应用流程:打包与解析
cJSON的使用主要分为两大功能:打包(生成)JSON字符串和解析JSON字符串。其核心数据结构是cJSON节点,无论是创建还是解析,最终都是操作cJSON对象及其链表。
- 创建JSON字符串(打包)
整体流程分为三步:首先调用cJSON_CreateObject创建根对象;随后使用cJSON_AddStringToObject、cJSON_AddNumberToObject等接口向根对象添加字段,字段类型可以是字符串、数字或子对象;最后通过cJSON_Print将根对象转换为字符串。 - 解析JSON字符串
首先调用cJSON_Parse,若输入合法则返回cJSON根对象指针,非法则返回NULL;解析成功后,使用cJSON_GetObjectItem根据键名获取对应的子对象;再通过子对象的valuestring、valueint等成员获取具体数据。
| 步骤 | 打包(生成)JSON | 解析(读取)JSON |
|---|---|---|
| 1. 初始化 | 调用 cJSON_CreateObject() 创建根对象 | 调用 cJSON_Parse(jsonString) 解析字符串 |
| 2. 数据操作 | 使用 Add...Toobject 系列函数添加字段 | 使用 GetObjectItem 根据 Key 获取子对象 |
| 3. 结果获取 | 使用 cJSON_Print() 转换为字符串 | 直接访问子对象的 valuestring/valueint |
| 4. 内存释放 | 需释放 cJSON_Print 返回的字符串指针 | 需释放 cJSON_Parse 返回的根对象指针 |
cJSON打包与解析关键步骤对比
在C语言环境下使用cJSON,必须严格遵守内存管理规范。对于打包过程,cJSON_Print返回的字符串指针是动态申请的,使用完毕后必须调用cJSON_free释放;对于解析过程,cJSON_Parse返回的根对象指针在使用完毕后必须调用cJSON_Delete释放。虽然这种手动管理内存的方式相对于高级语言略显繁琐,但在C语言开发中,这已是兼顾可读性与底层可控性的标准方案。
当前文章无评论,是时候发表评论了