json格式解析和libjson的用法介紹(關(guān)于cjson的使用方法)
在閱讀本文之前,請先閱讀下《Rss Reader實(shí)例開發(fā)之系統(tǒng)設(shè)計(jì)》一文。
Rss Reader實(shí)例開發(fā)中,進(jìn)行網(wǎng)絡(luò)數(shù)據(jù)交換時(shí)主要使用到了兩種數(shù)據(jù)格式:JSON與XML。本文主要介紹JSON格式的簡單概念及JSON在Rss Reader中的應(yīng)用,XML格式的使用將在下一篇文章做介紹。
JSON簡介:
JSON(JavaScript Object Notation) 是一種輕量級的數(shù)據(jù)交換格式,可以把JSON的結(jié)構(gòu)理解成無序的、可嵌套的key-value鍵值對集合,這些key-value鍵值對是以結(jié)構(gòu)體或數(shù)組的形式來組織的。同一級的key-value鍵值對之間是用一個(gè)“,”(逗號)隔開,每個(gè)key-value鍵值對是由一個(gè)key后面緊接一個(gè)“:”(冒號),冒號后面是這個(gè)key對應(yīng)的value。Key是一個(gè)word,由大小寫字母、下劃線及數(shù)字組成,可以由雙引號封閉,也可以不加雙引號;而value的取值集為:Number、Boolean(true或false)、null、String、Object及Array,如圖一:
(圖一)
1、Number:數(shù)值,包括整形數(shù)與浮點(diǎn)數(shù),如:123、0.83、-2.7e10。其結(jié)構(gòu)如圖二:
(圖二)
2、String:字符串,是以雙引號封閉起來的一串字符,使用反斜杠來轉(zhuǎn)義,如:\\、\n等,JSON中字符串的概念與C/C++或者JAVA語言里的字符串概念差不多,如:”abc”。其結(jié)構(gòu)如圖三:
(圖三)
3、Object:對象,也可理解成一個(gè)結(jié)構(gòu)體,是以一對大括號封閉起來的無序的key-value鍵值對集合,例如:{name:"Susan", age:27, birthday:{year:1984, month:2, day:11}};也可以寫成:{"name":"Susan", "age":27, "birthday":{"year":1984, "month":2, "day":11}};其結(jié)構(gòu)如圖四:
(圖四)
4、Array:數(shù)組,JSON的數(shù)組是一個(gè)以中括號封閉起來的value的集合,即數(shù)組內(nèi)的各個(gè)成員的數(shù)據(jù)類型可以不一樣,這一點(diǎn)就跟C/JAVA的數(shù)組概念不同了。每個(gè)value之間是由一個(gè)“,”(逗號)隔開,例如:[123, abc, false, {name:mj}];其結(jié)構(gòu)如圖五:
(圖五)
關(guān)于JSON的詳細(xì)說明與教程請自行到網(wǎng)絡(luò)上搜索,有很多。
下面我們就來動(dòng)手寫一個(gè)例子:
{ result:true, root:{ version:"201007091640", channels:[ { name:"新聞中心", subchnls:[ { title:"焦點(diǎn)新聞", link:"http://jb51.net/news/channel/1/news.rss", desc:"家事、國事、天下事" }, { title:"新聞?lì)l道", link:"http://jb51.net/news/channel/2/news.rss", desc:"讓您實(shí)時(shí)掌握國際動(dòng)態(tài)" }, { title:"軍事頻道", link:"http://jb51.net/news/channel/3/news.rss", desc:"軍事" } ] }, { name:"體育新聞", subchnls:[ { title:"體育要聞匯總", link:"http://jb51.net/news/channel/4/news.rss", desc:"erewr" }, { title:"國際足壇", link:"http://jb51.net/news/channel/5/news.rss", desc:"werewr" } ] } ] } }
這段JSON描述了一個(gè)對象(最外層大括號包圍的部分),為了方便區(qū)分,我們就將其稱為對象A吧。對象A有兩個(gè)Item(即key-value鍵值對),一個(gè)是result,其值為true;一個(gè)是root,其值為一個(gè)對象,稱為對象B。對象B也有兩個(gè)Item,一個(gè)是version,其值為一個(gè)字串” 201007091640”;一個(gè)是channels,其值是一個(gè)數(shù)組,而數(shù)組的成員都是一個(gè)對象,每個(gè)對象又包含兩個(gè)Item,一個(gè)是name,值分別為字串"新聞中心"和"體育新聞";一個(gè)是subchnls,值都是數(shù)組,每個(gè)數(shù)組又分別有若干個(gè)成員,每個(gè)subchnls成員也都是一個(gè)對象,每個(gè)對象都有三個(gè)Item:title、link和desc。也許你看到這,已經(jīng)是一頭大汗了,不過沒關(guān)系,我們來帖張這段JSON文本對應(yīng)的結(jié)構(gòu)圖,有圖就有真相,請看圖六:
(圖六:黑色實(shí)線為對象,虛線為值,橙色實(shí)線為數(shù)組)
在RssReader中使用cJSON:
在RssReader中使用了開源庫cJSON來解析JSON,所以在此就介紹下cJSON的使用:
在CJSON中,一個(gè)key-value鍵值對被解析并存放在一個(gè)cJSON結(jié)構(gòu)體變量中,其value取值集為:FALSE,TRUE,NULL,NUMBER,STRING,OBJECT,ARRAY。它們分別被存放在CJSON對象的child、valuestring、valueint、valuedouble變量中,而用于判斷某個(gè)CJSON對象value的數(shù)據(jù)類型則是CJSON對象的type變量,其取值范圍與CJSON對象的value集是一一對應(yīng)的,如:cJSON_False對應(yīng)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 結(jié)構(gòu)體:
typedef struct cJSON { struct cJSON *next,*prev; //指向上一項(xiàng)/下一項(xiàng) struct cJSON *child; //指向下一級,也就是當(dāng)type為cJSON_Object或cJSON_Array時(shí),此指針不為空。 int type; char *valuestring; // 當(dāng)type為cJSON_String時(shí) int valueint; // 當(dāng) type為cJSON_Number時(shí) double valuedouble; //當(dāng)type為cJSON_Number時(shí) char *string; // 當(dāng)前項(xiàng)的名稱,也就是key-value鍵值對的key } cJSON;
在解析JSON過程中,從JSON格式描述的value數(shù)據(jù)到CJSON對象中存放的變量的一個(gè)映射關(guān)系如圖七:
(圖七)
對CJSON格式的解析是使用cJSON_Parse()方法,其傳入的參數(shù)是一個(gè)CJSON的Object/Array結(jié)構(gòu)的字串,解析成功則返回一個(gè)cJSON結(jié)構(gòu)體變量的指針,在使用完成后需要調(diào)用cJSON_Delete()將該指針銷毀。CJSON是以樹狀結(jié)構(gòu)來組織內(nèi)部的各個(gè)cJSON結(jié)構(gòu)體變量的,一般地,要使用某個(gè)cJSON結(jié)構(gòu)體變量,需要調(diào)用cJSON_GetObjectItem()方法并根據(jù)其父節(jié)點(diǎn)的cJSON結(jié)構(gòu)體變量指針與該項(xiàng)的名稱來獲取其指針,舉個(gè)例子:
bool bResult; char jsonString[] = “{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為何類型,都是通過調(diào)用cJSON_GetObjectItem()方法獲取其對應(yīng)的cJSON結(jié)構(gòu)體變量的指針,只是在處理其對應(yīng)的值時(shí)會有所不同。如果result的值type為cJSON_Object,則需要通過調(diào)用cJSON_GetObjectItem( pItem, “subItemKey”)來獲取其子Item的指針。在處理值type為cJSON_Array的Item時(shí),就需要再用到另外兩個(gè)API:cJSON_GetArraySize ()和cJSON_GetArrayItem()。我們舉個(gè)獲取一個(gè)數(shù)組成員值的例子:
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數(shù)組的大小 for( int i = 0; i < nCount; i++) { pArrayItem = cJSON_GetArrayItem(pArray, i); out = cJSON_Print( pArrayItem ); //將pArrayItem的值以字串的形式打印到char型buffer上,cJSON_Print()會自動(dòng)分配內(nèi)存空間,用完需要釋放內(nèi)存。 SS_printf( “array item %d: %s\n”, i, out); Free( out ); } } cJSON_Delete ( pRoot ); }
在提取一個(gè)復(fù)雜的JSON格式的數(shù)據(jù)時(shí),也只是將以上兩個(gè)例子使用到的方法進(jìn)行組合調(diào)用罷了。所以對CJSON提供的API的使用是很簡單有效的。有了以上知識的了解,我們就可以編寫一些代碼將例一中的JSON解析并提取其中的數(shù)據(jù),還是貼點(diǎn)代碼才是硬道理,代碼如下:
TChannelsData.h:
/** 子頻道信息結(jié)構(gòu)體 * */ struct SUBCHNL_DATA { SUBCHNL_DATA(); void clear(); TUChar * m_title; char * m_link; TUChar * m_desc; }; /** 大頻道信息結(jié)構(gòu)體 * */ struct CHANNEL_DATA { CHANNEL_DATA(); TUChar* m_pszTitle; vector m_aSubChnlList; }; //…………. // TChannelsData 類成員變量:RSSReaderConfig 版本號 char m_pszVersion[32]; // TChannelsData 類成員變量:頻道信息列表 vector m_aChnlsList; //…………. TChannelsData.cpp: /** 解析JSON格式的內(nèi)容 * * \param pszJsonText 解析的JSON格式內(nèi)容字串 * * \return true:有更新數(shù)據(jù); false:沒有更新數(shù)據(jù) */ 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; } //獲取更新數(shù)據(jù),根節(jié)點(diǎn)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 存放子頻道數(shù)據(jù)的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; }
總結(jié):
JSON的結(jié)構(gòu)簡約,所以使得JSON的文檔的數(shù)據(jù)量比較小,比較適合用于網(wǎng)絡(luò)數(shù)據(jù)的交換,而且對JSON文檔的解析和數(shù)據(jù)提取的方法也很簡單,方便程序員的使用,當(dāng)然也正是因?yàn)镴SON的結(jié)構(gòu)簡約,使得JSON的可讀性與可編輯性會稍差于XML,所以JSON比較適合在較少有人工閱讀和編輯的情況下使用期。
備注:經(jīng)驗(yàn)證名稱需加“ 比如char jsonString[] = "{\"result\":true}";
以上就是小編為大家?guī)淼膉son格式解析和libjson的用法介紹(關(guān)于cjson的使用方法)全部內(nèi)容了,希望大家多多支持腳本之家~
相關(guān)文章
貪心算法的C語言實(shí)現(xiàn)與運(yùn)用詳解
這篇文章主要介紹了貪心算法的C語言實(shí)現(xiàn)與運(yùn)用詳解,運(yùn)用么,就是文中所附的ACM練習(xí)題,哈哈:D需要的朋友可以參考下2015-08-08QT編寫窗口插件實(shí)現(xiàn)調(diào)用窗口的自適應(yīng)
這篇文章主要為大家詳細(xì)介紹了QT編寫窗口插件實(shí)現(xiàn)調(diào)用窗口的自適應(yīng),文中示例代碼介紹的非常詳細(xì),具有一定的參考價(jià)值,感興趣的小伙伴們可以參考一下2021-06-06C++中sprintf使用的方法與printf的區(qū)別分析
這篇文章主要介紹了C++中sprintf使用的方法與printf的區(qū)別,實(shí)例分析了sprintf與printf的具體用法及相關(guān)注意事項(xiàng),具有一定參考借鑒價(jià)值,需要的朋友可以參考下2015-01-01