json格式解析和libjson的用法介绍(关于cjson的使用方法)

2020-01-26 14:21:11

字体：大中小

来源：转载

供稿：网友

在阅读本文之前，请先阅读下《Rss Reader实例开发之系统设计》一文。

Rss Reader实例开发中，进行网络数据交换时主要使用到了两种数据格式：JSON与XML。本文主要介绍JSON格式的简单概念及JSON在Rss Reader中的应用，XML格式的使用将在下一篇文章做介绍。

JSON简介：

JSON(JavaScript Object Notation) 是一种轻量级的数据交换格式，可以把JSON的结构理解成无序的、可嵌套的key-value键值对集合，这些key-value键值对是以结构体或数组的形式来组织的。同一级的key-value键值对之间是用一个“,”（逗号）隔开，每个key-value键值对是由一个key后面紧接一个“:”（冒号），冒号后面是这个key对应的value。Key是一个word，由大小写字母、下划线及数字组成，可以由双引号封闭，也可以不加双引号；而value的取值集为：Number、Boolean(true或false)、null、String、Object及Array，如图一：

（图一）

1、Number：数值，包括整形数与浮点数，如：123、0.83、-2.7e10。其结构如图二：

（图二）

2、String：字符串，是以双引号封闭起来的一串字符，使用反斜杠来转义，如：//、/n等，JSON中字符串的概念与C/C++或者JAVA语言里的字符串概念差不多，如：”abc”。其结构如图三：

（图三）

3、Object：对象，也可理解成一个结构体，是以一对大括号封闭起来的无序的key-value键值对集合，例如：{name:"Susan", age:27, birthday:{year:1984, month:2, day:11}}；也可以写成：{"name":"Susan", "age":27, "birthday":{"year":1984, "month":2, "day":11}}；其结构如图四：

（图四）

4、Array：数组，JSON的数组是一个以中括号封闭起来的value的集合，即数组内的各个成员的数据类型可以不一样，这一点就跟C/JAVA的数组概念不同了。每个value之间是由一个“,”(逗号)隔开，例如：[123, abc, false, {name:mj}]；其结构如图五：

（图五）

关于JSON的详细说明与教程请自行到网络上搜索，有很多。

下面我们就来动手写一个例子：

{  result:true,   root:{    version:"201007091640",    channels:[    {      name:"新闻中心",      subchnls:[      {        title:"焦点新闻",        link:"http://VeVB.COm/news/channel/1/news.rss",        desc:"家事、国事、天下事"      },      {        title:"新闻频道",        link:"http://VeVB.COm/news/channel/2/news.rss",        desc:"让您实时掌握国际动态"      },      {        title:"军事频道",        link:"http://VeVB.COm/news/channel/3/news.rss",        desc:"军事"      }      ]    },        {      name:"体育新闻",      subchnls:[      {        title:"体育要闻汇总",        link:"http://VeVB.COm/news/channel/4/news.rss",        desc:"erewr"      },      {        title:"国际足坛",        link:"http://VeVB.COm/news/channel/5/news.rss",        desc:"werewr"      }      ]    }        ]  }}

这段JSON描述了一个对象（最外层大括号包围的部分），为了方便区分，我们就将其称为对象A吧。对象A有两个Item（即key-value键值对），一个是result，其值为true；一个是root，其值为一个对象，称为对象B。对象B也有两个Item，一个是version，其值为一个字串” 201007091640”；一个是channels，其值是一个数组，而数组的成员都是一个对象，每个对象又包含两个Item，一个是name，值分别为字串"新闻中心"和"体育新闻"；一个是subchnls，值都是数组，每个数组又分别有若干个成员，每个subchnls成员也都是一个对象，每个对象都有三个Item：title、link和desc。也许你看到这，已经是一头大汗了，不过没关系，我们来帖张这段JSON文本对应的结构图，有图就有真相，请看图六：

（图六：黑色实线为对象，虚线为值，橙色实线为数组）

在RssReader中使用cJSON：

