【唠叨】

在游戏中使用Json来储存数据，既方便读取，又方便管理。

比如CocosStudio 1.6之前版本导出的资源扩展名就是 .ExportJson 格式的。

Cocos2d-x 3.x 加入了rapidjson库用于json解析。位于external/json下。

本节要介绍的就是：如何使用 rapidjson库 来操作处理json文件。

【参考】

http://www.w3school.com.cn/json/index.asp（W3School）

http://cn.cocos2d-x.org/tutorial/show?id=1203（【官方文档】rapidjson用法）

http://cn.cocos2d-x.org/tutorial/show?id=1556（RapidJson解析）

http://cn.cocos2d-x.org/tutorial/show?id=1528 （rapidjson获取Json数据的实战经验）

【Json简介】

摘自：http://www.w3school.com.cn/json/index.asp

1、什么是Json？

>JSON 指的是 JavaScript 对象表示法（JavaScript Object Notation）。

>JSON 是轻量级的存储和文本数据交换格式，类似XML。

>JSON 比 XML 更小、更快，更易解析。

>JSON 具有自我描述性，更易理解。

>JSON 独立于语言 * 。

* JSON 使用 JavaScript 语法来描述数据对象，但是 JSON 仍然独立于语言和平台。

* JSON 解析器和 JSON 库支持许多不同的编程语言。

2、语法规则

JSON 语法是 JavaScript 对象表示法语法的子集。

（1）数据在“名称/值对”中，即 键值对（key-value）形式。

（2）每条数据由“逗号”分隔。

（3）“花括号”{ } 保存 对象。

（4）“方括号”[ ] 保存 数组。

2.1、名称/值对

JSON 数据的书写格式是：名称/值对（键值对 key-value）。

名称/值对，包括字段名称（在双引号中），后面写一个冒号，然后是值。

////"名称":"值""firstName":"John"//错误。名称必须加双引号""name:"Alice"//

2.2、值

JSON的值可以是：

> null

>逻辑值（boolean）

>数字（number）

>字符串（string，在双引号 " " 中）

>数组（在方括号 [ ] 中）

>对象（在花括号 { } 中）

PS：即“名称/值对”数据中，其名称的冒号“ : ”后面对应的值可以不是字符串，也可以是数字、数组、对象等。

2.3、对象

JSON 对象在花括号中书写：{ } 。

对象可以包含多个名称/值对（可以理解为对象的 属性名/属性值）。

PS：名称必须要加双引号" "，并且对象中只能包含名称/值对的形式，不能只有一个值。

如下所示：

//{"name":"John",//正确"age":23,//正确"array":[1,2,3,4],//正确。值可以为数组形式"helloworld",//错误。不能仅为一个值name:"John"//错误。名称必须加双引号"name"}//

2.4、数组

JSON 数组在方括号中书写：[ ] 。

数组可包含多个值（可以为null、逻辑值、数字、字符串、对象、数组）。

PS：数组中只能包含值的形式，不能为名称/值的形式。

如下所示：

//[true,//逻辑值Bool123,//数字Number"888",//字符串String"helloworld",//字符串String{"name":"alice","age":23},//对象Object[1,2,3,4],//数组Object"name":"John"//错误。不能为名称/值的形式]//

【rapidjson】

Cocos2d-x 3.x 加入了 rapidjson库，用于Json解析。位于external/json下。

只支持标准的Json格式，一些非标准的Json格式不支持。一些常用的解析方法需要自己封装。注意判断解析节点是否存在。

PS：解析的Json文件，根节点必须为对象、或数组。不然无法解析。

如下所示：

1、添加头文件

如果只用于解析Json文件，只要前2行的头文件即可。

//#include"json/rapidjson.h"#include"json/document.h"#include"json/writer.h"#include"json/stringbuffer.h"//#include"json/filestream.h"//#include"json/prettywriter.h"usingnamespacerapidjson;//命名空间//

2、Json数据解析

Cocos封装的 rapidjson库，只能解析对象格式、或数组格式的Json文件。

2.1、解析对象格式的Json

Json文件中的数据，根节点为一个对象，所有属性在大花括号 { } 中。

对象中的数据，通过 名称/值 的形式进行访问。

Json文件内容如下：

//{"hello":"world","t":true,"f":false,"n":null,"i":123,"pi":3.1416,"array":[1,2,3,4],"object":{"name":"alice","age":23}}//

Json解析使用举例：

