使用cJSON创建JSON字符串，举例详解。

使用cJSON创建JSON字符串

    在Linux下，使用C语言编程，开始JSON字符串的创建。我们还是一步步来，逐渐由简单到复制。  

1，下载源码

可以从如下网站来下载：https://sourceforge.net/projects/cjson/ 。

2，包含cJSON的源码

下载下来，解压后，从里面找到两个文件（cJSON.c、cJSON.h），复制到我们的工程里面。只需在函数中包含头文件（#include “cJSON.h”），然后和cJSON.c一起编译即可使用。 

3，创建一个键值对

         首先是一个简单的键值对字符串，要生成的目标如下：

{"firstName":"Brett"}

要进行创建，就是先确定键与值，然后转为cJSON格式。我们很容易就能明确键为firstName，值为Brett，可是，使用cJSON怎么创建呢？ 

对于这个简单的例子，我们需要调用cJSON的五个接口函数就可以实现创建了。（有人不乐意了：都五个函数了，你还说“就可以了”----其实是一法通，百法通，学会了这个创建，其他的创建动作都是非常类似的。）

这五个函数的原型如下：

cJSON*cJSON_CreateObject ();

cJSON*cJSON_CreateString(const char *string);

voidcJSON_AddItemToObject(cJSON *object,const char *string,cJSON *item);

voidcJSON_Delete(cJSON *c);

char*cJSON_Print(cJSON *item); 

下面按创建过程来描述一次：

（1）       首先调用cJSON_ CreateObject ()函数，创建一个JSON对象，之后便可向这个对象中添加string或int等内容的数据项了。使用该函数会通过malloc()函数在内存中开辟一个空间，使用完成需要手动释放。

        cJSON*root=cJSON_CreateObject();

（2）       调用cJSON_CreateString ()函数，由一个字符串生成一个cJSON的数据项。

        cJSON*item=cJSON_CreateString("Brett");

（3）       将上一步生成的数据项与其键值（"firstName"）一起添加到root对象中。

        cJSON_AddItemToObject(root,"firstName",item);

其实到这一步，我们在内存中的cJSON对象就已经构建完成了，后面是展示结果了。

（4）       将cJSON对象的内容解析为字符串，并展示出来。

        out=cJSON_Print(root);

        printf("out:%s\n",out);

（5）       通过cJSON_Delete()，释放cJSON_CreateObject ()分配出来的内存空间。

        cJSON_Delete(root);

（6）       释放cJSON_Print ()分配出来的内存空间。

        free(out); 

         这样就完成了一次cJSON接口调用，实现了字符串的创建工作。

4，转换一个结构体 

接下来，我们来个复杂一点的，将一个结构体转换为JSON字符串，结构体定义如下：

typedefstruct

{

         char firstName[32];

         char lastName[32];

         char email[64];

         int age;

         float height;

} PERSON;

看起来比一个键值对复杂多了，我们又需要学习新的接口函数了吗？

是的，由于出现了数字，我们需要学习一个新函数：

cJSON *cJSON_CreateNumber(double num);

当然，创建的步骤要更复杂一些，下面我仍然是按创建过程来描述一次： 

（1）还是先调用cJSON_ CreateObject ()函数，创建一个JSON对象root，做为根（咱们可以把JSON串看成是一颗树）。使用该函数会通过malloc()函数在内存中开辟一个空间，使用完成需要手动释放。

        cJSON*root=cJSON_CreateObject();

（2）继续调用cJSON_ CreateObject ()函数，创建一个JSON对象obj_person，做为挂载结构体内容的对象。挂载内容之后，这个对象是要挂载到根上的。

        cJSON*obj_person=cJSON_CreateObject();

（3）根据数据生成cJSON格式的数据项，调用cJSON_AddItemToObject()函数挂载到obj_person对象上。这个过程，要多次重复，直到将所有数据都添加上。此时要注意，不同的成员，生成的方法是不一样的。

        cJSON*item=cJSON_CreateString(person->firstName);

        cJSON_AddItemToObject(obj_person,"firstName",item);

        item=cJSON_CreateString(person->lastName);

        cJSON_AddItemToObject(obj_person,"lastName",item);

        item=cJSON_CreateString(person->email);

        cJSON_AddItemToObject(obj_person,"email",item);

        item=cJSON_CreateNumber(person->age);

        cJSON_AddItemToObject(obj_person,"age",item);

        item=cJSON_CreateNumber(person->height);

        cJSON_AddItemToObject(obj_person,"height",item);

