一个典型的 JSON 文档可以像下面的例子：

    JSON 的全称是 JavaScript Object Notation，与 JavaScript 密不可分。熟悉 JavaScript 的童鞋马上就会发现，JSON 的语法就是 JavaScript 对象声明的语法。JSON 文档其实就是一个 JavaScript 对象，因而也称为 JSON 对象，以大括号作为起止符，其实质是不排序的键值对，其中键要求是 string 类型，值可以是任意类型。比如上面的示例，键 encoding 的值是字符串 UTF-8；键 plug-ins 的值是一个数组类型，在 JSON 中，数组以中括号表示，这个数组是一个字符串列表，分别有 python、c++ 和 ruby 三个对象；键 indent 的值是一个对象，这个对象有两个属性，length = 3，use_space = true。

    对于 JSON 的解析，我们可以使用 这个第三方库。QJson 可以将 JSON 数据转换为 QVariant 对象，将 JSON 数组转换成 QVariantList 对象，将 JSON 对象转换成 QVariantMap 对象。我们在这里使用 git clone 出 QJson 的整个代码。注意 QJson 没有提供链接库的 pro 文件，因此我们只需要将所有源代码文件添加到我们的项目即可（如同这些文件是我们自己写的一样）。接下来就可以使用 QJson 读取 JSON 内容：

    1. //////////
    2. QJson::Parser parser;
    3. bool ok;
    4.  
    5. QString json("{"
    6.         "\"encoding\" : \"UTF-8\","
    7.         "\"plug-ins\" : ["
    8.         "\"python\","
    9.         "\"c++\","
    10.         "\"ruby\""
    11.         "],"
    12.         "\"indent\" : { \"length\" : 3, \"use_space\" : true }"
    13.         "}");
    14. QVariantMap result = parser.parse(json.toUtf8(), &ok).toMap();
    15. if (!ok) {
    16.     qFatal("An error occurred during parsing");
    17.     exit (1);
    18. }
    19.  
    20. qDebug() << "plugins:";
    21.  
    22. foreach (QVariant plugin, result["plug-ins"].toList()) {
    23.     qDebug() << "\t-" << plugin.toString();
    24. }
    25.  
    26. QVariantMap nestedMap = result["indent"].toMap();
    27. qDebug() << "length:" << nestedMap["length"].toInt();
    28. qDebug() << "use_space:" << nestedMap["use_space"].toBool();

    QJson::Parser::parse()函数接受两个参数，第一个参数是 JSON 对象，可以是QIODevice *或者是QByteArray；第二个参数是转换成功与否，如果成功则被设置为 true。函数返回转换后的QVariant对象。注意我们转换后的对象其实是一个QVariantMap类型，可以像QMap一样使用重载的 [] 获取键所对应的值。另外，由于 result[“plug-ins”] 是一个QVariantList对象（因为是由 JSON 数组返回的），因而可以调用其函数，通过遍历输出每一个值。

    如果需要将QVariant生成 JSON 对象，我们则使用QJson::Serializer对象。例如：

    1. QVariantList people;
    2.  
    3. QVariantMap bob;
    4. bob.insert("Name", "Bob");
    5. bob.insert("Phonenumber", 123);
    6.  
    7. QVariantMap alice;
    8. alice.insert("Name", "Alice");
    9. alice.insert("Phonenumber", 321);
    10.  
    11.  
    12. QJson::Serializer serializer;
    13. bool ok;
    14. QByteArray json = serializer.serialize(people, &ok);
    15.  
    16. if (ok) {
    17.     qDebug() << json;
    18. } else {
    19.     qCritical() << "Something went wrong:" << serializer.errorMessage();
    20. }

    QJson::Serializer和前面的QJson::Parser的用法相似，只需要调用QJson::Serializer::serialize()即可将QVariant类型的数据转换为 JSON 格式。其返回值是QByteArray类型，可以用于很多其它场合。

    那么，我们可以使用下面的代码将类进行 JSON 序列化：

    1. Person person;
    2. person.setName("Flavio");
    3. person.setPhoneNumber(123456);
    4. person.setGender(Person::Male);
    5. person.setDob(QDate(1982, 7, 12));
    6.  
    7. QVariantMap variant = QObjectHelper::qobject2qvariant(&person);
    8. QJson::Serializer serializer;
    9. qDebug() << serializer.serialize( variant);

    以及：

    进行反序列化。