JSON格式解析和libjson使用简介

最新推荐文章于 2024-08-08 07:03:32 发布

最新推荐文章于 2024-08-08 07:03:32 发布 · 66 阅读

文章标签：

#json #java #xhtml

本文深入介绍了JSON格式的概念及应用，通过实例展示了如何使用libjson解析JSON数据，并提供了JSON解析过程中的关键API使用方法。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

文章转载自http://dev.uphoneapp.com/doc/view.xhtml?id=52261
JSON格式解析和libjson使用简介

在阅读本文之前，请先阅读下《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://news.mtc.sohu.com/news/channel/1/news.rss", 
 desc:"家事、国事、天下事" 
 }, 
 { 
 title:"新闻频道", 
 link:"http://news.mtc.sohu.com/news/channel/2/news.rss", 
 desc:"让您实时掌握国际动态" 
 }, 
 { 
 title:"军事频道", 
 link:"http://news.mtc.sohu.com/news/channel/3/news.rss", 
 desc:"军事" 
 } 
 ] 
 }, 
  
 { 
 name:"体育新闻", 
 subchnls:[ 
 { 
 title:"体育要闻汇总", 
 link:"http://news.mtc.sohu.com/news/channel/4/news.rss", 
 desc:"erewr" 
 }, 
 { 
 title:"国际足坛", 
 link:"http://news.mtc.sohu.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:

 
 
 #definecJSON_False0 
 #definecJSON_True1 
 #definecJSON_NULL2 
 #definecJSON_Number3 
 #definecJSON_String4 
 #definecJSON_Array5 
 #definecJSON_Object6 

cJSON 结构体:

 
  
 typedefstructcJSON 
 { 
 structcJSON*next,*prev;//指向上一项/下一项 
 structcJSON*child;//指向下一级，也就是当type为cJSON_Object或cJSON_Array时，此指针不为空。 
 inttype; 
 char*valuestring;//当type为cJSON_String时 
 intvalueint;//当type为cJSON_Number时 
 doublevaluedouble;//当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结构体变量指针与该项的名称来获取其指针，举个例子：

 
 
 boolbResult; 
 charjsonString[]=“{result:true}”; 
 //获取result的值true 
 cJSON*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; 
 charjsonString[]=“{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; 
 intnCount=cJSON_GetArraySize(pArray);//获取pArray数组的大小 
 for(inti=0;i<nCount;i++) 
 { 
 pArrayItem=cJSON_GetArrayItem(pArray,i); 
 out=cJSON_Print(pArrayItem);//将pArrayItem的值以字串的形式打印到char型buffer上，cJSON_Print()会自动分配内存空间，用完需要释放内存。 
 SS_printf(“arrayitem%d:%s\n”,i,out); 
 Free(out); 
 } 
 } 
 cJSON_Delete(pRoot); 
 } 
 
 

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

TChannelsData.h:

 
  
 /**子频道信息结构体 
 * 
 */ 
 structSUBCHNL_DATA 
 { 
 SUBCHNL_DATA(); 
 voidclear(); 
 
 TUChar*m_title; 
 char*m_link; 
 TUChar*m_desc; 
 }; 
 
 /**大频道信息结构体 
 * 
 */ 
 structCHANNEL_DATA 
 { 
 CHANNEL_DATA(); 
 
 TUChar*m_pszTitle; 
 vectorm_aSubChnlList; 
 }; 
 
 //…………. 
 //TChannelsData类成员变量：RSSReaderConfig版本号 
 charm_pszVersion[32]; 
 //TChannelsData类成员变量：频道信息列表 
 vectorm_aChnlsList; 
 //…………. 
 
 

TChannelsData.cpp:

 
  
 /**解析JSON格式的内容 
 * 
 *\parampszJsonText解析的JSON格式内容字串 
 * 
 *\returntrue:有更新数据;false:没有更新数据 
 */ 
 BooleanTChannelsData::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) 
 { 
 returnFALSE; 
 } 
 } 
 else 
 { 
 returnFALSE; 
 } 
 
 //获取更新数据，根节点root 
 objRootItem=cJSON_GetObjectItem(objJson,"root"); 
 if(objRootItem) 
 { 
 cJSON*objJsonItem=NULL; 
 
 //获取版本号 
 objJsonItem=cJSON_GetObjectItem(objRootItem,"version"); 
 if(objJsonItem) 
 { 
 Int32nLen=strlen(objJsonItem->valuestring); 
 strncpy(m_pszVersion,objJsonItem->valuestring,(nLen<32)?nLen:31); 
 } 
 
 //解析出大频道 
 _ParseChannels(objRootItem); 
 } 
  
 //SS_printf("=======[parsejson]%s\n",out); 
 cJSON_Delete(objJson); 
 //free(out); 
 } 
 
 returnTRUE; 
 } 
 
 /**解析出大频道 
 * 
 *\parampCJsoncJSON对象指针 
 * 
 *\returnvoid 
 */ 
 voidTChannelsData::_ParseChannels(cJSON*pCJson) 
 { 
 cJSON*pJsonArray=NULL; 
 
 if(!pCJson) 
 { 
 return; 
 } 
 
 pJsonArray=cJSON_GetObjectItem(pCJson,"channels"); 
 if(pJsonArray) 
 { 
 cJSON*pArrayItem=NULL; 
 cJSON*pJsonTemp=NULL; 
 
 Int32nSize=cJSON_GetArraySize(pJsonArray); 
 for(Int32i=0;i<nSize;i++) 
 { 
 pArrayItem=cJSON_GetArrayItem(pJsonArray,i); 
 if(pArrayItem) 
 { 
 CHANNEL_DATAtChannelData; 
 Int32nLen=0; 
 
 //获取大频道名称 
 tChannelData.m_pszTitle=_JsonGetTUString(pArrayItem,"name"); 
  
 //解析出子频道 
 _ParseSubChnls(tChannelData.m_aSubChnlList,pArrayItem); 
 
 //将大频道信息对象压入列表中 
 m_aChnlsList.push_back(tChannelData); 
 } 
 else 
 { 
 continue; 
 } 
 } 
 } 
 } 
 
 /**解析子频道 
 * 
 *\paramaSubChnlList存放子频道数据的vector对象 
 *\parampCJsoncJSON对象指针 
 * 
 *\returnvoid 
 */ 
 voidTChannelsData::_ParseSubChnls(vector&aSubChnlList,cJSON*pCJson) 
 { 
 cJSON*pJsonArray=NULL; 
 
 if(!pCJson) 
 { 
 return; 
 } 
 
 pJsonArray=cJSON_GetObjectItem(pCJson,"subchnls"); 
 if(pJsonArray) 
 { 
 cJSON*pArrayItem=NULL; 
 //cJSON*pJsonTemp=NULL; 
 
 Int32nSize=cJSON_GetArraySize(pJsonArray); 
 for(Int32i=0;i<nSize;i++) 
 { 
 pArrayItem=cJSON_GetArrayItem(pJsonArray,i); 
 if(pArrayItem) 
 { 
 SUBCHNL_DATAtSubChnlData; 
 Int32nLen=0; 
 
 //gettitle 
 tSubChnlData.m_title=_JsonGetTUString(pArrayItem,"title"); 
 
 //getlink 
 tSubChnlData.m_link=_JsonGetString(pArrayItem,"link"); 
 
 //getdesc 
 tSubChnlData.m_desc=_JsonGetTUString(pArrayItem,"desc"); 
 
 aSubChnlList.push_back(tSubChnlData); 
 } 
 } 
 } 
 } 
 
 /**获取指定的cJSON对象的指定属性值 
 * 
 *\parampJsonItemcJSON对象指针 
 *\parampszKeycJSON对象属性 
 * 
 *\return返回JSON对象的值，以TUChar字串形式返回 
 */ 
 TUChar*TChannelsData::_JsonGetTUString(cJSON*pJsonItem,char*pszKey) 
 { 
 TUChar*pszValue=NULL; 
 Int32nLen; 
 cJSON*pJsonTemp=NULL; 
 
 pJsonTemp=cJSON_GetObjectItem(pJsonItem,pszKey); 
 if(pJsonTemp) 
 { 
 nLen=strlen(pJsonTemp->valuestring)+1; 
 pszValue=newTUChar[nLen]; 
 if(pszValue) 
 { 
 MemSet(pszValue,0,nLen*sizeof(TUChar)); 
 TUString::StrUtf8ToStrUnicode(pszValue,(constChar*)pJsonTemp->valuestring); 
 } 
 } 
 
 returnpszValue; 
 } 
 
 /**获取指定的cJSON对象的指定属性值 
 * 
 *\parampJsonItemcJSON对象指针 
 *\parampszKeycJSON对象属性 
 * 
 *\return返回JSON对象的值，以char字串形式返回 
 */ 
 char*TChannelsData::_JsonGetString(cJSON*pJsonItem,char*pszKey) 
 { 
 char*pszValue=NULL; 
 Int32nLen; 
 cJSON*pJsonTemp=NULL; 
 
 pJsonTemp=cJSON_GetObjectItem(pJsonItem,pszKey); 
 if(pJsonTemp) 
 { 
 nLen=strlen(pJsonTemp->valuestring)+1; 
 pszValue=newchar[nLen]; 
 if(pszValue) 
 { 
 MemSet(pszValue,0,nLen); 
 strncpy(pszValue,pJsonTemp->valuestring,nLen-1); 
 } 
 } 
 
 returnpszValue; 
 } 
 
 /**获取指定的cJSON对象的指定属性值 
 * 
 *\parampJsonItemcJSON对象指针 
 *\parampszKeycJSON对象属性 
 * 
 *\return返回JSON对象的值，以int32形式返回 
 */ 
 Int32TChannelsData::_JsonGetInt(cJSON*pJsonItem,char*pszKey) 
 { 
 Int32nValue=0; 
 cJSON*pJsonTemp=NULL; 
 
 pJsonTemp=cJSON_GetObjectItem(pJsonItem,pszKey); 
 if(pJsonTemp) 
 { 
 nValue=pJsonTemp->valueint; 
 } 
 
 returnnValue; 
 } 
 
 /**获取指定的cJSON对象的指定属性值 
 * 
 *\parampJsonItemcJSON对象指针 
 *\parampszKeycJSON对象属性 
 * 
 *\return返回JSON对象的值，以Boolean形式返回 
 */ 
 BooleanTChannelsData::_JsonGetBoolean(cJSON*pJsonItem,char*pszKey) 
 { 
 BooleanbValue=FALSE; 
 cJSON*pJsonTemp=NULL; 
 
 pJsonTemp=cJSON_GetObjectItem(pJsonItem,pszKey); 
 if(pJsonTemp) 
 { 
 if(pJsonTemp->valueint) 
 { 
 bValue=TRUE; 
 } 
 } 
 
 returnbValue; 
 } 
 
 