在游戏中使用Json来储存数据,既方便读取,又方便管理。
比如Cocos Studio 1.6之前版本导出的资源扩展名就是 .ExportJson 格式的。
Cocos2d-x 3.x 加入了rapidjson库用于json解析。位于external/json下。
本节要介绍的就是:如何使用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)。
名称/值对,包括字段名称(在双引号中),后面写一个冒号,然后是值。
1 2 3 4 5 6 7 |
|
2.2、值
JSON的值可以是:
> null
> 逻辑值(boolean)
> 数字(number)
> 字符串(string,在双引号 " " 中)
> 数组(在方括号 [ ] 中)
> 对象(在花括号 { } 中)
PS:即“名称/值对”数据中,其名称的冒号“ : ”后面对应的值可以不是字符串,也可以是数字、数组、对象等。
2.3、对象
JSON 对象在花括号中书写:{ } 。
对象可以包含多个名称/值对( 可以理解为对象的 属性名/属性值 )。
PS:名称必须要加双引号" ",并且对象中只能包含名称/值对的形式,不能只有一个值。
如下所示:
1 2 3 4 5 6 7 8 9 10 |
|
2.4、数组
JSON 数组在方括号中书写:[ ] 。
数组可包含多个值(可以为null、逻辑值、数字、字符串、对象、数组)。
PS:数组中只能包含值的形式,不能为名称/值的形式。
如下所示:
1 2 3 4 5 6 7 8 9 10 11 12 |
|
【rapidjson】
Cocos2d-x 3.x 加入了 rapidjson库,用于Json解析。位于external/json下。
只支持标准的Json格式,一些非标准的Json格式不支持。一些常用的解析方法需要自己封装。注意判断解析节点是否存在。
PS:解析的Json文件,根节点必须为对象、或数组。不然无法解析。
如下所示:
1、添加头文件
如果只用于解析Json文件,只要前2行的头文件即可。
1 2 3 4 5 6 7 8 9 10 |
|
2、Json数据解析
Cocos封装的 rapidjson库,只能解析对象格式、或数组格式的Json文件。
2.1、解析对象格式的Json
Json文件中的数据,根节点为一个对象,所有属性在大花括号 { } 中。
对象中的数据,通过 名称/值 的形式进行访问。
Json文件内容如下:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
|
Json解析使用举例:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 |
|
控制台输出结果:
2.2、解析数组格式的Json
Json文件中的数据,根节点为一个数组,所有元素在一个大方括号 [ ] 中。
数组中的数据,通过下标的形式访问元素值(下标从0开始)。
Json文件内容如下:
1 2 3 4 5 6 7 8 9 10 |
|
Json解析使用举例:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 |
|
控制台输出结果:
3、Json数据存储
3.1、存储为对象格式的Json
使用举例:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 |
|
控制台输出结果:
Json代码整理一下,如下:
1 2 3 4 5 6 7 |
|
3.2、存储为数组格式的Json
使用方法与存储为对象格式类似。
使用举例:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 |
|
控制台输出结果:
4、Json数据修改
以对象格式的Json文件为例。
Json文件内容如下:
1 2 3 4 5 6 7 |
|
对Json文件数据进行修改:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 |
|
控制台输出结果:
【常用操作】
常用操作如下:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 |
|
【参考】
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数据的实战经验)
附上一个例子:
#ifndef __HXT_READ_JSON_H__
#define __HXT_READ_JSON_H__
#include "cocos2d.h"
#include "cocos-ext.h"
#include "XtcUtils.h"
//================================================
// 坑爹的 "cocos-ext.h" 下面没有包含 这2个路径,
// coco2dx 的作者们是不指望可以往 assets 里写数据了么
// [haha:我自己来加上]-HXT
#include "CocoStudio/Json/rapidjson/stringbuffer.h"
#include "CocoStudio/Json/rapidjson/writer.h"
//================================================
// version:v1.0
// lastdate:2014-09-16
//================================================
USING_NS_CC;
USING_NS_CC_EXT;
using namespace rapidjson;
class UseJson{
public:
//===============read===============
void readJsonFile(const char* fileName);
void getDictSetFromKey(const char * keyName);
std::string getDictValue(const char * keyName);
bool getKeyExist(const char * keyName);
int checkKeyNum(const char * keyName);
void transRootToBuffer(void);
void transBufferToRoot(void); // 慎重使用。
// 废弃
const rapidjson::Value& getListSet(const char * keyName);
std::string getBufferSring(); m_sBufferSring 返回
根据一个i值 获取到一个数组
//Value getListValue(int i;Value father);
//===============write===============
void writeJsonFile(std::string path);
void createFolder(std::string FolderName);
//===================================
void cleanAlldata();
void returnExamResult(void);
CC_SYNTHESIZE(float, _energy, Energy);
static UseJson* useJsonManager(); //单例模式
static UseJson* m_pJsonManager;
//const Value& m_p ;
private:
//从file里读取 出来的数据,做根节点;
std::string m_sRootSring;
// 迭代用的 Buffer
std::string m_sBufferSring;
Document m_dBufferDoc;
};
#endif // __HXT_READ_JSON_H__
#include "HXTReadJson.h"
#include "HXTUseJNI.h"
#include "../UT_Common/UT_Common.h"
#if (CC_TARGET_PLATFORM != CC_PLATFORM_WIN32)
#include <dirent.h>
#include <sys/stat.h>
#else
#include "../external/libiconv/include/iconv.h"
#endif
#if (CC_TARGET_PLATFORM == CC_PLATFORM_ANDROID)
#endif
using namespace rapidjson;
UseJson* UseJson::m_pJsonManager = NULL;
static const int HZ_C_UNIT_QUESTION_MAX_NUM = 100;
static const char *HZ_C_PACKAGE_NAME[]=
{
"NULL",
"com.xtc.HZ_OneTwoThree",
"NULL",
"com.xtc.HZ_WarOfWords",
"com.xtc.HZ_MotherDessert",
"com.xtc.HZ_HitMoles",
"com.xtc.HZ_FourSeason",
"com.xtc.HZ_SunRainToken",
"com.xtc.HZ_SunmoonGame",
"com.xtc.HZ_TrainFun",
"com.xtc.HZ_FlyRun",
"com.xtc.HZ_WhoseBed",
"com.xtc.HZ_ToTheCloud",
"com.xtc.HZ_WakeUpFamiliers",
"com.xtc.HZ_NezhaTreat",
"com.xtc.HZ_BodyGame",
"com.xtc.HZ_HelpSheep",
"com.xtc.HZ_AnimalLink",
"com.xtc.HZ_PickApple",
"NULL",
"com.xtc.HZ_AnimalTail",
};
static const char *HZ_C_ACTIVITY_NAME[]=
{
"NULL",
"com.xtc.HZ_OneTwoThree.HZ_OneTwoThree",
"NULL",
"com.xtc.HZ_WarOfWords.HZ_WarOfWords",
"com.xtc.HZ_MotherDessert.HZ_MotherDessert",
"com.xtc.HZ_HitMoles.HZ_HitMoles",
"com.xtc.HZ_FourSeason.HZ_FourSeason",
"com.xtc.HZ_SunRainToken.HZ_SunRainToken",
"com.xtc.HZ_SunmoonGame.HZ_SunmoonGame",
"com.xtc.HZ_TrainFun.HZ_TrainFun",
"com.xtc.HZ_FlyRun.HZ_FlyRun",
"com.xtc.HZ_WhoseBed.HZ_WhoseBed",
"com.xtc.HZ_ToTheCloud.HZ_ToTheCloud",
"com.xtc.HZ_WakeUpFamiliers.HZ_WakeUpFamiliers",
"com.xtc.HZ_NezhaTreat.HZ_NezhaTreat",
"com.xtc.HZ_BodyGame.HZ_BodyGame",
"com.xtc.HZ_HelpSheep.HZ_HelpSheep",
"com.xtc.HZ_AnimalLink.HZ_AnimalLink",
"com.xtc.HZ_PickApple.HZ_PickApple",
"NULL",
"com.xtc.HZ_AnimalTail.HZ_AnimalTail",
};
static const std::string HZ_C_UNIT_NAME[] =
{
"",
"第一单元",
"第二单元",
"第三单元",
"第四单元",
};
/// << =============题库的结果-保存路径================== >>
static char* HZ_C_SDFileSavePath = "/mnt/sdcard/quiz/result/";
static char* HZ_C_SDFileName = "myhero.json";
/// << ================================================= >>
UseJson* UseJson::useJsonManager()
{
if(m_pJsonManager == NULL)
{
m_pJsonManager = new UseJson();
}
return m_pJsonManager;
}
// 获取Json文件对应的 Value值
void UseJson::readJsonFile(const char* fileName)
{
unsigned long size;
std::string fullPath = fileName;
// 文件里 解析: // 切记文件用utf-8 无BOM头的编码。
// 下面这个命令
unsigned char *pBytes = CCFileUtils::sharedFileUtils()->getFileData(fullPath.c_str() , "r", &size);
std::string load_str = std::string((const char*)pBytes, size);
// utf-8 转换成 GBK ,现在不需要下面这个函数了
//ToolManager::sharedManager()->GBKToUTF8(load_str,"utf-8","gbk");
m_sBufferSring = load_str; // 迭代用
// 存为根节点,方便下次取值。
m_sRootSring = load_str; //
}
根据一个Key值 获取到一个 dict 的 集合(Set)
// Set 这里是名词,指 集合<计>。
void UseJson::getDictSetFromKey(const char * keyName)
{
cleanAlldata();
m_dBufferDoc.Parse<0>(m_sBufferSring.c_str()); //
if(!m_dBufferDoc.HasMember(keyName))
{
return;
}
Value &dic = m_dBufferDoc[keyName];
// 将 Value 的值 写入 buffer,
// 再把 Buffer 的值变成 string 型 保存到成员变量里。
//================================================
StringBuffer buffer;
Writer<StringBuffer> writer(buffer);
dic.Accept(writer);
m_sBufferSring = buffer.GetString();
//================================================
}
根据一个Key值,返回一个 value值-必须是字符串型。
std::string UseJson::getDictValue(const char * keyName)
{
m_dBufferDoc.Parse<0>(m_sBufferSring.c_str()); //
if(!m_dBufferDoc.HasMember(keyName))
{
return NULL;
}
Value &dic = m_dBufferDoc[keyName];
if(dic.IsString())
{
std::string sValue = dic.GetString();
return sValue;
}
return NULL;
}
在当前的 m_sBufferSring下, 确定一个Key值,有没有
bool UseJson::getKeyExist(const char * keyName)
{
m_dBufferDoc.Parse<0>(m_sBufferSring.c_str()); //
if(!m_dBufferDoc.HasMember(keyName))
{
return false;
}
return true;
}
// 遍历m_sBufferSring ,确定一个Key值 有多少个
int UseJson::checkKeyNum(const char * keyName)
{
int i = 0;
bool re;
do
{
i++;
char str[100] = {0};
sprintf(str, "%i",i);
strcat (str,keyName );
re = getKeyExist(str);
} while (re);
return (i-1);
}
void UseJson::transRootToBuffer(void)
{
m_sBufferSring = m_sRootSring;
}
void UseJson::transBufferToRoot(void)
{
m_sRootSring = m_sBufferSring;
}
void UseJson::writeJsonFile(std::string path)
{
Document document; // 创建rapidjson::Document类:用于操作json代码
document.SetObject(); //设置为对象格式 SetObject
Document::AllocatorType& allocator = document.GetAllocator(); //[2] 获取分配器
std::string mainName = "语文";
// 写入版本号,写入1级目录
document.AddMember("version", "1", allocator);
XtcUtils::GBKToUTF8(mainName);
document.AddMember("level1", mainName.c_str(), allocator);
// 获取 二级目录名字:
int num = UseJNI::JNIManager()->resultIntToJava();
std::string subject = HZ_C_UNIT_NAME[num];
XtcUtils::GBKToUTF8(subject);
document.AddMember("level2", subject.c_str(), allocator);
// 生成题目结果
Value array(kArrayType); // 创建数组
int result;
std::string knowledge[HZ_C_UNIT_QUESTION_MAX_NUM];
//std::string *knowledge = new std::string[UT_Common::sharedUTCommon()->getQuestionNum()];
for (int i = 0;i <= UT_Common::sharedUTCommon()->getQuestionNum(); i++)
{
Value object(kObjectType); //[4.1] 往json对象中添加数据:名称/值对
result = UT_Common::sharedUTCommon()->getQuestionFlag(i);//对错。
knowledge[i] = UT_Common::sharedUTCommon()->getQuestion(i);
int lessonIndex = UT_Common::sharedUTCommon()->getLessonIndex((char *)knowledge[i].c_str(),num);
object.AddMember("appPackage",HZ_C_PACKAGE_NAME[lessonIndex],allocator);
object.AddMember("activityName",HZ_C_ACTIVITY_NAME[lessonIndex],allocator);
//CCDirector::sharedDirector()->GBKToUTF8(knowledge[i]);
object.AddMember("result", result, allocator);
object.AddMember("knowledge", knowledge[i].c_str(), allocator);
// 这里对字符串 是 引用,必须用数组赋值
// int 型 不是引用,所以可以不用数组
array.PushBack(object, allocator);
}
//delete []knowledge;
document.AddMember("library", array, allocator);
StringBuffer buffer;
Writer<StringBuffer> writer(buffer);
document.Accept(writer);
// 字符串通过Java传递
std::string toJava = buffer.GetString();
#if (CC_TARGET_PLATFORM == CC_PLATFORM_ANDROID)
UseJNI::JNIManager()->sendStringToJava(toJava);
#endif
#ifdef WIN32
// 字符串写入文件
FILE* file = fopen(path.c_str(), "wb");
if (NULL != file)
{
fputs(toJava.c_str(), file);
fclose(file);
}
#endif
}
//==============================================================
//
// 在SD卡中创建 文件夹
//
//==============================================================
// 建立文件夹,如果父级不存在,则失败。
// 需要一级一级 建立 文件夹
// 使用举例:
// createFolder("/mnt/sdcard/quiz"); // 先建立父级
// createFolder("/mnt/sdcard/quiz/result/"); // 再建立子级
// createFolder("/mnt/sdcard/quiz/123/"); // 文件夹名字 后面 带不带"/"都 可以成功创建
// createFolder("/mnt/sdcard/quiz/234");
void UseJson::createFolder(std::string FolderName)
{
std::string pathToSave = FolderName;
// Create the folder if it doesn't exist
#if (CC_TARGET_PLATFORM != CC_PLATFORM_WIN32)
DIR *pDir = NULL;
pDir = opendir (pathToSave.c_str());
if (! pDir)
{
mkdir(pathToSave.c_str(), S_IRWXU | S_IRWXG | S_IRWXO);
}
#else
if ((GetFileAttributesA(pathToSave.c_str())) == INVALID_FILE_ATTRIBUTES)
{
CreateDirectoryA(pathToSave.c_str(), 0);
}
#endif
}
根据一个Key值 获取到一个 List 的 集合(Set)
// Set 这里是名词,指 集合<计>。
const rapidjson::Value& UseJson::getListSet(const char * keyName)
{
// 想了一下,还没想出好的封装办法。
m_dBufferDoc.Parse<0>(m_sBufferSring.c_str()); //
Value &dic = m_dBufferDoc[keyName];
//if(dic.IsString())
//{
// std::string sValue = dic.GetString();
// return sValue;
//}
return dic ;
}
// 这个函数废弃使用。
std::string UseJson::getBufferSring()
{
return m_sBufferSring;
//=========readJsonFile 里注释掉的内容=========
//Document doc; // 创建一个 Document 对象,rapidJson的相关操作 都在 Document 类中
//unsigned long size;
//std::string data = (char *) CCFileUtils::sharedFileUtils()->getFileData(fileName,"r",&size);
//doc.Parse<kParseDefaultFlags>(data.c_str()); // 通过 Parse 方法将Json 解析出来。
//rapidjson::Document json;
//m_dJsonData.Parse<0>(load_str.c_str()); //
//=============================================
}
// 暂补全
void UseJson::cleanAlldata()
{
// 把所有的 String , int ,long ,bool ,全都清0
}
void UseJson::returnExamResult(void)
{
// 写到 F:\cocos2d-x-2.2.3-xtc-0.6\debug-win32文件夹里
#ifdef WIN32
std::string path = CCFileUtils::sharedFileUtils()->getWritablePath();
#endif // LM_BURN_ANDROID
// 烧到SD卡里
#if (CC_TARGET_PLATFORM == CC_PLATFORM_ANDROID)
std::string path = HZ_C_SDFileSavePath;
UseJson::useJsonManager()->createFolder("/mnt/sdcard/quiz");
UseJson::useJsonManager()->createFolder("/mnt/sdcard/quiz/result/");
#endif // LM_BURN_ANDROID
path.append(HZ_C_SDFileName);
UseJson::useJsonManager()->writeJsonFile(path);
}