- 用于在C++结构体和json/xml/json/libconfig之间互相转换
- json/xml只需要头文件, 无需编译库文件
- json缺省支持，其他的需要修改config.h开启相应功能
- 以下例子全部以json为例，其他的类似，具体可以参考x2struct.hpp里面x2struct::X的api定义
- 基本用法
- 必需节点
- 别名
- 继承
- 位域
- 条件加载
- char数组
- 检查是否存在
- 局部类
- 自定义类型
- 第三方类和结构体
- 格式化缩进
- Qt支持
- xml bson libconfig
- 生成Golang结构体
- 重要说明
#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;
}修改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的最后两个参数控制
- 修改config.h，开启XTOSTRUCT_QT这个宏
- 当前支持 QString/QMap/QList/QVector
- 如果需要这些功能，需要修改config.h来开启
- 不支持直接转换vector/map之类的，需要放结构体里面
- 由于xml/libconfig不支持用纯数字作为key，所以如果需要用map<int, xxx>，那么key需要用x+数字的方式，比如x100
- mongoxclient(https://github.com/xyz347/mongoxclient)是对mongo-cxx-driver的一个封装
- 用于将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"`
}