JSONc语言开发指南剖析.docx
《JSONc语言开发指南剖析.docx》由会员分享，可在线阅读，更多相关《JSONc语言开发指南剖析.docx（18页珍藏版）》请在冰点文库上搜索。
JSONc语言开发指南剖析
JSONc语言开发指南
版本
修改记录
日期
修订人
1.引言
本文档是基于json-c库对数据交换进行开发所编写的开发指南，及详细解释json-c库中常用api。
适用于开发人员使用c语言对json的编程。
（注：
此文档json-c库版本为0.8——json-c-0.8）
2.JSON简介
JSON（JavaScriptObjectNotation）是一种轻量级的数据交换格式。
易于人阅读和编写。
同时也易于机器解析和生成。
它基于JavaScriptProgrammingLanguage,StandardECMA-2623rdEdition-December1999的一个子集。
JSON采用完全独立于语言的文本格式，但是也使用了类似于C语言家族的习惯（包括C,C++,C#,Java,JavaScript,Perl,Python等）。
这些特性使JSON成为理想的数据交换语言。
跟XML相比，JSON的优势在于格式简洁短小，特别是在处理大量复杂数据的时候，这个优势便显得非常突出。
从各浏览器的支持来看，JSON解决了因不同浏览器对XMLDOM解析方式不同而引起的问题。
2.1JSON建构于两种结构：
∙“名称/值”对的集合（Acollectionofname/valuepairs）。
不同的语言中，它被理解为对象（object），纪录（record），结构（struct），字典（dictionary），哈希表（hashtable），有键列表（keyedlist），或者关联数组（associativearray）。
∙值的有序列表（Anorderedlistofvalues）。
在大部分语言中，它被理解为数组（array）。
这些都是常见的数据结构。
事实上大部分现代计算机语言都以某种形式支持它们。
这使得一种数据格式在同样基于这些结构的编程语言之间交换成为可能。
2.2JSON具有以下这些形式：
对象是一个无序的“‘名称/值’对”集合。
一个对象以“{”（左括号）开始，“}”（右括号）结束。
每个“名称”后跟一个“:
”（冒号）；“‘名称/值’对”之间使用“,”（逗号）分隔。
数组是值（value）的有序集合。
一个数组以“[”（左中括号）开始，“]”（右中括号）结束。
值之间使用“,”（逗号）分隔。
值（value）可以是双引号括起来的字符串（string）、数值（number）、true、false、null、对象（object）或者数组（array）。
这些结构可以嵌套。
字符串（string）是由双引号包围的任意数量Unicode字符的集合，使用反斜线转义。
一个字符（character）即一个单独的字符串（characterstring）。
字符串（string）与C或者Java的字符串非常相似。
数值（number）也与C或者Java的数值非常相似。
除去未曾使用的八进制与十六进制格式。
除去一些编码细节。
3.JSON库函数说明
3.1JSON对象的生成
Json对象的类型：
json_type_object,“名称/值”对的集合
Json对象的值类型
json_type_boolean,
json_type_double,
json_type_int,
json_type_array,“值”的集合
json_type_string
structjson_object*）;
说明：
创建个空的json_type_object类型JSON对象。
structjson_object*booleanb）;
说明：
创建个json_type_boolean值类型json对象
booleanstructjson_object*obj）;
说明：
从json对象中boolean值类型得到boolean值
同样：
structjson_object*inti）
intstructjson_object*this）
structjson_object*doubled）
doublestructjson_object*this）
structjson_object*char*s）
char*structjson_object*this）
structjson_object*）;
说明：
创建个空的json_type_array类型JSON数组值对象。
structjson_object*char*str）;
说明：
由str里的JSON字符串生成JSON对象，str是son_object_to_）生成的。
参数：
str–json字符串
structjson_object*structjson_object*json,char*name）;
说明：
从json中按名字取一个对象。
参数：
json–json对象
name-json域名字
3.2JSON对象的释放
structjson_object**structjson_object*this）
说明：
增加对象引用计数。
使用c库最关心的是内存谁来分配,谁来释放.jsonc的内存管理方式,是基于引用计数的内存树（链）,如果把一个structjson_object对象a,add到另一个对象b上,就不用显式的释放（json_object_put）a了,相当于把a挂到了b的对象树上,释放b的时候,就会释放a.当a即add到b上,又add到对象c上时会导致a被释放两次（doublefree）,这时可以增加a的引用计数（调用函数a））,这时如果先释放b,后释放c,当释放b时,并不会真正的释放a,而是减少a的引用计数为1,然后释放c时,才真正释放a.
参数：
this–json对象
Voidstructjson_object*this）
说明：
减少对象引用次数一次，当减少到0就释放（free）资源
参数：
this–json对象
样例片段：
my_string="\t"）;
/*输出my_string=*/\t（table键）
printf（"my_string=%s\n",my_string））;
/*转换json格式字符串输出my_string.to_string（）="\t"*/
printf（"my_string.to_string（）=%s\n",my_string））;
/*释放资源*/
my_string）;
3.3JSON对象的操作
Intstructjson_object*this,enumjson_typetype）
说明：
检查json_object是json的某个类型
参数：
this:
json_object实例
type:
json_type_boolean,json_type_double,json_type_int,json_type_object,json_type_array,json_type_string
enumjson_typejson_object_get_type（structjson_object*this）
说明：
得到json_object的类型。
参数：
this–json对象
char*structjson_object*this）
说明：
将json_object内容转换json格式字符串，其中可能含有转义符。
参数：
this–json对象
返回值：
Json格式字符串
voidstructjson_object*obj,char*key,structjson_object*val）;
说明：
添加个对象域到json对象中
参数：
Obj–json对象
key–域名字
val–json值对象
voidstructjson_object*obj,char*key）;
说明：
删除key值json对象
参数：
obj–json对象
key–域名字
intstructjson_object*obj）;
说明：
得到json对象数组的长度。
参数：
obj–json数组值对象
externintstructjson_object*obj,
structjson_object*val）;
说明：
添加一元素在json对象数组末端
参数：
obj–json数组值对象
val–json值对象
*
intstructjson_object*obj,intidx,
structjson_object*val）;
说明：
在指定的json对象数组下标插入或替换一个json对象元素。
参数：
obj–json数组值对象
val–json值对象
idx–数组下标
structjson_object*structjson_object*json_array,inti）;
说明：
从数组中，按下标取JSON值对象。
参数：
json_array–json数组类型对象
i–数组下标位置
定义宏obj,key,val）
说明：
遍历json对象的key和值（key,val默认参数不变）
样例片段：
/*创建个空json对象值数组类型*/
my_array=）;
/*添加json值类型到数组中*/
my_array,1））;
my_array,2））;
my_array,3））;
my_array,4,5））;
printf（"my_array=\n"）;
for（i=0;istructjson_object*obj=my_array,i）;
printf（"\t[%d]=%s\n",i,obj））;
}
printf（"my_array.to_string（）=%s\n",my_array））;
my_object=）;
/*添加json名称和值到json对象集合中*/
my_object,"abc",12））;
my_object,"foo","bar"））;
my_object,"bool0",0））;
my_object,"bool1",1））;
my_object,"baz","bang"））;
/*同样的key添加会替换掉*/
my_object,"baz","fark"））;
my_object,"baz"）;
/*添加数组集合到json对象中*/
my_object,"arr",my_array）;
printf（"my_object=\n"）;
/*遍历json对象集合*/
my_object,key,val）{
printf（"\t%s:
%s\n",key,val））;
}
my_object）;
4.JSON实例开发
4.1样例1
#include
#include
#include
#include
#include"json.h"
intmain（intargc,char**argv）
{
structjson_tokener*tok;
structjson_object*my_string,*my_int,*my_object,*my_array;
structjson_object*new_obj;
inti;
my_string="\t"）;
/*输出my_string=*/
printf（"my_string=%s\n",my_string））;
/*转换json格式字符串输出my_string.to_string（）="\t"*/
printf（"my_string.to_string（）=%s\n",my_string））;
/*释放资源*/
my_string）;
my_string="\\"）;
printf（"my_string=%s\n",my_string））;
printf（"my_string.to_string（）=%s\n",my_string））;
my_string）;
my_string="foo"）;
printf（"my_string=%s\n",my_string））;
printf（"my_string.to_string（）=%s\n",my_string））;
my_int=9）;
printf（"my_int=%d\n",my_int））;
printf（"my_int.to_string（）=%s\n",my_int））;
/*创建个空json对象值数组类型*/
my_array=）;
/*添加json值类型到数组中*/
my_array,1））;
my_array,2））;
my_array,3））;
my_array,4,5））;
printf（"my_array=\n"）;
for（i=0;istructjson_object*obj=my_array,i）;
printf（"\t[%d]=%s\n",i,obj））;
}
printf（"my_array.to_string（）=%s\n",my_array））;
my_object=）;
/*添加json名称和值到json对象集合中*/
my_object,"abc",12））;
my_object,"foo","bar"））;
my_object,"bool0",0））;
my_object,"bool1",1））;
my_object,"baz","bang"））;
/*同样的key添加会替换掉*/
my_object,"baz","fark"））;
my_object,"baz"）;
printf（"my_object=\n"）;
/*遍历json对象集合*/
my_object,key,val）{
printf（"\t%s:
%s\n",key,val））;
}
printf（"my_object.to_string（）=%s\n",my_object））;
/*对些不规则的串做了些解析测试*/
new_obj="\"\003\""）;
printf（"new_obj.to_string（）=%s\n",new_obj））;
new_obj）;
new_obj="/*hello*/\"foo\""）;
printf（"new_obj.to_string（）=%s\n",new_obj））;
new_obj）;
new_obj="//hello\n\"foo\""）;
printf（"new_obj.to_string（）=%s\n",new_obj））;
new_obj）;
new_obj="\"\\u0041\\u0042\\u0043\""）;
printf（"new_obj.to_string（）=%s\n",new_obj））;
new_obj）;
new_obj="null"）;
printf（"new_obj.to_string（）=%s\n",new_obj））;
new_obj）;
new_obj="True"）;
printf（"new_obj.to_string（）=%s\n",new_obj））;
new_obj）;
new_obj="12"）;
printf（"new_obj.to_string（）=%s\n",new_obj））;
new_obj）;
new_obj="12.3"）;
/*得到jsondouble类型
printf（"new_obj.to_string（）=%s\n",new_obj））;
new_obj）;
new_obj="[\"\\n\"]"）;
printf（"new_obj.to_string（）=%s\n",new_obj））;
new_obj）;
new_obj="[\"\\nabc\\n\"]"）;
printf（"new_obj.to_string（）=%s\n",new_obj））;
new_obj）;
new_obj="[null]"）;
printf（"new_obj.to_string（）=%s\n",new_obj））;
new_obj）;
new_obj="[]"）;
printf（"new_obj.to_string（）=%s\n",new_obj））;
new_obj）;
new_obj="[false]"）;
printf（"new_obj.to_string（）=%s\n",new_obj））;
new_obj）;
new_obj="[\"abc\",null,\"def\",12]"）;
printf（"new_obj.to_string（）=%s\n",new_obj））;
new_obj）;
new_obj="{}"）;
printf（"new_obj.to_string（）=%s\n",new_obj））;
new_obj）;
new_obj="{\"foo\":
\"bar\"}"）;
printf（"new_obj.to_string（）=%s\n",new_obj））;
new_obj）;
new_obj="{\"foo\":
\"bar\",\"baz\":
null,\"bool0\":
true}"）;
printf（"new_obj.to_string（）=%s\n",new_obj））;
new_obj）;
new_obj="{\"foo\":
[null,\"foo\"]}"）;
printf（"new_obj.to_string（）=%s\n",new_obj））;
new_obj）;
new_obj="{\"abc\":
12,\"foo\":
\"bar\",\"bool0\":
false,\"bool1\":
true,\"arr\":
[1,2,3,null,5]}"）;
printf（"new_obj.to_string（）=%s\n",new_obj））;
new_obj）;
new_obj="{foo}"）;
if（is_error（new_obj））printf（"goterrorasexpected\n"）;
new_obj="foo"）;
if（is_error（new_obj））printf（"goterrorasexpected\n"）;
new_obj="{\"foo"）;
if（is_error（new_obj））printf（"goterrorasexpected\n"）;
/*testincrementalparsing*/
tok=）;
new_obj=tok,"{\"foo",6）;
if（is_error（new_obj））printf（"goterrorasexpected\n"）;
new_obj=tok,"\":
{\"bar",8）;
if（is_error（new_obj））printf（"goterrorasexpected\n"）;
new_obj=tok,"\":
13}}",6）;
printf（"new_obj.to_string（）=%s\n",new_obj））;
new_obj）;
tok）;
my_string）;
my_int）;
my_object）;
my_array）;
/*如果前面没有添加到对象中，必须显示释放，
如果添加到对象中，已经释放对象，则无需调用，在这务必小心，否则很容易内存泄漏*/
return0;
}
输出结果：
my_string=
my_string.to_string（）="\t"
my_string=\
my_string.to_string（）="\\"
my_string=foo
my_string.to_string（）="foo"
my_int=9
my_int.to_string（）=9
my_array=
[0]=1
[1]=2
[2]=3
[3]=null
[4]=5
my_array.to_string（）=[1,2,3,null,5]
my_object=
abc:
12
foo:
"bar"
bool0:
false
bool1:
true
my_object.to_string（）={"abc":
12,"foo":
"bar","bool0":
false,"bool1":
true}
new_obj.to_string（）="\u0003"
new_obj.to_string（）="foo"
new_obj.to_string（）="foo"
new_obj.to_string（）="ABC"
new_obj.to_string（）=null
new_obj.to_string（）=true
new_obj.to_string（）=12
new_obj.to_string（）=12.300000
new_obj.to_string（）=["\n"]
new_obj.to_string（）=["\nabc\n"]
new_obj.to_string（）=[null]
new_obj.to_string（）=[]
new_obj.to_string（）=[false]
new_obj.to_string（）=["abc",null,"def",12]
new_obj.to_string（）={}
new_obj.to_string（）={"
升级会员 