////[1]读取json文件内容std::stringstr=FileUtils::getInstance()->getStringFromFile("testJson.json");CCLOG("%s",str.c_str());//[2]创建用于处理json代码的类//创建rapidjson::Document类：用于操作json代码rapidjson::Documentd;//[3]解析json文件内容//其中rapidjson::kParseDefaultFlags=0，默认方式d.Parse<rapidjson::kParseDefaultFlags>(str.c_str());//d.Parse<0>(str.c_str());//也可以直接写<0>//[4]判断解析是否出错if(d.HasParseError()){CCLOG("GetParseError%s\n",d.GetParseError());return;}//[5]获取json中的数据//判断json文件是否为对象格式if(d.IsObject()){//是否有"hello"属性if(d.HasMember("hello")){CCLOG("%s",d["hello"].GetString());//方式一：直接获取}//是否有"i"属性if(d.HasMember("i")){rapidjson::Value&i=d["i"];//方式二：保存为rapidjson::Value&CCLOG("%d",i.GetInt());}//数组if(d.HasMember("array")){//获取数组中的元素：d["array"][i]for(inti=0;i<d["array"].Size();i++){CCLOG("%d:%d",i,d["array"][i].GetInt());}////也可以这么写//rapidjson::Value&array=d["array"];//for(inti=0;i<array.Size();i++){//CCLOG("%d:%d",i,array[i].GetInt());//}}//对象if(d.HasMember("object")){//判断"object"属性对应的值，是否为一个对象if(d["object"].IsObject()){//转化为rapidjson::Value&rapidjson::Value&object=d["object"];CCLOG("%s",d["object"]["name"].GetString());CCLOG("%d",object["age"].GetInt());}}}//

控制台输出结果：

2.2、解析数组格式的Json

json文件中的数据，根节点为一个数组，所有元素在一个大方括号 [ ] 中。

数组中的数据，通过下标的形式访问元素值（下标从0开始）。

Json文件内容如下：

//[true,123,"888","helloworld",{"name":"alice","age":23},[1,2,3,4]]//

Json解析使用举例：

////[1]读取json文件内容std::stringstr=FileUtils::getInstance()->getStringFromFile("testJson.json");CCLOG("%s",str.c_str());//[2]创建用于处理json代码的类//创建rapidjson::Document类：用于操作json代码rapidjson::Documentd;//[3]解析json文件内容//其中rapidjson::kParseDefaultFlags=0，默认方式d.Parse<rapidjson::kParseDefaultFlags>(str.c_str());//d.Parse<0>(str.c_str());//也可以直接写<0>//[4]判断解析是否出错if(d.HasParseError()){CCLOG("GetParseError%s\n",d.GetParseError());return;}//[5]获取json中的数据//判断json文件是否为数组格式if(d.IsArray()){rapidjson::Value&array=d;for(inti=0;i<array.Size();i++){if(d[i].IsBool()){//逻辑值CCLOG("%disBool:%d",i,array[i].GetBool());}if(d[i].IsNumber()){//数字CCLOG("%disNumber:%d",i,array[i].GetInt());}if(d[i].IsString()){//字符串CCLOG("%disString:%s",i,array[i].GetString());}if(d[i].IsObject()){//对象rapidjson::Value&object=d[i];CCLOG("%disObject:%s",i,array[i]["name"].GetString());CCLOG("%disObject:%d",i,object["age"].GetInt());}if(d[i].IsArray()){//数组for(intj=0;j<array[i].Size();j++){CCLOG("[%d,%d]isArray:%d",i,j,array[i][j].GetInt());}}}}//

控制台输出结果：

3、Json数据存储

3.1、存储为对象格式的Json

使用举例：

////[1]创建用于处理json代码的类//创建rapidjson::Document类：用于操作json代码rapidjson::Documentd;//[2]获取分配器rapidjson::Document::AllocatorType&allocator=d.GetAllocator();//[3]设置为对象格式SetObjectd.SetObject();//[4]添加数据//[4.1]往json对象中添加数据：名称/值对rapidjson::Valueobject(rapidjson::kObjectType);//创建对象object.AddMember("int",1,allocator);//添加"int":1object.AddMember("double",1.1,allocator);//添加"double":1.1object.AddMember("hello","world",allocator);//添加"hello":"world"//[4.2]往json数组中添加数据：值rapidjson::Valuearray(rapidjson::kArrayType);//创建数组rapidjson::Valuestr(rapidjson::kStringType);//字符串rapidjson::Valueobj(rapidjson::kObjectType);//对象str.SetString("hello");//设置str的值obj.AddMember("name","alice",allocator);obj.AddMember("age",23,allocator);array.PushBack(123,allocator);//添加数字array.PushBack("888",allocator);//添加字符串，方式一array.PushBack(str,allocator);//添加字符串，方式二array.PushBack(obj,allocator);//添加对象//[4.3]往对象格式的json文件中添加数据d.AddMember("hello","world",allocator);d.AddMember("object",object,allocator);d.AddMember("array",array,allocator);//[5]将json数据写入文件中StringBufferbuffer;rapidjson::Writer<StringBuffer>writer(buffer);d.Accept(writer);CCLOG("%s",buffer.GetString());FILE*file=fopen("/soft/cocos2d-x-3.4/projects/Demo34/Resources/testJson.json","wb");if(file){fputs(buffer.GetString(),file);fclose(file);}//

控制台输出结果：

Json代码整理一下，如下：

//{"hello":"world","object":{"int":1,"double":1.1,"hello":"world"},"array":[123,"888","hello",{"name":"alice","age":23}]}//

3.2、存储为数组格式的Json

使用方法与存储为对象格式类似。

使用举例：

