Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/xyz347/xpack
convert json/xml/bson to c++ struct
https://github.com/xyz347/xpack
bson cpp json mysql sqlite struct xml yaml
Last synced: 7 days ago
JSON representation
convert json/xml/bson to c++ struct
- Host: GitHub
- URL: https://github.com/xyz347/xpack
- Owner: xyz347
- License: apache-2.0
- Created: 2020-12-20T11:45:10.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2024-05-22T02:26:18.000Z (8 months ago)
- Last Synced: 2025-01-08T00:07:45.670Z (14 days ago)
- Topics: bson, cpp, json, mysql, sqlite, struct, xml, yaml
- Language: C++
- Homepage:
- Size: 180 KB
- Stars: 630
- Watchers: 16
- Forks: 128
- Open Issues: 4
-
Metadata Files:
- Readme: README-bson.md
- License: LICENSE
Awesome Lists containing this project
README
* 用于在C++结构体和bson之间互相转换
* 这个库可以配合[mongoxclient](https://github.com/xyz347/mongoxclient)使用
# 目录
- [encoder](#encoder)
- [decoder](#decoder)
- [bson types](#bsontypes)
- [builder](#builder)
- [重要说明](#重要说明)
## encoder
用于将结构体转成bson格式。范例：
```C++
struct Test {
int64_t id;
std::string name;
std::string email;
XPACK(A(id, "bson:_id"), O(name, email));
};
Test t;
std::string data = xpack::bson::encode(t); // data就是t转成bson的数据
```
## decoder
用于将bson数据转成结构体
用于将结构体转成bson格式。范例：
```C++
struct Test {
int64_t id;
std::string name;
std::string email;
XPACK(A(id, "bson:_id"), O(name, email));
};
std::string data;
// data = xxxx; data存储了相应的bson数据
Test t;
xpack::bson::decode(data, t);
// xpack::bson::decode 还有另一个参数方式：static void decode(const uint8_t* data, size_t len, T &val)
```
## bsontypes
- date time: `bson_date_time_t`
- timestamp: `bson_timestamp_t`
- binary: `bson_binary_t`
- regex: `bson_regex_t`
- oid: `bson_oid_t`
- decimal128: `bson_decimal128_t`
前4种是xbson额外定义的，后面两种是定义在libbson内的，为了统一，前4种也是定义在全局命名空间。
## builder
**需要C++11或以上版本支持**。用json的格式来构造bson数据。查询接口中的query，一般只需要指定很少几个字段，这个场景用结构体表达不是很方便。用builder就会简单很多。基本用法是：
1. 定义一个BsonBuilder：
- 参数是一个json格式的字符串
- 里面的双引号用单引号替代
- 变量用问号作为占位符，问号后面可以加一个单词用来作为助记符，比如"?"和"?uid"是等效的
- key也可以是变量，key作为变量，问号不用加引号
- BsonBuilder是线程安全的，建议定义为static变量，这样json字符串只需解析一次
范例：
```C++
static xpack::BsonBuilder bd("{'_id':?, ?:?}"); // 带占位符的builder
static xpack::BsonBuilder empty("{}"); // 空bson
static xpack::BsonBuilder student("{'type':'student'}"); // 不带占位符的builder
```
2. 调用Encode函数来构造bson数据，Encode的参数对应的是各个占位符，因此参数个数应该和占位符一致
比如对于上述的BsonBuilder
```C++
std::string data1 = bd.Encode(12345, "type", "master");
std::string data2 = empty.Encode();
std::string data3 = student.Encode();
// 这些bson的数据可以用在mongoxclient的各个接口中
```
3. 其他的一些API
- EncodeAsJson 和Encode类似，但是输出的是json格式的数据，可以用于调试等场景（所以这个其实也是个JsonBuilder）
- Error 如果构造BsonBuilder的json字符串有误，这个接口可以返回错误信息
- static std::string En(const std::string&fmt, Args... args)。这个是把构造BsonBuilder和Encode合在一起了，不是很建议使用，建议用于调试，因为每次都要构造一次BsonBuilder
## 重要说明
- 依赖于[libbson](https://github.com/mongodb/libbson/tree/1.0.0)，需自行安装