2 Star 2 Fork 0

超哥 / x2struct

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
该仓库未声明开源许可证文件(LICENSE),使用请关注具体项目描述及其代码上游依赖。
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README

x2struct

  • 用于在C++结构体和json/xml/json/libconfig之间互相转换
  • json/xml只需要头文件, 无需编译库文件
  • json缺省支持,其他的需要修改config.h开启相应功能
  • 以下例子全部以json为例,其他的类似,具体可以参考x2struct.hpp里面x2struct::X的api定义

基本用法

#include <iostream>
#include "x2struct/x2struct.hpp" // 包含这个头文件

using namespace std;

struct User {
    int64_t id;
    string  name;
    string  mail;
    User(int64_t i=0, const string& n="", const string& m=""):id(i),name(n),mail(m){}
    XTOSTRUCT(O(id, name, mail)); // 添加宏定义XTOSTRUCT在结构体定义结尾
};

struct Group {
    string  name;
    int64_t master;
    vector<User> members;
    XTOSTRUCT(O(name, master, members)); // 添加宏定义XTOSTRUCT在结构体定义结尾
};

int main(int argc, char *argv[]) {
    Group g;
    g.name = "C++";
    g.master = 2019;
    g.members.resize(2);
    g.members[0] = User(1, "Jack", "jack@x2struct.com");
    g.members[1] = User(2, "Pony", "pony@x2struct.com");

    string json = x2struct::X::tojson(g);  // 结构体转json
    cout<<json<<endl;

    Group n;
    x2struct::X::loadjson(json, n, false); // json转结构体
    cout<<n.name<<endl;

    vector<int> vi;
    x2struct::X::loadjson("[1,2,3]", vi, false); // 直接加载vector
    cout<<vi.size()<<','<<vi[1]<<endl;

    map<int, int> m;
    x2struct::X::loadjson("{\"1\":10, \"2\":20}", m, false); // 直接加载map
    cout<<m.size()<<','<<m[2]<<endl;

    return 0;
}

步骤有:

  • 引用头文件 "x2struct.hpp"
  • 添加宏定义XTOSTRUCT在结构体结尾, 里面用"O"包含所有变量
  • 用x2struct::X::tojson将结构体转json
  • 用x2struct::X::loadjson将json转结构体

必需节点

  • 用于在json转结构体的时候,某些key是要求必须存在的
  • 用"M"来包含必需节点的变量
  • 如果json里面没有这些key,转结构体的时候会抛出异常
#include <iostream>
#include "x2struct/x2struct.hpp"

using namespace std;

struct Test {
    int64_t id;
    string  name;
    XTOSTRUCT(M(id), O(name)); // "id"是必需节点,用M包含,"name"是可选节点,用"O"包含
};

int main(int argc, char *argv[]) {
    Test t;
    string json="{\"name\":\"Pony\"}";

    x2struct::X::loadjson(json, t, false); // 这里将会抛异常,因为"id"是必需节点,但是json里面没有
    return 0;
}

别名

  • 用于变量名和key名不一致的场景
  • 用"A"包含需要设置别名的变量,"A"包含两个参数,参数1是变量名,参数2是别名信息
  • 别名段的基本格式是"[type:]alias[,extension]", 别名信息可以包含多个别名段,别名段之间用空格隔开
  • type的值可以是"json"/"xml"/"bson"/"config", 如果别名段没有type这个字段,则表示这个别名段对所有的type生效,例子:
    • "tid" 由于没有type,那么表示所有的type的别名都是"tid"
    • "tid json:xid" "tid"没指定type,xid指定了json,那么json用xid,其他的用tid
  • 扩展字段目前只支持"m",表示必需节点(缺省是可选)
  • 如果在json里面没有别名,依然会尝试变量名
  • 结构体转json的时候,用别名
#include <iostream>
#include "x2struct/x2struct.hpp"

using namespace std;

struct Test {
    int64_t uid;
    string  name;
    XTOSTRUCT(A(uid, "id"), O(name)); // "uid"的别名是"id"
};

int main(int argc, char *argv[]) {
    Test t;
    string json="{\"id\":123, \"name\":\"Pony\"}";

    x2struct::X::loadjson(json, t, false); 
    cout<<t.uid<<endl;
    return 0;
}

继承

  • 使用"I"来包含父类
#include <iostream>
#include "x2struct/x2struct.hpp"

using namespace std;

struct P1 {
    string mail;
    XTOSTRUCT(O(mail));
};

