Cocos2d-x數據篇02:Json數據操做

【前言】編程

在遊戲中使用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文件,根節點必須爲對象、或數組。否則沒法解析。

以下所示:

wKioL1TgJnWS2IFTAAHBNUHJwmo917.jpg

一、添加頭文件

若是隻用於解析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());
             }
         }
     }
//

控制檯輸出結果:

wKioL1TgmqTCss9tAABlZCNdqNY123.jpg

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());
                 }
             }
         }
     }
//

控制檯輸出結果:

wKiom1TgxR-BbIOsAACJwvJESN0200.jpg

三、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);
     }
//

控制檯輸出結果:

1424852036210171.jpg

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);
     }
//

控制檯輸出結果:

wKiom1Tg3sKi2sZfAAAcbwrQBbk511.jpg

四、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);
     }
//

控制檯輸出結果:

wKioL1Tg5EKDAW0uAAAjj90CjHg342.jpg


【經常使用操做】

經常使用操做以下:

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對象
相關文章
相關標籤/搜索