【前言】編程
在遊戲中使用Json來儲存數據,既方便讀取,又方便管理。json
好比Cocos Studio 1.6以前版本導出的資源擴展名就是 .ExportJson 格式的。api
Cocos2d-x 3.x 加入了rapidjson庫用於json解析。位於external/json下。數組
本節要介紹的就是:如何使用rapidjson庫來操做處理json文件。app
【Json簡介】less
摘自:http://www.w3school.com.cn/json/index.asp編程語言
一、什麼是Json?函數
> Json 指的是 JavaScript 對象表示法(JavaScript Object Notation)。ui
> Json 是輕量級的存儲和文本數據交換格式,相似XML。編碼
> Json 比 XML 更小、更快,更易解析。
> Json 具備自我描述性,更易理解。
> Json 獨立於語言 * 。
* Json使用 JavaScript 語法來描述數據對象,可是 Json 仍然獨立於語言和平臺。
* Json解析器和 Json 庫支持許多不一樣的編程語言。
二、語法規則
JSON 語法是 JavaScript 對象表示法語法的子集。
(1)數據在「名稱/值對」中,即 鍵值對(key-value)形式。
(2)每條數據由「逗號」分隔。
(3)「花括號」{ } 保存 對象。
(4)「方括號」[ ] 保存 數組。
2.一、名稱/值對
JSON 數據的書寫格式是:名稱/值對(鍵值對 key-value)。
名稱/值對,包括字段名稱(在雙引號中),後面寫一個冒號,而後是值。
1
2
3
4
5
6
7
|
//
// "名稱" : "值"
"firstName"
:
"John"
// 錯誤。名稱必須加雙引號""
name :
"Alice"
//
|
2.二、值
JSON的值能夠是:
> null
> 邏輯值(boolean)
> 數字(number)
> 字符串(string,在雙引號 " " 中)
> 數組(在方括號 [ ] 中)
> 對象(在花括號 { } 中)
PS:即「名稱/值對」數據中,其名稱的冒號「 : 」後面對應的值能夠不是字符串,也能夠是數字、數組、對象等。
2.三、對象
JSON 對象在花括號中書寫:{ } 。
對象能夠包含多個名稱/值對( 能夠理解爲對象的 屬性名/屬性值 )。
PS:名稱必需要加雙引號" ",而且對象中只能包含名稱/值對的形式,不能只有一個值。
以下所示:
1
2
3
4
5
6
7
8
9
10
|
//
{
"name"
:
"John"
,
// 正確
"age"
:23,
// 正確
"array"
: [1,2,3,4],
// 正確。值能夠爲數組形式
"hello world"
,
// 錯誤。不能僅爲一個值
name :
"John"
// 錯誤。名稱必須加雙引號"name"
}
//
|
2.四、數組
JSON 數組在方括號中書寫:[ ] 。
數組可包含多個值(能夠爲null、邏輯值、數字、字符串、對象、數組)。
PS:數組中只能包含值的形式,不能爲名稱/值的形式。
以下所示:
1
2
3
4
5
6
7
8
9
10
11
12
|
//
[
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文件,根節點必須爲對象、或數組。否則沒法解析。
以下所示:
一、添加頭文件
若是隻用於解析Json文件,只要前2行的頭文件便可。
1
2
3
4
5
6
7
8
9
10
|
//
#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;
// 命名空間
//
|
二、Json數據解析
Cocos封裝的 rapidjson庫,只能解析對象格式、或數組格式的Json文件。
2.一、解析對象格式的Json
Json文件中的數據,根節點爲一個對象,全部屬性在大花括號 { } 中。
對象中的數據,經過 名稱/值 的形式進行訪問。
Json文件內容以下:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
|
//
{
"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
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
|
//
//[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.二、解析數組格式的Json
Json文件中的數據,根節點爲一個數組,全部元素在一個大方括號 [ ] 中。
數組中的數據,經過下標的形式訪問元素值(下標從0開始)。
Json文件內容以下:
1
2
3
4
5
6
7
8
9
10
|
//
[
true
,
123,
"888"
,
"hello world"
,
{
"name"
:
"alice"
,
"age"
: 23},
[1,2,3,4]
]
//
|
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
|
//
//[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());
}
}
}
}
//
|
控制檯輸出結果:
三、Json數據存儲
3.一、存儲爲對象格式的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
|
//
//[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代碼整理一下,以下:
1
2
3
4
5
6
7
|
//
{
"hello"
:
"world"
,
"object"
: {
"int"
:1,
"double"
:1.1,
"hello"
:
"world"
},
"array"
: [ 123,
"888"
,
"hello"
, {
"name"
:
"alice"
,
"age"
:23} ]
}
//
|
3.二、存儲爲數組格式的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
|
//
//[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);
}
//
|
控制檯輸出結果:
四、Json數據修改
以對象格式的Json文件爲例。
Json文件內容以下:
1
2
3
4
5
6
7
|
//
{
"hello"
:
"world"
,
"array"
: [1, 2, 3, 4],
"object"
: {
"name"
:
"alice"
,
"age"
:23 }
}
//
|
對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] 讀取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);
}
//
|
控制檯輸出結果:
【經常使用操做】
經常使用操做以下:
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
|
//
// 建立用於處理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對象
|