Json快速入门 - 技术栈

引言

Jsoncpp 库主要是用于实现 Json 格式数据的序列化和反序列化，它实现了将多个数据对象组织成为Json格式字符串，以及将 Json 格式字符串解析得到多个数据对象的功能，独立于开发语言。

Json数据对象

Json数据对象类的表示：

cpp 复制代码

class Json::Value{
 Value &operator=(const Value &other); //Value重载了[]和=，因此所有的赋值和获取数据都可以通过 
 Value& operator[](const std::string& key);//简单的⽅式完成 val["name"] = "xx";
 Value& operator[](const char* key);

 Value removeMember(const char* key);//移除元素 
 const Value& operator[](ArrayIndex index) const; //val["score"][0]
 Value& append(const Value& value);//添加数组元素val["score"].append(88);  
 ArrayIndex size() const;//获取数组元素个数 val["score"].size(); 

 std::string asString() const;//转string string name = val["name"].asString();
 const char* asCString() const;//转char* char *name = val["name"].asCString();
 Int asInt() const;//转int int age = val["age"].asInt(); 
 float asFloat() const;//转float float weight = val["weight"].asFloat(); 
 bool asBool() const;//转 bool bool ok = val["ok"].asBool(); 
};

上面列举了Json数据对象Json::Value的一些成员方法， Json::Value是用来存储数据的，可以把它理解为一个容器。序列化方法和反序列化方法就可以将传入的Json::Value数据对象进行序列化和反序列化操作。

Json基本语法规则

Json通常采用KeyValue的格式。例如："姓名"："小颖"，中间用冒号：隔开。其中，键名必须为字符串且必须用双引号包裹。

{ "key": "value" } // ✅ 正确

{ key: "value" } // ❌ 错误

Json中还有另一种数据结构------数组。用中括号[ ]包裹起来，里面的值的类型可以不同。

$"苹果", "香蕉", 123, true$

序列化接口

cpp 复制代码

class JSON_API StreamWriter {
 virtual int write(Value const& root, std::ostream* sout) = 0;
 //......
}
class JSON_API StreamWriterBuilder : public StreamWriter::Factory {
 virtual StreamWriter* newStreamWriter() const;
  //......
}

可以看得出来，这里用到了一种设计模式------工厂模式。也就是说使用StreamWriterBuilder 来生产StreamWriter对象。write就是序列化接口，第一个参数为存储数据的Value对象，第二个参数为输出流对象的指针。StreamWriter 用于将JSON数据写入到输出流中，StreamWriterBuilder 则是用来配置和创建**StreamWriter**实例的。所谓配置，就是配置Json输出的格式，比如缩进、换行这些都是。下面用代码演示如何对数据进行序列化。

反序列化接口

cpp 复制代码

class JSON_API CharReader {
 virtual bool parse(char const* beginDoc, char const* endDoc, 
 Value* root, std::string* errs) = 0;
}
class JSON_API CharReaderBuilder : public CharReader::Factory {
 virtual CharReader* newCharReader() const;
}

和序列化一样，这里同样用到了工厂设计模式。CharReaderBuilder 负责配置解析规则，然后由CharReader来进行解析。CharReader不能直接创建对象，因为它里面有个纯虚函数，所以它是个抽象类。创建对象的职责由CharReaderBuilder来承担。函数parse就是用来完成反序列化的。

序列化和反序列化代码演示

cpp 复制代码

#include <iostream>
#include <memory>
#include <sstream>
#include <jsoncpp/json/json.h>

//序列化
bool Serialize(const Json::Value val, std::string &body)
{
    std::stringstream ss;
    //构建StreamWriter对象
    Json::StreamWriterBuilder swb;
    std::unique_ptr<Json::StreamWriter> sw(swb.newStreamWriter());
    int ret = sw->write(val, &ss);//成功返回0，失败返回-1
    if(ret != 0)
    {
        std::cout << "serialize faild\n";
        return false;
    }
    body = ss.str();
    return true;
}

//反序列化
bool unserialize(const std::string &body, Json::Value&val)
{
    Json::CharReaderBuilder crb;
    std::unique_ptr<Json::CharReader> cr(crb.newCharReader());
    std::string errs;
    bool ret = cr->parse(body.c_str(), body.c_str() + body.size(), &val, &errs);
    if(ret == false)
    {
        std::cout << "unserialize faild : " << errs << std::endl;
        return false;
    }
    return true;
}

int main()
{
    Json::Value stu;
    stu["姓名"] = "小颖";
    stu["年龄"] = 19;
    //构建数组，不能直接stu["爱好"] = ["打羽毛球", "吃吃吃", "散步"];
    stu["爱好"].append("打羽毛球");
    stu["爱好"].append("吃吃吃");
    stu["爱好"].append("散步");

    std::string body;
    Serialize(stu, body);
    std::cout << body << std::endl;

    std::string str = R"({"姓名":"小北", "年龄":20})";//C++11的一种新语法,定义一个字符串
    Json::Value student;
    bool ret = unserialize(str, student);//将字符串反序列化
    if(ret == false)
        return -1;
    std::cout << "姓名:" << student["姓名"].asString() << std::endl;
    std::cout << "年龄:" << student["年龄"].asInt() << std::endl;

    return 0;
}

//运行结果
{
        "\u59d3\u540d" : "\u5c0f\u9896",
        "\u5e74\u9f84" : 19,
        "\u7231\u597d" : 
        [
                "\u6253\u7fbd\u6bdb\u7403",
                "\u5403\u5403\u5403",
                "\u6563\u6b65"
        ]
}
姓名:小北
年龄:20