第三章 C++ SDK
3.1 环境准备
C++ SDK采用头文件形式分发，无需安装任何第三方库。只需将 sxdb_protocol.h 复制到项目include目录即可。
编译命令
Windows (MSVC)
cl /std:c++17 /I include main.cpp
Windows (MinGW)
g++ -std=c++17 -o client main.cpp -lws2_32
Linux / macOS
g++ -std=c++17 -o client main.cpp -lpthread
3.2 客户端核心类
SxdbClient是C++ SDK的核心类，封装了TCP连接、认证、SQL执行等全部功能。支持RAII资源管理，析构时自动断开连接。
方法
说明
返回值
connect(host, port)
连接服务器
bool
login(user, pass)
认证登录，获取token
bool
open_db(db)
打开指定数据库
bool
execute(db, sql)
执行DDL/DML语句
JVal
query(db, sql)
执行查询语句
JVal
close_db(db)
关闭数据库
bool
disconnect()
断开服务器连接
void
3.3 完整示例
示例：连接、建表、插入、查询
include "sxdb_protocol.h"
include
// 使用 SxdbClient 类 (定义在 protocol.h 中)
// 也可直接使用 sxdb::Protocol 类自行封装
int main() {
SxdbClient client;
// 1. 连接服务器
if (!client.connect("127.0.0.1", 31111)) {
std::cerr << "Failed to connect" << std::endl;
return 1;
}
// 2. 登录认证
if (!client.login("admin", "admin123")) {
return 1;
}
// 3. 打开数据库
client.open_db("myapp");
// 4. 创建表
client.execute("myapp",
"CREATE TABLE IF NOT EXISTS users("
"id INTEGER PRIMARY KEY AUTOINCREMENT, "
"name TEXT NOT NULL, age INTEGER)");
// 5. 插入数据
client.execute("myapp",
"INSERT INTO users(name,age) VALUES('\xe5\xbc\xa0\xe4\xb8\x89',25)");
// 6. 查询数据
auto result = client.query("myapp", "SELECT * FROM users");
auto& cols = result["data"]["columns"];
auto& rows = result["data"]["rows"];
for (size_t i = 0; i < rows.av.size(); i++) {
std::cout << rows[i][0].gi() << " "
<< rows[i][1].gs() << " "
<< rows[i][2].gi() << std::endl;
}
// 7. 清理
client.close_db("myapp");
client.disconnect();
return 0;
}
代码3-1 C++ 完整示例程序
运行输出
=== SXDB C++ Client Example ===
[1] Connecting to SXDB server (localhost:31111)...
Connected!
[2] Authenticating (admin/admin123)...
Authenticated!
[3] Opening database 'test'...
Database opened!
[4] Creating table 'users'...
Table created! code=0
[5] Inserting data...
Inserted 3 rows!
[6] Querying data...
id name age email
1 张三 25 zhangsan@example.com
2 李四 30 lisi@example.com
3 王五 28 wangwu@example.com
[7] Updating data...
Updated! affected=1
[8] Deleting data...
Deleted! affected=1
[Done] Disconnected from server.
图3-2 C++客户端运行结果