1.JSON格式简述
JSON(JavaScript Object Notation) 是一种轻量级的数据交换格式。易于人阅读和编写,同时也易于机器解析和生成。它基于JavaScript(Standard ECMA-262 3rd Edition - December 1999)的一个子集。 JSON采用完全独立于语言的文本格式,但是也使用了类似于C语言家族的习惯(包括C,C++,C#,Java,JavaScript,Perl,Python等)。这些特性使JSON成为理想的数据交换语言。(来自“开源中国”资料)
接触yeelink平台之后,慢慢接触到JSON格式,虽然一些简单的情况可以通过string库函数解析和组装JSON数据包,但是若有cJSON库的帮助,解析和组装JSON数据包的工作便会变得简单的多,下面就从两个例子出发说明cJSON数据包的使用方法。
2.JSON结构体
熟悉使用cJSON库函数可从cJSON结构体入手,cJSON结构体如下所示:
- typedefstructcJSON{
- structcJSON*next,*prev;
- structcJSON*child;
- inttype;
- char*valuestring;
- intvalueint;
- doublevaluedouble;
- char*string;
- }cJSON;
typedef struct cJSON { struct cJSON *next,*prev; struct cJSON *child; int type; char *valuestring; int valueint; double valuedouble; char *string; } cJSON;
几点说明
1.cJOSN结构体为一个双向列表,并可通过child指针访问下一层。
2.type变量决定数据项类型(键的类型),数据项可以是字符串可以是整形,也可以是浮点型。如果是整形值的话可从valueint,如果是浮点型的话可从valuedouble取出,以此类推。
3.解析JSON数据包
例如在yeelink平台中读取一个开关量的结果,向yeelink平台请求之后可以获得以下JSON数据包:
{“timestamp”:”2013-11-19T08:50:11”,”value”:1}
在这个JSON数据包中有两个数据项(键值对),一个是时间戳,该时间戳为字符串形式;另一个是开关值,该开关值为整型。该例子主要用于模拟向yeelink平台请求开关量数据。
参考代码
- #include<stdio.h>
- #include<stdlib.h>
- #include“cJSON.h”
- //被解析的JSON数据包
- chartext[]=“{\”timestamp\”:\”2013-11-19T08:50:11\”,\”value\”:1}”;
- intmain(intargc,constchar*argv[])
- {
- cJSON*json,*json_value,*json_timestamp;
- //解析数据包
- json=cJSON_Parse(text);
- if(!json)
- {
- printf(”Errorbefore:[%s]\n”,cJSON_GetErrorPtr());
- }
- else
- {
- //解析开关值
- json_value=cJSON_GetObjectItem(json,”value”);
- if(json_value->type==cJSON_Number)
- {
- //从valueint中获得结果
- printf(”value:%d\r\n”,json_value->valueint);
- }
- //解析时间戳
- json_timestamp=cJSON_GetObjectItem(json,”timestamp”);
- if(json_timestamp->type==cJSON_String)
- {
- //valuestring中获得结果
- printf(”%s\r\n”,json_timestamp->valuestring);
- }
- //释放内存空间
- cJSON_Delete(json);
- }
- return0;
- }
#include <stdio.h>
运行结果
value:1
2013-11-19T08:50:11
若干说明
4.可通过cJSON_Delete释放内存空间。
4.组装JSON数据包
组装数据包的过程和解析数据包的过程相反,下面的例子描述如何组装以下数据包,该数据包只有一个数据项(键值对)。该例子主要用于模拟向yeelink平台上传传感器数据。
{
“value”: 123.400000
}
参考代码
- #include<stdio.h>
- #include<stdlib.h>
- #include“cJSON.h”
- intmain(intargc,constchar*argv[])
- {
- //创建JSONObject
- cJSON*root=cJSON_CreateObject();
- //加入节点(键值对),节点名称为value,节点值为123.4
- cJSON_AddNumberToObject(root,”value”,123.4);
- //打印JSON数据包
- char*out=cJSON_Print(root);
- printf(”%s\n”,out);
- //释放内存
- cJSON_Delete(root);
- free(out);
- return0;
- }
#include <stdio.h>
若干说明
3. cJSON_Print函数可以打印根数据项,加入制表符换行符等标识符使得JSON数据包更易阅读
4. 使用free函数释放被out占用的内存空间
5.总结
整体来说cJSON简单易用,解决了JSON数据包解析和组装的问题,向着心中的目标更近一步了。
6.参考资料
1.CJSON库介绍