在阅读本文之前,请先阅读下《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://bitsCN.com/news/channel/1/news.rss", desc:"家事、国事、天下事" }, { title:"新闻频道", link:"http://bitsCN.com/news/channel/2/news.rss", desc:"让您实时掌握国际动态" }, { title:"军事频道", link:"http://bitsCN.com/news/channel/3/news.rss", desc:"军事" } ] }, { name:"体育新闻", subchnls:[ { title:"体育要闻汇总", link:"http://bitsCN.com/news/channel/4/news.rss", desc:"erewr" }, { title:"国际足坛", link:"http://bitsCN.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结构体变量指针与该项的名称来获取其指针,举个例子: