Cocos2d-x数据模块教程02：Json数据操作

这是一个关于Cocos2d-x的数据模块的系列教程，内容包括UserDefault数据存储、Json数据操作、XML数据操作、plist文件操作、CSV文件解析以及SQLite3数据库基础用法。

      在游戏中使用Json来储存数据，既方便读取，又方便管理。

      比如Cocos Studio 1.6之前版本导出的资源扩展名就是 .ExportJson 格式的。

      Cocos2d-x 3.x 加入了rapidjson库用于json解析。位于external/json下。

      本节要介绍的就是：如何使用rapidjson库来操作处理json文件。

 

【Json简介】

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(str.c_str());
    // d.Parse(str.c_str());  // 也可以直接写
 
//[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