【嘮叨】
在遊戲中使用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], // 正確。值可以爲數組形式
"hello world", // 錯誤。不能僅爲一個值
name : "John" // 錯誤。名稱必須加雙引號"name"
}
//2.4、數組
JSON 數組在方括號中書寫：[ ] 。
數組可包含多個值（可以爲null、邏輯值、數字、字符串、對象、數組）。
PS：數組中只能包含值的形式，不能爲名稱/值的形式。
如下所示：
//
[
true, // 邏輯值Bool
123, // 數字Number
"888", // 字符串String
"hello world", // 字符串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" using namespace rapidjson; // 命名空間 //
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::string str = FileUtils::getInstance()->getStringFromFile("testJson.json");
CCLOG("%s", str.c_str());
//[2] 創建用於處理json代碼的類
// 創建rapidjson::Document類：用於操作json代碼
rapidjson::Document d;
//[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 (int i = 0; i < d["array"].Size(); i++) {
CCLOG("%d : %d", i, d["array"][i].GetInt());
}
// // 也可以這麼寫
// rapidjson::Value& array = d["array"];
// for (int i = 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",
"hello world",
{"name" : "alice", "age" : 23},
[1,2,3,4]
]
// Json解析使用舉例：
//
//[1] 讀取json文件內容
std::string str = FileUtils::getInstance()->getStringFromFile("testJson.json");
CCLOG("%s", str.c_str());
//[2] 創建用於處理json代碼的類
// 創建rapidjson::Document類：用於操作json代碼
rapidjson::Document d;
//[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 (int i = 0; i < array.Size(); i++) {
if (d[i].IsBool()) { // 邏輯值
CCLOG("%d is Bool : %d", i, array[i].GetBool());
}
if (d[i].IsNumber()) { // 數字
CCLOG("%d is Number : %d", i, array[i].GetInt());
}
if (d[i].IsString()) { // 字符串
CCLOG("%d is String : %s", i, array[i].GetString());
}
if (d[i].IsObject()) { // 對象
rapidjson::Value& object = d[i];
CCLOG("%d is Object : %s", i, array[i]["name"].GetString());
CCLOG("%d is Object : %d", i, object["age"].GetInt());
}
if (d[i].IsArray()) { // 數組
for (int j = 0; j < array[i].Size(); j++) {
CCLOG("[%d,%d] is Array : %d", i, j, array[i][j].GetInt());
}
}
}
}
// 控制檯輸出結果：
3、Json數據存儲
3.1、存儲爲對象格式的Json
使用舉例：
//
//[1] 創建用於處理json代碼的類
// 創建rapidjson::Document類：用於操作json代碼
rapidjson::Document d;
//[2] 獲取分配器
rapidjson::Document::AllocatorType& allocator = d.GetAllocator();
//[3] 設置爲對象格式 SetObject
d.SetObject();
//[4] 添加數據
//[4.1] 往json對象中添加數據：名稱/值對
rapidjson::Value object(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::Value array(rapidjson::kArrayType); // 創建數組
rapidjson::Value str(rapidjson::kStringType); // 字符串
rapidjson::Value obj(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數據寫入文件中
StringBuffer buffer;
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::Document d;
//[2] 獲取分配器
rapidjson::Document::AllocatorType& allocator = d.GetAllocator();
//[3] 設置爲數組格式 SetArray
d.SetArray();
//[4] 添加數據
rapidjson::Value object(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數據寫入文件中
StringBuffer buffer;
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::string str = FileUtils::getInstance()->getStringFromFile("/soft/cocos2d-x-3.4/projects/Demo34/Resources/testJson.json");
//[2] 創建用於處理json代碼的類、獲取分配器、解析json文件內容
rapidjson::Document d;
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數據重新寫入文件中
StringBuffer buffer;
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::Document d;
// 獲取分配器
rapidjson::Document::AllocatorType& allocator = d.GetAllocator();
// 判斷是否解析錯誤
d.HasParseError();
d.GetParseError();
// 解析json文件
d.Parse<0>(const Ch *str);
// 將數據寫入json文件
StringBuffer buffer;
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::Value array(rapidjson::kArrayType);
array.PushBack(T value, allocator); // 向數組中添加值
array.Size(); // 數組元素個數
array.Clear(); // 清空數組元素
array.Empty(); // 判斷數組元素是否爲空
// json對象操作
// json對象
rapidjson::Value& object = d["object"];
rapidjson::Value object(rapidjson::kObjectType);
object.AddMember(const Ch *name, T value, 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
// enum Type {
// 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::Value value;
value.SetNull(); // 設置爲空值
value.SetBool(bool b); // 設置爲邏輯值
value.SetInt(int i); // 設置爲Int值
value.SetUint(unsigned int u); // 設置爲UInt值
value.SetInt64(int64_t i64); // 設置爲Int64值
value.SetUint64(uint64_t u64); // 設置爲UInt64值
value.SetDouble(double d); // 設置爲double值
value.SetArray(); // 設置爲數組格式
value.SetObject(); // 設置爲對象格式
value.SetString(const Ch *s); // 設置爲字符串值
//