（4）将obj_person对象挂载到根上。

        cJSON_AddItemToObject(root,"person",obj_person);

到这一步，我们在内存中的cJSON对象就已经构建完成了，后面就是展示结果。

（5）将cJSON对象的内容解析为字符串，并展示出来。

        out=cJSON_Print(root);

        printf("out:%s\n",out);

（6）通过cJSON_Delete()，释放cJSON_CreateObject ()分配出来的内存空间。这里说明一下，我们前面调用了2次cJSON_CreateObject ()，最后只需要针对root调用一次释放即可，因为第二次创建的对象也是挂接在root上的。

        cJSON_Delete(root);

（7）释放cJSON_Print ()分配出来的内存空间。

        free(out); 

         至此，我们就使用cJSON接口完成了由结构体生成JSON字符串的工作。 

5，创建结构体数组的JSON串   

         最后，我们来个更复杂一些的，来转换一个数组，并且数组的成员是结构体！我们要生成的目标如下：

{

"people":[

{"firstName":"z","lastName":"Jason","email":"bbbb@126.com","height":1.67},

{"lastName":"jadena","email":"jadena@126.com","age":8,"height":1.17},

{"email":"cccc@126.com","firstName":"z","lastName":"Juliet","age":36,"height":1.55}

]

} 

此时，我们又需要学习新的接口了，一个是创建数组，一个是取数组成员，函数原型如下：

cJSON*cJSON_CreateArray(void);

void   cJSON_AddItemToArray(cJSON *array, cJSON*item); 

由于前面已经实现了单个结构体的转换，这里我们重点关注下数组的相关调用。 

（1）还是先调用cJSON_ CreateObject ()函数，创建一个JSON对象root，做为根。

（2）调用cJSON_CreateArray ()函数，创建一个JSON数组对象，准备挂载多个结构体对象。挂载内容之后，这个数组对象是要挂载到根上的。

        cJSON*array_person=cJSON_CreateArray();

（3）生成一个结构体对象，并相应添加数据，然后调用cJSON_AddItemToArray()函数挂载到数组对象上。这个过程，要多次重复，直到将所有结构体对象都添加上。

        cJSON_AddItemToArray(array_person,obj_person);

（4）将数组对象挂载到根上。

        cJSON_AddItemToObject(root,"people",array_person);

到这一步，我们在内存中的cJSON对象就已经构建完成了。

（5）将cJSON对象的内容解析为字符串，并展示出来。

（6）通过cJSON_Delete()，释放cJSON_CreateObject ()分配出来的内存空间。

（7）释放cJSON_Print ()分配出来的内存空间。

         这样，我们就使用cJSON接口完成了将结构体数组转换成JSON字符串的工作。

详细代码见后文附带例程。         

说明：

本文所附带例程，实现了结构体数组生成JSON字符串，只是一个学习之作，对于初学cJSON的同学，可以有些借鉴参考的作用。 

附带例程： 

[cpp] view
plain copy

#include <stdio.h>  

#include <string.h>  

#include <sys/types.h>  
#include <stdlib.h>  

#include <unistd.h>  

  

#include "cJSON.h"  

  

typedef struct  

{  

    int id;  

    char firstName[32];  

    char lastName[32];  

    char email[64];  

    int age;  

    float height;  

}people;  

  

void dofile(char *filename);/* Read a file, parse, render back, etc. */  

  

int main(int argc, char **argv)  

{  

  

    dofile("json_str4.txt");  

  

    return 0;  

}  

  

  

//create a key-value pair  

int str_to_cJSON(char *json_string, char *str_val)  

{  

    char * out=NULL;  

    cJSON *root=cJSON_CreateObject();  

    if (!root)  

    {  

        printf("Error before: [%s]\n",cJSON_GetErrorPtr());  

        return -1;  

    }  

    else  

    {  

        cJSON *item=cJSON_CreateString("Brett");  

        cJSON_AddItemToObject(root,"firstName",item);  

  

        out=cJSON_Print(root);  

        printf("out2:%s\n",out);  

  

        cJSON_Delete(root);  

        if(out!=NULL)  

        {  

            free(out);  

        }  

    }  

    return 0;  

}  

  

//create a object from struct  

int struct_to_cJSON(char *json_string, people *person)  

