【唠叨】
在游戏中使用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,//逻辑值Bool 123,//数字Number "888",//字符串String "helloworld",//字符串String {"name":"alice","age":23},//对象Object [1,//数组Object "name":"John"//错误。不能为名称/值的形式 ] //
【rapidjson】
Cocos2d-x 3.x 加入了 rapidjson库,用于Json解析。位于external/json下。
只支持标准的Json格式,一些非标准的Json格式不支持。一些常用的解析方法需要自己封装。注意判断解析节点是否存在。
PS:解析的Json文件,根节点必须为对象、或数组。不然无法解析。
如下所示:
// #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文件中的数据,根节点为一个对象,所有属性在大花括号 { } 中。
对象中的数据,通过 名称/值 的形式进行访问。
// { "hello":"world","t":true,"f":false,"n":null,"i":123,"pi":3.1416,"array":[1,"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",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开始)。
// [ true,123,"888","helloworld",{"name":"alice",[1,4] ] //
获取json中的数据
//判断json文件是否为数组格式
if(d.IsArray()){
rapidjson::Value&array=d;
for(inti=0;i<array.Size();i++){
if(d[i].IsBool()){//逻辑值
CCLOG("%disBool:%d",array[i].GetBool());
}
if(d[i].IsNumber()){//数字
CCLOG("%disNumber:%d",array[i].GetInt());
}
if(d[i].IsString()){//字符串
CCLOG("%disString:%s",array[i].GetString());
}
if(d[i].IsObject()){//对象
rapidjson::Value&object=d[i];
CCLOG("%disObject:%s",array[i]["name"].GetString());
CCLOG("%disObject:%d",object["age"].GetInt());
}
if(d[i].IsArray()){//数组
for(intj=0;j<array[i].Size();j++){
CCLOG("[%d,%d]isArray:%d",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]设置为对象格式SetObject d.SetObject(); //[4]添加数据 //[4.1]往json对象中添加数据:名称/值对 rapidjson::Valueobject(rapidjson::kObjectType);//创建对象 object.AddMember("int",1,allocator);//添加"int":1 object.AddMember("double",1.1,allocator);//添加"double":1.1 object.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",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,"hello","age":23}] } //
3.2、存储为数组格式的Json
使用方法与存储为对象格式类似。
使用举例:
// //[1]创建用于处理json代码的类 //创建rapidjson::Document类:用于操作json代码 rapidjson::Documentd; //[2]获取分配器 rapidjson::Document::AllocatorType&allocator=d.GetAllocator(); //[3]设置为数组格式SetArray d.SetArray(); //[4]添加数据 rapidjson::Valueobject(rapidjson::kObjectType); object.AddMember("name",allocator); object.AddMember("age",allocator); d.PushBack(123,allocator); d.PushBack("hello",allocator); d.PushBack(object,0);">控制台输出结果:
4、Json数据修改
以对象格式的Json文件为例。
// { "hello":"world","object":{"name":"alice","age":23} } //// //[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",allocator); //删除:对象中的数据"object" d.RemoveMember("object"); //[5]将json数据重新写入文件中 StringBufferbuffer; rapidjson::Writer<StringBuffer>writer(buffer); d.Accept(writer); CCLOG("%s",0);">控制台输出结果:
【常用操作】
常用操作如下:
// //创建用于处理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",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();//是否为空,null value.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);//设置为字符串值 //原文链接:https://www.f2er.com/cocos2dx/344346.html