在RssReader中使用了开源库cJSON来解析JSON，所以在此就介绍下cJSON的使用：

在CJSON中，一个key-value键值对被解析并存放在一个cJSON结构体变量中，其value取值集为：FALSE，TRUE，NULL，NUMBER，STRING，OBJECT，ARRAY。它们分别被存放在CJSON对象的child、valuestring、valueint、valuedouble变量中，而用于判断某个CJSON对象value的数据类型则是CJSON对象的type变量，其取值范围与CJSON对象的value集是一一对应的，如：cJSON_False对应FALSE。

cJSON Types:

#define   cJSON_False   0#define   cJSON_True   1#define   cJSON_NULL 2#define   cJSON_Number  3#define   cJSON_String  4#define   cJSON_Array   5#define   cJSON_Object  6

cJSON 结构体:

typedef struct cJSON{  struct cJSON *next,*prev;  //指向上一项/下一项  struct cJSON *child;  //指向下一级，也就是当type为cJSON_Object或cJSON_Array时，此指针不为空。  int type;            char *valuestring; // 当type为cJSON_String时  int valueint;    // 当 type为cJSON_Number时  double valuedouble; //当type为cJSON_Number时   char *string;    // 当前项的名称，也就是key-value键值对的key} cJSON;

在解析JSON过程中，从JSON格式描述的value数据到CJSON对象中存放的变量的一个映射关系如图七：

（图七）

对CJSON格式的解析是使用cJSON_Parse()方法，其传入的参数是一个CJSON的Object/Array结构的字串，解析成功则返回一个cJSON结构体变量的指针，在使用完成后需要调用cJSON_Delete()将该指针销毁。CJSON是以树状结构来组织内部的各个cJSON结构体变量的，一般地，要使用某个cJSON结构体变量，需要调用cJSON_GetObjectItem()方法并根据其父节点的cJSON结构体变量指针与该项的名称来获取其指针，举个例子：

bool bResult;char jsonString[] = “{result:true}”;//获取result的值truecJSON* pItem = NULL;cJSON* pRoot = cJSON_Parse ( jsonString );if ( pRoot ){  pItem = cJSON_GetObjectItem ( pRoot, “result” );  if ( pItem )  {    bResult = pItem->valueint;  //由于result的值type为cJSON_False或cJSON_True，所以其值被存放在valueint变量中  }  cJSON_Delete ( pRoot );}

在上例中，不管result的值type为何类型，都是通过调用cJSON_GetObjectItem()方法获取其对应的cJSON结构体变量的指针，只是在处理其对应的值时会有所不同。如果result的值type为cJSON_Object，则需要通过调用cJSON_GetObjectItem( pItem, “subItemKey”)来获取其子Item的指针。在处理值type为cJSON_Array的Item时，就需要再用到另外两个API：cJSON_GetArraySize ()和cJSON_GetArrayItem()。我们举个获取一个数组成员值的例子：

char* out;char jsonString[] = “{colors:[/“red/”, /“green/”,/ “blue/”, /“yellow/”, /“white/”]}”;cJSON* pArray = NULL;cJSON* pRoot = cJSON_Parse ( jsonString );if ( pRoot ){  pArray = cJSON_GetObjectItem ( pRoot, “colors” );  if ( pArray )  {    cJSON* pArrayItem = NULL;    int nCount = cJSON_GetArraySize ( pArray ); //获取pArray数组的大小    for( int i = 0; i < nCount; i++)    {      pArrayItem = cJSON_GetArrayItem(pArray, i);      out = cJSON_Print( pArrayItem );  //将pArrayItem的值以字串的形式打印到char型buffer上，cJSON_Print()会自动分配内存空间，用完需要释放内存。      SS_printf( “array item %d: %s/n”, i, out);      Free( out );    }  }  cJSON_Delete ( pRoot );}

在提取一个复杂的JSON格式的数据时，也只是将以上两个例子使用到的方法进行组合调用罢了。所以对CJSON提供的API的使用是很简单有效的。有了以上知识的了解，我们就可以编写一些代码将例一中的JSON解析并提取其中的数据，还是贴点代码才是硬道理，代码如下：

TChannelsData.h:

/** 子频道信息结构体* */struct SUBCHNL_DATA{  SUBCHNL_DATA();  void clear();   TUChar * m_title;  char * m_link;  TUChar * m_desc;}; /** 大频道信息结构体* */struct CHANNEL_DATA{  CHANNEL_DATA();   TUChar* m_pszTitle;  vector m_aSubChnlList;}; //………….// TChannelsData 类成员变量：RSSReaderConfig 版本号char m_pszVersion[32];// TChannelsData 类成员变量：频道信息列表vector m_aChnlsList;//………….TChannelsData.cpp:  /** 解析JSON格式的内容* * /param pszJsonText 解析的JSON格式内容字串* * /return true:有更新数据; false:没有更新数据*/Boolean TChannelsData::ParseJson(char* pszJsonText){  //char* out;  cJSON* objJson;   objJson= cJSON_Parse(pszJsonText);   if (objJson)  {    //out=cJSON_Print(objJson);    cJSON* objRootItem = NULL;     //判断是否需要更新    objRootItem = cJSON_GetObjectItem(objJson, "result");    if (objRootItem)    {      if (!objRootItem->valueint)      {        return FALSE;      }    }    else    {      return FALSE;    }     //获取更新数据，根节点root    objRootItem = cJSON_GetObjectItem(objJson, "root");    if (objRootItem)    {      cJSON* objJsonItem = NULL;       //获取版本号      objJsonItem = cJSON_GetObjectItem(objRootItem, "version");      if (objJsonItem)      {        Int32 nLen = strlen(objJsonItem->valuestring);        strncpy(m_pszVersion, objJsonItem->valuestring, (nLen < 32)? nLen : 31);      }       //解析出大频道      _ParseChannels(objRootItem);    }        //SS_printf("=======[parse json]%s/n",out);    cJSON_Delete(objJson);    //free(out);  }   return TRUE;} /** 解析出大频道* * /param pCJson cJSON对象指针* * /return void*/void TChannelsData::_ParseChannels(cJSON* pCJson){  cJSON* pJsonArray = NULL;   if (!pCJson)  {    return;  }   pJsonArray = cJSON_GetObjectItem(pCJson, "channels");  if(pJsonArray)  {    cJSON* pArrayItem = NULL;    cJSON* pJsonTemp = NULL;     Int32 nSize = cJSON_GetArraySize(pJsonArray);    for (Int32 i = 0; i < nSize; i++)    {      pArrayItem = cJSON_GetArrayItem(pJsonArray, i);      if (pArrayItem)      {        CHANNEL_DATA tChannelData;        Int32 nLen = 0;         //获取大频道名称        tChannelData.m_pszTitle = _JsonGetTUString(pArrayItem, "name");                //解析出子频道        _ParseSubChnls(tChannelData.m_aSubChnlList, pArrayItem);         //将大频道信息对象压入列表中        m_aChnlsList.push_back(tChannelData);      }      else      {        continue;      }    }  }} /** 解析子频道* * /param aSubChnlList 存放子频道数据的vector对象* /param pCJson cJSON对象指针* * /return void*/void TChannelsData::_ParseSubChnls(vector& aSubChnlList, cJSON* pCJson){  cJSON* pJsonArray = NULL;   if (!pCJson)  {    return;  }   pJsonArray = cJSON_GetObjectItem(pCJson, "subchnls");  if (pJsonArray)  {    cJSON* pArrayItem = NULL;    //cJSON* pJsonTemp = NULL;     Int32 nSize = cJSON_GetArraySize(pJsonArray);    for (Int32 i = 0; i < nSize; i++)    {      pArrayItem = cJSON_GetArrayItem(pJsonArray, i);      if (pArrayItem)      {        SUBCHNL_DATA tSubChnlData;        Int32 nLen = 0;         //get title        tSubChnlData.m_title = _JsonGetTUString(pArrayItem, "title");         //get link        tSubChnlData.m_link = _JsonGetString(pArrayItem, "link");         //get desc        tSubChnlData.m_desc = _JsonGetTUString(pArrayItem, "desc");         aSubChnlList.push_back(tSubChnlData);      }    }  }} /** 获取指定的cJSON对象的指定属性值* * /param pJsonItem cJSON对象指针* /param pszKey cJSON对象属性* * /return 返回JSON对象的值，以TUChar字串形式返回*/TUChar* TChannelsData::_JsonGetTUString(cJSON* pJsonItem, char* pszKey){  TUChar* pszValue = NULL;  Int32 nLen;  cJSON* pJsonTemp = NULL;   pJsonTemp = cJSON_GetObjectItem(pJsonItem, pszKey);  if (pJsonTemp)  {    nLen = strlen(pJsonTemp->valuestring) + 1;    pszValue = new TUChar[nLen];    if(pszValue)    {      MemSet(pszValue, 0, nLen * sizeof(TUChar));      TUString::StrUtf8ToStrUnicode(pszValue, (const Char*)pJsonTemp->valuestring);    }  }   return pszValue;} /** 获取指定的cJSON对象的指定属性值* * /param pJsonItem cJSON对象指针* /param pszKey cJSON对象属性* * /return 返回JSON对象的值，以char字串形式返回*/char* TChannelsData::_JsonGetString(cJSON* pJsonItem, char* pszKey){  char* pszValue = NULL;  Int32 nLen;  cJSON* pJsonTemp = NULL;   pJsonTemp = cJSON_GetObjectItem(pJsonItem, pszKey);  if (pJsonTemp)  {    nLen = strlen(pJsonTemp->valuestring) + 1;    pszValue = new char[nLen];    if(pszValue)    {      MemSet(pszValue, 0, nLen);      strncpy(pszValue, pJsonTemp->valuestring, nLen - 1);    }  }   return pszValue;} /** 获取指定的cJSON对象的指定属性值* * /param pJsonItem cJSON对象指针* /param pszKey cJSON对象属性* * /return 返回JSON对象的值，以int32形式返回*/Int32 TChannelsData::_JsonGetInt(cJSON* pJsonItem, char* pszKey){  Int32 nValue = 0;  cJSON* pJsonTemp = NULL;   pJsonTemp = cJSON_GetObjectItem(pJsonItem, pszKey);  if (pJsonTemp)  {    nValue = pJsonTemp->valueint;  }   return nValue;} /** 获取指定的cJSON对象的指定属性值* * /param pJsonItem cJSON对象指针* /param pszKey cJSON对象属性* * /return 返回JSON对象的值，以Boolean形式返回*/Boolean TChannelsData::_JsonGetBoolean(cJSON* pJsonItem, char* pszKey){  Boolean bValue = FALSE;  cJSON* pJsonTemp = NULL;   pJsonTemp = cJSON_GetObjectItem(pJsonItem, pszKey);  if (pJsonTemp)  {    if(pJsonTemp->valueint)    {      bValue = TRUE;    }  }   return bValue;}

总结：

JSON的结构简约，所以使得JSON的文档的数据量比较小，比较适合用于网络数据的交换，而且对JSON文档的解析和数据提取的方法也很简单，方便程序员的使用，当然也正是因为JSON的结构简约，使得JSON的可读性与可编辑性会稍差于XML，所以JSON比较适合在较少有人工阅读和编辑的情况下使用期。

备注：经验证名称需加“ 比如char jsonString[] = "{/"result/":true}";

以上就是小编为大家带来的json格式解析和libjson的用法介绍(关于cjson的使用方法)全部内容了，希望大家多多支持武林网~

上一篇：详解socket阻塞与非阻塞，同步与异步、I/O模型

下一篇：浅谈stringstream 的.str()正确用法和清空操作