struct P2 {
    int64_t version;
    XTOSTRUCT(O(version));
};

struct Test:public P1, public P2 {
    int64_t uid;
    string  name;
    XTOSTRUCT(I(P1, P2), O(uid, name)); 
};

int main(int argc, char *argv[]) {
    Test t;
    string json="{\"mail\":\"pony@x2struct.com\", \"version\":2019, \"id\":123, \"name\":\"Pony\"}";

    x2struct::X::loadjson(json, t, false);
    cout<<t.mail<<endl;
    cout<<t.version<<endl;
    return 0;
}

位域

  • 使用"B"来包含位域变量
#include <iostream>
#include "x2struct/x2struct.hpp"

using namespace std;

struct Test {
    int16_t ver:8;
    int16_t len:8;
    string  name;
    XTOSTRUCT(B(ver, len), O(name)); 
};

int main(int argc, char *argv[]) {
    Test t;
    string json="{\"ver\":4, \"len\":20, \"name\":\"IPv4\"}";

    x2struct::X::loadjson(json, t, false);
    cout<<t.ver<<endl;
    cout<<t.len<<endl;
    return 0;
}

条件加载

  • 用于从json对象数组里面加载满足条件的对象,最多加载一个
  • 用"C"包含需要条件加载的变量,放在XTOSTRUCT开头
  • 除了用"C"包含,条件加载的变量还需要继续用O/A/M中的一个包含
#include <iostream>
#include "x2struct/x2struct.hpp"

using namespace std;

struct Task {
    int id;
    string name;
    XTOSTRUCT(O(id, name));
};

struct Test {
    int  tid;
    Task task;
    XTOSTRUCT(C(task), O(tid, task)); // 在XTOSTRUCT里面,task既包含在"C"里面,也包含在"O"里面
    /*
     XTOSTRUCT_CONDITION 这个宏包含两个参数,一个类名,一个变量名
     XTOSTRUCT_CONDITION 定义了一个函数,函数有一个变量,名为"obj"指向的是变量对应的xdoc
     "task"在json里面是一个数组,这里只加载那个XTOSTRUCT_CONDITION返回true的那个,这里当tid等于id时返回true
    */
    XTOSTRUCT_CONDITION(Test, task) {
        int id;
        // only load the one that Task.id is equal to Test.tid
        return obj.convert("id", id)&&id==this->tid;
    }
};



int main(int argc, char *argv[]) {
    string s = "{\"tid\":2019,\"task\":[{\"id\":2018,\"name\":\"hello\"},{\"id\":2019,\"name\":\"world\"}]}";
    Test t;
    x2struct::X::loadjson(s, t, false);
    cout<<t.task.name<<endl;
}

char数组

修改config.h,使能XTOSTRUCT_SUPPORT_CHAR_ARRAY这个宏即可

检查是否存在

  • 用于json转结构体的时候,检查json里面的某个key是否存在
  • 用xhas函数检查
#include <iostream>
#include "x2struct/x2struct.hpp"

using namespace std;

struct Test {
    int64_t id;
    string  name;
    XTOSTRUCT(O(id, name));
};

int main(int argc, char *argv[]) {
    Test t;
    string json="{\"name\":\"Pony\"}";

    x2struct::X::loadjson(json, t, false, true); // 如果需要用这个功能,第四个参数需要是true
    cout<<t.xhas("id")<<endl;       // 用xhas检查是否存在
    cout<<t.xhas("name")<<endl;
    return 0;
}

局部类

  • XTOSTRUCT会在结构体/类中添加模板函数,而局部类(定义在函数内的类)是不支持模板函数的
  • 用XTOSTRUCT_NT(types) 替代XTOSTRUCT, types支持Json/Xml/Bson/Config
  • 需要支持C++11
  • 目前局部类还不支持条件加载
// nt.cpp
// g++ -o t nt.cpp -std=c++11
#include <iostream>
#include "x2struct/x2struct.hpp"

using namespace std;

int main(int argc, char *argv[]) {
    struct Test {
        int64_t id;
        string  name;
        XTOSTRUCT_NT(Json)(O(id, name));
    };

    Test t;
    string json="{\"id\":123, \"name\":\"Pony\"}";

    x2struct::X::loadjson(json, t, false);
    cout<<t.name<<endl;
    return 0;
}