////[1]创建用于处理json代码的类//创建rapidjson::Document类：用于操作json代码rapidjson::Documentd;//[2]获取分配器rapidjson::Document::AllocatorType&allocator=d.GetAllocator();//[3]设置为数组格式SetArrayd.SetArray();//[4]添加数据rapidjson::Valueobject(rapidjson::kObjectType);object.AddMember("name","alice",allocator);object.AddMember("age",23,allocator);d.PushBack(123,allocator);d.PushBack("hello",allocator);d.PushBack(object,allocator);//[5]将json数据写入文件中StringBufferbuffer;rapidjson::Writer<StringBuffer>writer(buffer);d.Accept(writer);CCLOG("%s",buffer.GetString());FILE*file=fopen("/soft/cocos2d-x-3.4/projects/Demo34/Resources/testJson.json","wb");if(file){fputs(buffer.GetString(),file);fclose(file);}//

控制台输出结果：

4、Json数据修改

以对象格式的Json文件为例。

Json文件内容如下：

//{"hello":"world","array":[1,2,3,4],"object":{"name":"alice","age":23}}//

对Json文件数据进行修改：

////[1]读取json文件内容std::stringstr=FileUtils::getInstance()->getStringFromFile("/soft/cocos2d-x-3.4/projects/Demo34/Resources/testJson.json");//[2]创建用于处理json代码的类、获取分配器、解析json文件内容rapidjson::Documentd;rapidjson::Document::AllocatorType&allocator=d.GetAllocator();d.Parse<0>(str.c_str());//[3]判断解析是否出错if(d.HasParseError()){CCLOG("GetParseError%s\n",d.GetParseError());return;}//[4]修改Json文件的数据//修改："hello"的值"hello":"hehe"d["hello"].SetString("hehe");//添加：对象的数据"newdata":"888"d.AddMember("newdata","888",allocator);//删除：对象中的数据"object"d.RemoveMember("object");//[5]将json数据重新写入文件中StringBufferbuffer;rapidjson::Writer<StringBuffer>writer(buffer);d.Accept(writer);CCLOG("%s",buffer.GetString());FILE*file=fopen("/soft/cocos2d-x-3.4/projects/Demo34/Resources/testJson.json","wb");if(file){fputs(buffer.GetString(),file);fclose(file);}//

控制台输出结果：

【常用操作】

常用操作如下：

////创建用于处理json文件的类rapidjson::Documentd;//获取分配器rapidjson::Document::AllocatorType&allocator=d.GetAllocator();//判断是否解析错误d.HasParseError();d.GetParseError();//解析json文件d.Parse<0>(constCh*str);//将数据写入json文件StringBufferbuffer;rapidjson::Writer<StringBuffer>writer(buffer);d.Accept(writer);FILE*file=fopen("/soft/cocos2d-x-3.4/projects/Demo34/Resources/testJson.json","wb");if(file){fputs(buffer.GetString(),file);fclose(file);}//json数组操作//json数组rapidjson::Value&array=d["array"];rapidjson::Valuearray(rapidjson::kArrayType);array.PushBack(Tvalue,allocator);//向数组中添加值array.Size();//数组元素个数array.Clear();//清空数组元素array.Empty();//判断数组元素是否为空//json对象操作//json对象rapidjson::Value&object=d["object"];rapidjson::Valueobject(rapidjson::kObjectType);object.AddMember(constCh*name,Tvalue,allocator);//向对象中添加名称/值对object.HasMember("key");//是否存在某名称/值对object.RemoveMember("key");//删除某名称/值对//获取值rapidjson::Value&value=d["key"];//对象格式，"key-value"rapidjson::Value&value=d[index];//数组格式，下标idx为整数value.GetBool();//值为逻辑值value.GetInt();//值为整数value.GetUint();//值为无符号整数value.GetInt64();//值为64位整数value.GetUint64();//值为64位无符号整数value.GetDouble();//值为浮点数value.GetString();//值为字符串//获取值的类型，返回值为枚举类型rapidjson::Type//enumType{//kNullType=0,//!<null//kFalseType=1,//!<false//kTrueType=2,//!<true//kObjectType=3,//!<object//kArrayType=4,//!<array//kStringType=5,//!<string//kNumberType=6,//!<number//};value.GetType();//判断值的类型rapidjson::Value&value=d["key"];//对象格式，"key-value"rapidjson::Value&value=d[index];//数组格式，下标idx为整数value.IsNull();//是否为空，nullvalue.IsBool()、IsTrue()、IsFalse();value.IsNumber()、IsInt()、IsUint()、IsUint64()、IsInt64()、IsDouble();value.IsArray();value.IsObject();value.IsString();//设置值rapidjson::Value&value=d["key"];//对象格式，"key-value"rapidjson::Value&value=d[index];//数组格式，下标idx为整数rapidjson::Valuevalue;value.SetNull();//设置为空值value.SetBool(boolb);//设置为逻辑值value.SetInt(inti);//设置为Int值value.SetUint(unsignedintu);//设置为UInt值value.SetInt64(int64_ti64);//设置为Int64值value.SetUint64(uint64_tu64);//设置为UInt64值value.SetDouble(doubled);//设置为double值value.SetArray();//设置为数组格式value.SetObject();//设置为对象格式value.SetString(constCh*s);//设置为字符串值//