{  

  

    if((json_string==NULL) || (person==NULL))  

    {  

        printf("%s: input is invalid",__func__);  

    }  

  

    char * out=NULL;  

    cJSON *root=cJSON_CreateObject();  

  

    if (!root)  

    {  

        printf("Error before: [%s]\n",cJSON_GetErrorPtr());  

        return -1;  

    }  

    else  

    {  

        cJSON *obj_person=cJSON_CreateObject();  

  

        cJSON *item=cJSON_CreateString(person->firstName);  

        cJSON_AddItemToObject(obj_person,"firstName",item);  

  

        item=cJSON_CreateString(person->lastName);  

        cJSON_AddItemToObject(obj_person,"lastName",item);  

  

        item=cJSON_CreateString(person->email);  

        cJSON_AddItemToObject(obj_person,"email",item);  

  

        item=cJSON_CreateNumber(person->age);  

        cJSON_AddItemToObject(obj_person,"age",item);  

  

        item=cJSON_CreateNumber(person->height);  

        cJSON_AddItemToObject(obj_person,"height",item);  

  

        cJSON_AddItemToObject(root,"person",obj_person);  

  

        out=cJSON_Print(root);  

        printf("out2:%s\n",out);  

  

        cJSON_Delete(root);  

        if(out!=NULL)  

        {  

            memcpy(json_string,out,strlen(out));  

            free(out);  

        }  

    }  

  

    return 0;  

}  

  

  

//a struct array to CJSON  

int struct_array_to_cJSON(char *text, people worker[])  

{  

    cJSON *json,*arrayItem,*item,*object;  

    int i;  

  

    for(i=0;i<3;i++)  

    {  

        printf("i=%d, firstName=%s,lastName=%s,email=%s,age=%d,height=%f\n",  

                i,  

                worker[i].firstName,  

                worker[i].lastName,  

                worker[i].email,  

                worker[i].age,  

                worker[i].height);  

    }  

  

    if((text==NULL) || (worker==NULL))  

    {  

        printf("%s: input is invalid",__func__);  

    }  

  

    char * out=NULL;  

    cJSON *root=cJSON_CreateObject();  

  

    if (!root)  

    {  

        printf("Error before: [%s]\n",cJSON_GetErrorPtr());  

        return -1;  

    }  

    else  

    {  

        cJSON *array_person=cJSON_CreateArray();  

  

        for(i=0;i<3;i++)  

        {  

            cJSON *obj_person=cJSON_CreateObject();  

  

            cJSON *item=cJSON_CreateString(worker[i].firstName);  

            cJSON_AddItemToObject(obj_person,"firstName",item);  

  

            item=cJSON_CreateString(worker[i].lastName);  

            cJSON_AddItemToObject(obj_person,"lastName",item);  

  

            item=cJSON_CreateString(worker[i].email);  

            cJSON_AddItemToObject(obj_person,"email",item);  

  

            item=cJSON_CreateNumber(worker[i].age);  

            cJSON_AddItemToObject(obj_person,"age",item);  

  

            item=cJSON_CreateNumber(worker[i].height);  

            cJSON_AddItemToObject(obj_person,"height",item);  

  

            cJSON_AddItemToArray(array_person,obj_person);  

        }  

  

        cJSON_AddItemToObject(root,"people",array_person);  

  

        out=cJSON_Print(root);  

        printf("out:%s\n",out);  

  

        cJSON_Delete(root);  

        if(out!=NULL)  

        {  

            memcpy(text,out,strlen(out));  

            free(out);  

        }  

    }  

  

    return 0;  

}  

  

// create CJSON, write file  

void dofile(char *filename)  

{  

    FILE *f;  

    int len;  

    char data[1024];  

      

    f=fopen(filename,"wb");  

    fseek(f,0,SEEK_END);  

    len=ftell(f);  

    fseek(f,0,SEEK_SET);  

      

    printf("read file %s complete, len=%d.\n",filename,len);  

  

//  char str_name[40];  

//  int ret = str_to_cJSON(data, str_name);  

  

    people worker[3]={  

            {0,"zhong","Jason","bbbb@126.com",0,1.67},  

            {1,"","jadena","jadena@126.com",8,1.17},  

            {2,"zhu","Juliet","cccc@126.com",36,1.55}  

    };  

//  struct_to_cJSON(data, &worker[1]);  

    struct_array_to_cJSON(data, worker);  

  

    fwrite(data,1,strlen(data),f);  

    fclose(f);  

  

} 
http://blog.csdn.net/lintax/article/details/51549345