自定义类型

  • 自定义类型的本质是string类型
  • 需要实现这些函数:
    • std::string format() const; 用于将对象转为字符串
    • void parse(const std::string&); 用于将字符串转为对象
  • 最后用typedef XType 完成自定义类型的定义
  • 以下代码是一个IPv4的例子
#include <iostream>
#include "x2struct/x2struct.hpp"

using namespace std;

// 只是一个范例,没做错误处理
struct _XIPv4 {
    uint32_t ip;
    // 实现format函数
    std::string format() const {
        char buf[64];
        int  len = sprintf(buf, "%u.%u.%u.%u", ip>>24, 0xff&(ip>>16), 0xff&(ip>>8), 0xff&ip);
        return string(buf, len);
    }
    // 实现parse函数
    void parse(const std::string& d) {
        uint32_t u[4];
        sscanf(d.c_str(), "%u.%u.%u.%u", &u[0], &u[1], &u[2], &u[3]);
        ip = (u[0]<<24)+(u[1]<<16)+(u[2]<<8)+u[3];
    }
};

// typedef 定义
typedef x2struct::XType<_XIPv4> XIPv4;

struct Test {
    XIPv4 ip;
    XIPv4 mask;
    XTOSTRUCT(O(ip, mask));
};

int main(int argc, char *argv[]) {
    Test t;
    // 在json里面自定义类型是string
    string json="{\"ip\":\"192.168.1.2\", \"mask\":\"255.255.255.0\"}";

    x2struct::X::loadjson(json, t, false);
    cout<<t.ip.ip<<','<<t.mask.ip<<endl;
    cout<<x2struct::X::tojson(t)<<endl;
    return 0;
}

第三方类和结构体

  • 需要C++11支持
  • 用XTOSTRUCT_OUT而非XTOSTRUCT
#include <sys/time.h>
#include <iostream>
#include "x2struct/x2struct.hpp"

using namespace std;

/*
struct timeval {
    time_t      tv_sec;
    suseconds_t tv_usec;
};
*/

// timeval is thirdparty struct
XTOSTRUCT_OUT(timeval, O(tv_sec, tv_usec));

struct T {
    int  a;
    string b;
    timeval t;
    XTOSTRUCT(O(a, b, t));
};


int main(int argc, char *argv[]) {
    T t;
    T r;
    t.a = 123;
    t.b = "x2struct";
    t.t.tv_sec = 888;
    t.t.tv_usec = 999;
    string s = x2struct::X::tojson(t);
    cout<<s<<endl;
    x2struct::X::loadjson(s, r, false);
    cout<<r.a<<','<<r.b<<','<<r.t.tv_sec<<','<<r.t.tv_usec<<endl;
    return 0;
}

格式化缩进

  • tojson的最后两个参数控制

Qt支持

  • 修改config.h,开启XTOSTRUCT_QT这个宏
  • 当前支持 QString/QMap/QList/QVector

xml bson libconfig

生成Golang结构体

  • 用于将C++结构体转Golang结构体
  • 需要定义宏XTOSTRUCT_GOCODE
// go.cpp
// g++ -o t go.cpp -DXTOSTRUCT_GOCODE
#include <iostream>
#include "x2struct/x2struct.hpp"

using namespace std;

struct Test {
    int64_t id;
    vector<string>  names;
    XTOSTRUCT(O(id, names));
};

int main(int argc, char *argv[]) {
    Test t;

    cout<<x2struct::X::togocode(t, true, true, true)<<endl; // 最后三个参数用于控制(json/bson/xml) tag的生成
    return 0;
}

输出是:

type Test struct {
        Id      int64       `json:"id" bson:"id" xml:"id"`
        Names   []string    `json:"names" bson:"names" xml:"names"`
}

重要说明

  • json的序列化反序列化用的是rapidjson
  • xml的反序列化用的是rapidxml
  • bson的反序列化用的是libbson
  • libconfig的反序列化用的是libconfig
  • xml/bson的序列化是我自己写的,没有参考RFC,可能有和标准不一样的地方.
  • bson/libconfig的库是预编译的. 环境是: Ubuntu12.04 g++4.9.2. 其他环境如果想使用bson/libconfig可能需要自行编译这两个库
  • 有疑问可以加QQ群878041110

空文件

简介

json和struct相互转换 展开 收起
取消

发行版

暂无发行版

贡献者

全部

近期动态

加载更多
不能加载更多了
1
https://gitee.com/yhc2020/x2struct.git
git@gitee.com:yhc2020/x2struct.git
yhc2020
x2struct
x2struct
master

搜索帮助