cJson是一个非常轻量级的JSON数据解析和构建的oss。
可以很容易的的在C代码中构建一个JSON格式的字符串。也可以将JSON字符串转成cJson中定义的cJson object.
通常用在，手机浏览器或者app发送一个JSON数据到平台，平台上运行的是C代码，平台需要将JSON字符串转成cJson object，再进行解析JSON中的内容转成C结构体，最终做完处理后，构建JSON字符串返回给手机浏览器和app。
同时，也可以用来搭建简单的JSON RPC机制，在客户端的API中将函数名和参数转换成JSON字符串，在server端去解析JSON字符串做处理。
cJson只包含两个文件cJson.c和cJson.h。我们在使用时可以直接嵌入到代码中，也可以将cJson编译成so再使用。
cJson自带的sample code是cJson用法的比较全面的例子。因此就不自己写sample了。
#include <stdio.h>
#include <stdlib.h>
#include "cJSON.h"
/* Parse text to JSON, then render back to text, and print! */
void doit(char *text)
{
char *out;cJSON *json;
json=cJSON_Parse(text);//将字符串解析成Json object.
if (!json) {printf("Error before: [%s]
",cJSON_GetErrorPtr());}
else
{
out=cJSON_Print(json);
cJSON_Delete(json);
printf("%s
",out);
free(out);
}
}
/* Read a file, parse, render back, etc. */
void dofile(char *filename)
{
FILE *f;long len;char *data;
f=fopen(filename,"rb");fseek(f,0,SEEK_END);len=ftell(f);fseek(f,0,SEEK_SET);//计算文件长度。
data=(char*)malloc(len+1);fread(data,1,len,f);fclose(f);
doit(data);
free(data);
}
/* Used by some code below as an example datatype. */
struct record {
const char *precision;
double lat,lon;
const char *address,*city,*state,*zip,*country;
};
/* Create a bunch of objects as demonstration. */
void create_objects()
{
cJSON *root,*fmt,*img,*thm,*fld;char *out;int i; /* declare a few. */
/* Our "days of the week" array: */
const char *strings[7]={"Sunday","Monday","Tuesday","Wednesday","Thursday","Friday","Saturday"};
/* Our matrix: */
int numbers[3][3]={{0,-1,0},{1,0,0},{0,0,1}};
/* Our "gallery" item: */
int ids[4]={116,943,234,38793};
/* Our array of "records": */
struct record fields[2]={
{"zip",37.7668,-1.223959e+2,"","SAN FRANCISCO","CA","94107","US"},
{"zip",37.371991,-1.22026e+2,"","SUNNYVALE","CA","94085","US"}
};
/* Here we construct some JSON standards, from the JSON site. */
/* Our "Video" datatype: */
//构建的Json数据如下：
root=cJSON_CreateObject();
cJSON_AddItemToObject(root, "name", cJSON_CreateString("Jack ("Bee") Nimble"));
cJSON_AddItemToObject(root, "format", fmt=cJSON_CreateObject());
cJSON_AddStringToObject(fmt,"type", "rect");
cJSON_AddNumberToObject(fmt,"width", 1920);
cJSON_AddNumberToObject(fmt,"height", 1080);
cJSON_AddFalseToObject (fmt,"interlace");
cJSON_AddNumberToObject(fmt,"frame rate", 24);
out=cJSON_Print(root); cJSON_Delete(root); printf("%s
",out); free(out); /* Print to text, Delete the cJSON, print it, release the string. */
/* Our "days of the week" array: */
//构建的Json数据如下：
root=cJSON_CreateStringArray(strings,7);
out=cJSON_Print(root); cJSON_Delete(root); printf("%s ",out); free(out);
/* Our matrix: */
//构建的Json数据如下：
root=cJSON_CreateArray();
for (i=0;i<3;i++) cJSON_AddItemToArray(root,cJSON_CreateIntArray(numbers[i],3));
/* cJSON_ReplaceItemInArray(root,1,cJSON_CreateString("Replacement")); */
out=cJSON_Print(root); cJSON_Delete(root); printf("%s
",out); free(out);
/* Our "gallery" item: */
//构建的Json数据如下：
root=cJSON_CreateObject();
cJSON_AddItemToObject(root, "Image", img=cJSON_CreateObject());
cJSON_AddNumberToObject(img,"Width",800);
cJSON_AddNumberToObject(img,"Height",600);
cJSON_AddStringToObject(img,"Title","View from 15th Floor");
cJSON_AddItemToObject(img, "Thumbnail", thm=cJSON_CreateObject());
cJSON_AddStringToObject(thm, "Url", "http:/*www.example.com/image/481989943");
cJSON_AddNumberToObject(thm,"Height",125);
cJSON_AddStringToObject(thm,"Width","100");
cJSON_AddItemToObject(img,"IDs", cJSON_CreateIntArray(ids,4));
out=cJSON_Print(root); cJSON_Delete(root); printf("%s ",out); free(out);
/* Our array of "records": */
//构建的Json数据如下：
root=cJSON_CreateArray();
for (i=0;i<2;i++)
{
cJSON_AddItemToArray(root,fld=cJSON_CreateObject());
cJSON_AddStringToObject(fld, "precision", fields[i].precision);
cJSON_AddNumberToObject(fld, "Latitude", fields[i].lat);
cJSON_AddNumberToObject(fld, "Longitude", fields[i].lon);
cJSON_AddStringToObject(fld, "Address", fields[i].address);
cJSON_AddStringToObject(fld, "City", fields[i].city);
cJSON_AddStringToObject(fld, "State", fields[i].state);
cJSON_AddStringToObject(fld, "Zip", fields[i].zip);
cJSON_AddStringToObject(fld, "Country", fields[i].country);
}
/* cJSON_ReplaceItemInObject(cJSON_GetArrayItem(root,1),"City",cJSON_CreateIntArray(ids,4)); */
out=cJSON_Print(root); cJSON_Delete(root); printf("%s
",out); free(out);
}
int main (int argc, const char * argv[]) {
/* a bunch of json: */
char text1[]="{
"name": "Jack (\"Bee\") Nimble",
"format": {"type": "rect",
"width": 1920,
"height": 1080,
"interlace": false,"frame rate": 24
}
}";
char text2[]="["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"]";
char text3[]="[
[0, -1, 0],
[1, 0, 0],
[0, 0, 1]
]
";
char text4[]="{
"Image": {
"Width": 800,
"Height": 600,
"Title": "View from 15th Floor",
"Thumbnail": {
"Url": "http:/*www.example.com/image/481989943",
"Height": 125,
"Width": "100"
},
"IDs": [116, 943, 234, 38793]
}
}";
char text5[]="[
{
"precision": "zip",
"Latitude": 37.7668,
"Longitude": -122.3959,
"Address": "",
"City": "SAN FRANCISCO",
"State": "CA",
"Zip": "94107",
"Country": "US"
},
{
"precision": "zip",
"Latitude": 37.371991,
"Longitude": -122.026020,
"Address": "",
"City": "SUNNYVALE",
"State": "CA",
"Zip": "94085",
"Country": "US"
}
]";
/* Process each json textblock by parsing, then rebuilding: */
doit(text1);
doit(text2);
doit(text3);
doit(text4);
doit(text5);
/* Parse standard testfiles: */
/* dofile("../../tests/test1"); */
/* dofile("../../tests/test2"); */
/* dofile("../../tests/test3"); */
/* dofile("../../tests/test4"); */
/* dofile("../../tests/test5"); */
/* Now some samplecode for building objects concisely: */
create_objects();
return 0;
}
上面的sample大都是字符串构建cJson object的过程。下面我们看看如何解析cJson object中的item。
int main (int argc, const char * argv[]) {
/* a bunch of json: */
char text1[]="{
"name": "Jack (\"Bee\") Nimble",
"format": {"type": "rect",
"width": 1920,
"height": 1080,
"interlace": false,"frame rate": 24
}
}";
char *out;cJSON *json;
json=cJSON_Parse(text1);
if (!json) {printf("Error before: [%s]
",cJSON_GetErrorPtr());}
else
{
out=cJSON_Print(json);
cJSON *name = NULL;
name = cJSON_GetObjectItem(json, "name");
printf("name:%s
", name->valuestring);
cJSON *fmt = cJSON_GetObjectItem(json, "format");
printf("fmt:type:%s
", cJSON_GetObjectItem(fmt, "type")->valuestring);
printf("fmt:%d
",cJSON_GetObjectItem(fmt, "width")->valueint);
printf("fmt:height:%d
",cJSON_GetObjectItem(fmt, "height")->valueint);
printf("fmt:interlacetype:%d
", cJSON_GetObjectItem(fmt, "interlace")->type);
if (cJSON_GetObjectItem(fmt, "interlace")->type == (int) cJSON_False)
printf("fmt:interlace:false
");
else if (cJSON_GetObjectItem(fmt, "interlace")->type == (int)cJSON_True)
printf("fmt:interlace:true
");
printf("fmt:frame rate:%d
",cJSON_GetObjectItem(fmt, "frame rate")->valueint);
cJSON_Delete(json);
printf("%s
",out);
free(out);
}
return 0;
}
输出结果如下：
