之前写过一篇文章专门分析了 c 模板编译过程中报的一个错误:《fatal error C1045: 编译器限制 : 链接规范嵌套太深 》,其中涉及到了 qtl —— 一个使用 c 11 构建的数据库访问库,当时限于篇幅,没有深入研究它是如何借助 c 11 来简化数据库访问接口的,本文现在就来探讨一下这方面的内容。
没有 c 11 之前,苦逼的程序员对于 sql 操作的输入输出,只好一行行敲代码,例如在调用数据库接口前设置绑定参数;在调用成功后,循环遍历查询的记录。很多时候数据库表对应在程序中就是一个结构体,程序员需要花费大量的精力将数据库表字段对应到结构体成员上、或反之,完全没有体现出来程序员应有的价值。而 qtl 这种 c 11 库的出现,可以极大的简化上面的程序编写,下面还是用之前文章中提到的例子作为演示,让大家感受一下:
插入单条数据
代码语言:javascript复制 1 uint64_t test_insert_single(qtl::sqlite::database &db)
2 {
3 time_t now = time(0);
4 int tmp = rand() % 1000;
5 uint64_t id = db.insert_direct("insert into popbox_msg(msgid, msgtype, appname, uid, status, count, msgbody, stamp) values(?, ?, ?, ?, ?, ?, ?, ?)",
6 std::to_string(tmp), 108, "GDraw", "1923374929399", 1, 0, "this is msgbody", now);
7
8 printf("insert record with msgid %d return %dn", tmp, (int)id);
9 return id;
10 }
插入操作需要输入数据,将数据编入 sql 是一种思路,但更好的方法是使用占位符 (?) 和数据绑定 (binding) 来防止 sql 注入问题,而这会给接口带来不定数量的输入参数,幸好 c 11 的可变模板参数特性允许用户提供不限数量与类型的输入数据,是不是很方便?下面是 qtl 提供的插入单条数据接口:
代码语言:javascript复制1 uint64_t qtl::base_database<T, Command>::insert<Params>(const std::string & query_text, const Params & params);
2 uint64_t qtl::base_database<T, Command>::insert<Params>(const char * query_text, const Params & params);
3 uint64_t qtl::base_database<T, Command>::insert<Params>(const char * query_text, size_t text_length, const Params & params);
4
5 uint64_t qtl::base_database<T, Command>::insert_direct<...Params>(const std::string & query_text, const Params & ...params);
6 uint64_t qtl::base_database<T, Command>::insert_direct<...Params>(const char * query_text, const Params & ...params);
7 uint64_t qtl::base_database<T, Command>::insert_direct<...Params>(const char * query_text, size_t text_length, const Params & ...params);
其中主要分两组:insert 与 insert_direct,前者只提供一个输入绑定参数,后者可以提供多个。而且这些接口会很贴心的将新插入记录的 rowid 返回,方便后续操作这条记录。
更新单条数据
代码语言:javascript复制1 void test_update_single(qtl::sqlite::database &db, uint64_t rowid)
2 {
3 time_t now = time(0);
4 uint64_t affected = 0;
5 db.execute_direct("update popbox_msg set status=?, count=?, stamp=? where rowid=?", &affected, 0, 3, now, (int)rowid);
6 printf("update record with rowid %d affected %d recordsn", (int)rowid, (int)affected);
7 }
更新操作和插入操作类似,输入数据是必不可少的,但它有时也需要更新符合条件的记录,而这会带来另一坨不定数量的输入参数,不过好在二者都是输入参数,可以合二为一使用一个维度的可变模板参数,依次将更新参数与条件参数罗列在 qtl 接口提供的参数列表中即可:
代码语言:javascript复制1 void qtl::base_database<T, Command>::execute<Params>(const std::string & query_text, const Params & params, uint64_t * affected = NULL);
2 void qtl::base_database<T, Command>::execute<Params>(const char * query_text, const Params & params, uint64_t * affected = NULL);
3 void qtl::base_database<T, Command>::execute<Params>(const char * query_text, size_t text_length, const Params & params, uint64_t * affected = NULL);
4
5 void qtl::base_database<T, Command>::execute_direct<...Params>(const std::string & query_text, uint64_t * affected, const Params & ...params);
6 void qtl::base_database<T, Command>::execute_direct<...Params>(const char * query_text, uint64_t * affected, const Params & ...params);
7 void qtl::base_database<T, Command>::execute_direct<...Params>(const char * query_text, size_t text_length, uint64_t * affected, const Params & ...params);
主要也是两组接口:execute 与 execute_direct,前者只提供一个输入绑定参数,后者可以提供多个。由于是插入多条数据,这里没有办法返回某一条记录的 rowid,代之以的是更新的行数 affected,如果这个参数为空,则不返回。
插入多条数据
代码语言:javascript复制void test_insert_multi(qtl::sqlite::database &db)
{
uint64_t affected = 0;
int tmp[3] = { 0 };
for (int i=0; i<3; i)
tmp[i] = rand() % 1000;
auto stmt = db.open_command("insert into popbox_msg(msgid, msgtype, appname, uid, status, count, msgbody, stamp) "
"values(?, 108, 'GDraw', '1923374929399', 1, 0, 'this is msgbody', strftime('%s','now'))");
qtl::execute(stmt, &affected, std::to_string(tmp[0]), std::to_string(tmp[1]), std::to_string(tmp[2]));
printf("insert %d recordn", (int)affected);
}
插入多条数据时,可变模板参数列表的每一个参数表示一个输入绑定参数、针对一条新记录,这样一来就不太够用了。例如上面这个例子中,相当于插入了三条不同的 popbox_msg 记录,每个输入参数对应记录的 msgid 字段,如果一条记录有多个字段需要输入就不适用了,那种场景下就需要写个循环多次调用插入单条数据的操作了(其实插入多条的接口底层也是递归为插入单条来执行的,所以这样做性能没有太大损失)。
更新多条数据
代码语言:javascript复制1 void test_update_multi(qtl::sqlite::database &db)
2 {
3 uint64_t affected = 0;
4 int id[3] = { 19, 20, 21 };
5
6 auto stmt = db.open_command("update popbox_msg set status=0, count=2, stamp=strftime('%s','now') where rowid=? ");
7 qtl::execute(stmt, &affected, id[0], id[1], id[2]);
8 printf("update %d recordn", (int)affected);
9 }
其实和插入多条数据非常相似,每条记录只能允许一个输入绑定参数。
删除数据
代码语言:javascript复制1 void test_delete(qtl::sqlite::database &db)
2 {
3 uint64_t affected = 0;
4 db.execute_direct("delete from popbox_msg where msgtype=? and appname=? and uid=?", &affected, 108, "GDraw", "1923374929399");
5 printf("delete record affected %d rowsn", (int)affected);
6 }
删除数据时由于只需要提供删除条件的输入绑定参数,而实际结果可能删除一条、也可能删除多条,所以不在数量上做区分。这里使用的是和更新数据一样的接口:execute 和 execute_direct,同样的,前者只能允许一个输入绑定参数,适合较简单的 sql 语句;后者可以允许多个输入绑定参数,适合较复杂的 sql。最后,删除的行数由 affected 参数返回给调用者。
查询单条数据
代码语言:javascript复制1 void test_query_single(qtl::sqlite::database &db, uint64_t rowid)
2 {
3 std::string msg;
4 db.query_first("select msgbody from popbox_msg where rowid=?", (int)rowid, msg);
5 printf("row %d: %sn", (int)rowid, msg.c_str());
6 }
查询单条数据时可以直接将查询到的数据以输出参数方式回传,而查询条件往往又需要输入绑定参数,那 qtl 是如何区分可变模板参数列表中哪些是入参、哪些是出参呢?答案是区分不了。因此在接口设计上,qtl 的查询单条数据接口最多允许一个入参:
代码语言:javascript复制1 void qtl::base_database<T, Command>::query_first<Values>(const std::string & query_text, Values && values);
2 void qtl::base_database<T, Command>::query_first<Values>(const char * query_text, Values && values);
3 void qtl::base_database<T, Command>::query_first<Values>(const char * query_text, size_t text_length, Values && values);
4
5 void qtl::base_database<T, Command>::query_first<Params, Values>(const std::string & query_text, const Params & params, Values && values);
6 void qtl::base_database<T, Command>::query_first<Params, Values>(const char * query_text, const Params & params, Values && values);
7 void qtl::base_database<T, Command>::query_first<Params, Values>(const char * query_text, size_t text_length, const Params & params, Values && values);
主要分为两组:只带一个出参的 query_first;带一个出参和一个入参的 query_first。这个接口只针对特别简单的 sql 语句,如果想要返回一条记录的多个字段时,就必需使用另一组接口:query_first_direct
代码语言:javascript复制1 void qtl::base_database<T, Command>::query_first_direct<...Values>(const std::string & query_text, Values & ...values);
2 void qtl::base_database<T, Command>::query_first_direct<...Values>(const char * query_text, Values & ...values);
3 void qtl::base_database<T, Command>::query_first_direct<...Values>(const char * query_text, size_t text_length, Values & ...values);
遗憾的是这个接口虽然能提供多个出参,却无法提供任何入参,所有入参必需事先构建在 sql 语句中,这十分不优雅,但没有办法。下面是使用的例子:
代码语言:javascript复制 1 void test_query_single_ex(qtl::sqlite::database &db, uint64_t rowid)
2 {
3 time_t stamp = 0;
4 int status = 0, count = 0;
5
6 std::ostringstream oss;
7 oss << "select status, count, stamp from popbox_msg where rowid=" << rowid;
8 db.query_first_direct(oss.str (), status, count, stamp);
9 printf("row %d: status %d, count %d, stamp %dn", (int)rowid, status, count, (int)stamp);
10 }
从这个实际例子看,以后 c 可变模板参数列表可能需要支持两个参数列,一列是输入参数,一列是输出参数了。但是转念一想,这样好像也不对,因为出参与入参在调用点并无任何区别,编译器如何知道哪个是出参哪个是入参呢?所以这个问题可能还真是无解了。
查询多条数据
代码语言:javascript复制 1 void test_query_multi(qtl::sqlite::database &db)
2 {
3 int cnt = 0;
4 db.query("select status, count, stamp from popbox_msg where appname=?", "GDraw",
5 [&cnt](int status, int count, time_t stamp){
6 printf("%d, %d, %dn", status, count, (int)stamp);
7 cnt ;
8 });
9
10 printf("query %d recordsn", cnt);
11 }
因为可能返回多条数据,这里使用回调函数(一般为 lambda 表达式)来接收读取的记录。回调函数参数列表必需与 select 选择的数据库表列相匹配。
代码语言:javascript复制1 void qtl::base_database<T, Command>::query<ValueProc>(const std::string & query_text, ValueProc && proc);
2 void qtl::base_database<T, Command>::query<ValueProc>(const char * query_text, ValueProc && proc);
3 void qtl::base_database<T, Command>::query<ValueProc>(const char * query_text, size_t text_length, ValueProc && proc);
4
5 void qtl::base_database<T, Command>::query<Params, ValueProc>(const std::string & query_text, const Params & params, ValueProc && proc);
6 void qtl::base_database<T, Command>::query<Params, ValueProc>(const char * query_text, const Params & params, ValueProc && proc);
7 void qtl::base_database<T, Command>::query<Params, ValueProc>(const char * query_text, size_t text_length, const Params & params, ValueProc && proc);
query 接口分为两组:一组只提供一个回调函数用于接收数据;另一组还提供一个额外的输入绑定参数。对于复杂的 sql 查询,这个还是不太够用,我不清楚为什么不能在 ValueProc proc 参数后面加一个可变模板参数列表,这样就不可以接收多个输入绑定参数了么?此处存疑。不过这个好歹比 query_first 要么只返回一个字段、要么返回多个字段但不接收输入参数要强一点。除了优点,这个接口也有一个不惹人注意的 bug,请看下面这段代码:
代码语言:javascript复制 1 void test_query_multi(qtl::sqlite::database &db)
2 {
3 int cnt = 0;
4 db.query("select msgid, msgtype, appname, uid, status, count, msgbody, stamp from popbox_msg where appname=?", "GDraw",
5 [&cnt](std::string const& msgid, int msgtype, std::string const& appname, std::string const& uid, int status, int count, std::string const& msgbody, time_t stamp){
6 printf("%s, %d, %s, %s, %d, %d, %s, %dn", msgid.c_str(), msgtype, appname.c_str(), uid.c_str(), status, count, msgbody.c_str(), (int)stamp);
7 cnt ;
8 });
9
10 printf("query %d recordsn", cnt);
11 }
我增加了从数据库表中选取的字段,并相应的增加了 lambda 表达式的参数列表,当数量达到一个阈值时(亲测为8),VS2013 编译器将报错退出:
代码语言:javascript复制e:codeqtlincludeqtlapply_tuple.h(17): fatal error C1045: 编译器限制 : 链接规范嵌套太深
具体分析请参考我的另一篇文章:《fatal error C1045: 编译器限制 : 链接规范嵌套太深》。这里我着重想说明的是,使用这种方式传递的字段在某些编译器上是有上限的,所以可移植性不太好。相信聪明的你已经猜到了,由于 query_first_direct 使用了和 query 相同的底层机制,query_first_direct 在 VS2013 上也存在相同的问题。幸好 qtl 还有另外一种方法,可以解决上面的问题,这就是结构体成员绑定:
代码语言:javascript复制 1 class popbox_msg_t
2 {
3 public:
4 void dump(char const* prompt) const;
5
6 int msgtype = 0; // 108 or 402
7 int status = 0; // send to server result, (1:ok; 0:fail)
8 int count = 0; // retry times, if exceed POPBOX_MSG_RETRY_MAX, stop retry
9 time_t stamp = 0; // receive time
10 std::string msgid;
11 std::string msgbody;
12 std::string appname;
13 std::string uid;
14 };
15
16
17 void popbox_msg_t::dump(char const* prompt) const
18 {
19 tm* t = localtime(&stamp);
20 printf("%s : %s,%s,%s,%d,%d,%d, d-d-d d:d:d, %sn",
21 prompt,
22 appname.c_str(),
23 uid.c_str(),
24 msgid.c_str(),
25 msgtype,
26 status,
27 count,
28 t->tm_year 1900,
29 t->tm_mon 1,
30 t->tm_mday 1,
31 t->tm_hour,
32 t->tm_min,
33 t->tm_sec,
34 msgbody.c_str());
35 }
36
37 namespace qtl
38 {
39 template<>
40 inline void bind_record<qtl::sqlite::statement, popbox_msg_t>(qtl::sqlite::statement& command, popbox_msg_t&& v)
41 {
42 int n = 0;
43 qtl::bind_field(command, n , v.msgid);
44 qtl::bind_field(command, n , v.msgtype);
45 qtl::bind_field(command, n , v.appname);
46 qtl::bind_field(command, n , v.uid);
47 qtl::bind_field(command, n , v.status);
48 qtl::bind_field(command, n , v.count);
49 qtl::bind_field(command, n , v.msgbody);
50 qtl::bind_field(command, n , v.stamp);
51 }
52 }
53
54 void test_query_multi_ex(qtl::sqlite::database &db)
55 {
56 int cnt = 0;
57 db.query("select msgid, msgtype, appname, uid, status, count, msgbody, stamp from popbox_msg where appname=?", "GDraw",
58 [&cnt](popbox_msg_t const& pm){
59 pm.dump("msg");
60 cnt ;
61 });
62
63 printf("query %d recordsn", cnt);
64 }
同样是 query 接口,同样是 lambda 表达式作为回调函数,不同的是,我提前声明了一个结构体 popbox_msg_t,并提供了 qtl::bind_record 模板函数的一个特化、来将数据库表的列与结构体成员二者关联起来,这样我的 lambda 表达式只要接收结构体就够了,qtl 在底层会自动根据 bind_record 将读取的数据初始化到结构体中供我们使用。因为这种方式避免了罗列各个输出参数,所以可以很好的避免上述问题。 另外关于 bind_record 补充一点,最新版本的 qtl 可以在 bind_record 模板特化中使用一个 bind_fields 来指定所有成员的对应关系了(我使用的旧版没有这个接口),类似于这样:
代码语言:javascript复制qtl::bind_fields(command, v.msgid, v.msgtype, v.appname, v.uid, v.status, v.count, v.msgbody, v.stamp);
是不是更简单了呢?有了结构体绑定,还可以玩出许多花样,例如直接用结构体的成员函数来代替 lambda 表达式:
代码语言:javascript复制 1 class popbox_msg_t
2 {
3 public:
4 void dump(char const* prompt) const;
5 void print();
6
7 int msgtype = 0; // 108 or 402
8 int status = 0; // send to server result, (1:ok; 0:fail)
9 int count = 0; // retry times, if exceed POPBOX_MSG_RETRY_MAX, stop retry
10 time_t stamp = 0; // receive time
11 std::string msgid;
12 std::string msgbody;
13 std::string appname;
14 std::string uid;
15 };
16
17
18 void popbox_msg_t::dump(char const* prompt) const
19 {
20 tm* t = localtime(&stamp);
21 printf("%s : %s,%s,%s,%d,%d,%d, d-d-d d:d:d, %sn",
22 prompt,
23 appname.c_str(),
24 uid.c_str(),
25 msgid.c_str(),
26 msgtype,
27 status,
28 count,
29 t->tm_year 1900,
30 t->tm_mon 1,
31 t->tm_mday 1,
32 t->tm_hour,
33 t->tm_min,
34 t->tm_sec,
35 msgbody.c_str());
36 }
37
38 void popbox_msg_t::print ()
39 {
40 dump("msg");
41 }
42
43 namespace qtl
44 {
45 template<>
46 inline void bind_record<qtl::sqlite::statement, popbox_msg_t>(qtl::sqlite::statement& command, popbox_msg_t&& v)
47 {
48 int n = 0;
49 qtl::bind_field(command, n , v.msgid);
50 qtl::bind_field(command, n , v.msgtype);
51 qtl::bind_field(command, n , v.appname);
52 qtl::bind_field(command, n , v.uid);
53 qtl::bind_field(command, n , v.status);
54 qtl::bind_field(command, n , v.count);
55 qtl::bind_field(command, n , v.msgbody);
56 qtl::bind_field(command, n , v.stamp);
57 }
58 }
59
60 void test_query_multi_ex(qtl::sqlite::database &db)
61 {
62 int cnt = 0;
63 db.query("select msgid, msgtype, appname, uid, status, count, msgbody, stamp from popbox_msg where appname=?", "GDraw",
64 &popbox_msg_t::print);
65
66 printf("query %d recordsn", cnt);
67 }
代码高亮的部分就是两个版本的差异,这里使用了 popbox_msg_t 的一个成员函数 print 来充当 lambda 表达式的作用,这样做可以将代码集中到结构体中进行维护。不过缺点也是明显的,就是不能自由的选取外部输入参数了,例如对遍历记录数的统计,在新版本中就没办法做到了。除了上面的方式,还有一种新花样:
代码语言:javascript复制 1 void test_query_multi_ul(qtl::sqlite::database &db)
2 {
3 int cnt = 0;
4 for(auto& pm : db.result<popbox_msg_t>("select msgid, msgtype, appname, uid, status, count, msgbody, stamp from popbox_msg where appname=?", "GDraw"))
5 {
6 pm.dump("msg");
7 cnt ;
8 }
9
10 printf("query %d recordsn", cnt);
11 }
这种方式已经脱离了 query 接口,使用的是 result 接口,虽然壳变了,但是底层机制和 query 是一致的,都是通过 bind_record 将查询到的数据填充到结构体中,下面是 result 的接口定义:
代码语言:javascript复制1 query_result<Command,Record> qtl::base_database<T, Command>::result<Record>(const std::string & query_text);
2 query_result<Command,Record> qtl::base_database<T, Command>::result<Record>(const char * query_text);
3 query_result<Command,Record> qtl::base_database<T, Command>::result<Record>(const char * query_text, size_t text_length);
4
5 query_result<Command,Record> qtl::base_database<T, Command>::result<Record, Params>(const std::string & query_text, const Params & params);
6 query_result<Command,Record> qtl::base_database<T, Command>::result<Record, Params>(const char * query_text, const Params & params);
7 query_result<Command,Record> qtl::base_database<T, Command>::result<Record, Params>(const char * query_text, size_t text_length, const Params & params);
主要分为两组:一组只接收 sql 输入;另一组还可以接收一个额外的输入绑定参数。除了返回类型,与 query 接口几乎一模一样,可以理解成是将 query 的回调函数转化成了 result 返回的 query_result 集合。像上面例子那样写代码,几乎找到了之前 c 语言操作数据库的感觉,特别是不用把需要的外部变量在 lambda 表达式里一一捕获了,在循环里就可以直接用它们,就是一个字:爽!
如果有多个操作都从一个表中查询,可能只是选取的字段不同,那么这种情况下一个结构体就不够了,必需为每个查询定义一个独一无二的结构体并提供相应的 bind_record 函数(即使这些结构体拥有近似的成员)。这样简直是重复造轮子,难道不能定义一个包含所有字段的“超集”结构体,让它来包打所有这个表的查询吗?有的人可能会想,你把 sql 语句改造一下,每次选取所有字段、多余的不要用就好了呀!但是这样肯定不是一个优雅的解决方案,qtl 最新版本中包含了关于这方面的解决方案,那就是自定义绑定,请看下面这个例子:
代码语言:javascript复制 1 void my_bind(popbox_msg_t&& v, qtl::sqlite::statement& command)
2 {
3 int n = 0;
4 qtl::bind_field(command, n , v.status);
5 qtl::bind_field(command, n , v.count);
6 qtl::bind_field(command, n , v.stamp);
7 }
8
9 void test_query_multi_custom(qtl::sqlite::database &db)
10 {
11 int cnt = 0;
12 db.query_explicit("select status, count, stamp from popbox_msg where appname=?", "GDraw",
13 qtl::custom_bind(popbox_msg_t(), my_bind),
14 [&cnt](popbox_msg_t const& pm){
15 printf("msg: %d, %d, %dn", pm.status, pm.count, pm.stamp);
16 cnt ;
17 });
18
19 printf("query %d recordsn", cnt);
20 }
这个例子可以和前面的 popbox_msg_t 定义及其默认 bind_record 函数放在一起,由于这里我们使用 query_explicit 接口明确指定了使用的绑定函数是 my_bind,之前定义的默认绑定函数就不再起作用啦。这个查询只要表中的三个字段,因此在查询结束后也只有三个字段可用。我在下载了最新版本的 qtl 并尝试编译这代码时,编译器报错说没有找到 custom_bind 的定义,我全文搜索了一下也确实没有,但是这个例子可是我照着官网写的啊,难不成作者后来修改了代码忘记同步文档了吗?不得而知。
最后,对于数据库应用来说,视图 (view) 和过程 (procedure) 也是数据库经常接触到的概念,有的数据库过程会调用多个 select 语句查询结果,此时我们的接口又该怎么接收这些数据呢?答案就是 query_multi 和 query_multi_with_params,它们允许用户提供多个回调函数,一般就是写多个 lambda 表达式啦,这样就可以按过程中调用 select 语句的顺序来接收对应的查询结果了:
代码语言:javascript复制1 void qtl::base_database<T, Command>::query_multi<...ValueProc>(const std::string & query_text, ValueProc && ...proc);
2 void qtl::base_database<T, Command>::query_multi<...ValueProc>(const char * query_text, ValueProc && ...proc);
3 void qtl::base_database<T, Command>::query_multi<...ValueProc>(const char * query_text, size_t text_length, ValueProc && ...proc);
4
5 void qtl::base_database<T, Command>::query_multi_with_params<Params, ...ValueProc>(const std::string & query_text, const Params & params, ValueProc && ...proc);
6 void qtl::base_database<T, Command>::query_multi_with_params<Params, ...ValueProc>(const char * query_text, const Params & params, ValueProc && ...proc);
7 void qtl::base_database<T, Command>::query_multi_with_params<Params, ...ValueProc>(const char * query_text, size_t text_length, const Params & params, ValueProc && ...proc);
query_multi_with_params 顾名思义,就是在 query_multi 的基础上,允许一个额外的输入绑定参数。当然这个功能比较偏门,我没有专门写 demo 去验证。
下载
本文所有测试用例都是基于获取并打开 qtl::sqlite::database 对象的基础,那么这个对象又是如何打开的呢,请看下面框架:
代码语言:javascript复制 1 int main(int argc, char* argv[])
2 {
3 int ret = 0;
4 srand(time(0));
5 uint64_t rowid = 0;
6 qtl::sqlite::database db(SQLITE_TIMEOUT);
7
8 try
9 {
10 // copy of gcm.db, and create following table:
11 // create table popmsg (msgid text not null, msgtype integer not null, cid text not null, uid text not null,
12 // status integer not null, count integer not null, msgbody text not null, stamp timestamp not null,
13 // primary key (msgid, msgtype, cid, uid));
14 db.open("../data/gcm.db", NULL);
15 printf("open db OKn");
16
17 #if 0
18 rowid = test_insert_single(db);
19 #endif
20
21 #if 0
22 test_update_single(db, rowid);
23 #endif
24
25 #if 0
26 test_insert_multi(db);
27 #endif
28
29 #if 0
30 test_update_multi(db);
31 #endif
32
33 #if 0
34 test_delete(db);
35 #endif
36
37 #if 0
38 test_query_single(db, rowid);
39 #endif
40
41 #if 0
42 test_query_single_ex(db, rowid);
43 #endif
44
45 #if 0
46 test_query_multi(db);
47 #endif
48
49 #if 0
50 test_query_multi_ex(db);
51 #endif
52
53 #if 0
54 test_query_multi_ul(db);
55 #endif
56
57 //test_query_multi_custom(db);
58
59 db.close();
60 }
61 catch (qtl::sqlite::error &e)
62 {
63 printf("manipute db error %d: %sn", e.code(), e.what());
64 db.close();
65 return -1;
66 }
67
68 return 0;
69 }
可以看到数据库的打开、关闭过程。因为 qtl 检测到底层数据库错误时,是通过抛出异常的方式来向上层报告的,所以所有用例都包含在 try_catch 结构中。可以通过编译开关来打开各个用例,多个用例之间可以组合起来使用,例如同时打开 test_insert_single 和 test_query_single 两个用例。所有相关的内容,包括 qtl、sqlite 头文件;sqlite lib 与 dll 和 so;sqlite 样例数据 db 文件;甚至编译好的可执行文件(Win10 x64 与 Linux x64),我都打包上传到博客园了,可以点击 这里下载。
qtl 库最新版本不包含在里面 ,可以从这里获取:https://github.com/goodpaperman/qtl
结语
本文并不是 qtl 的使用指南,qtl 的许多内容(事务、语句对象、blob 类型、异步IO、indicator)都没有介绍。这里只是使用 qtl 这个典型的 c 11 库、以及数据库的“增删改查”四大操作、来说明新技术是如何"颠覆"用户调用接口的,以及在一些特定场景下(例如 query_first 既要不定输入参数,也要不定输出参数), c 新特性是否有可能去满足这种需求。从这里也能看出,c 的新需求新特性并不是凭空衍生的,而是从类似 qtl 这种模板库的实际需要产生的(如何写出用户调用更方便的接口),如果我们离开这些场景去学 c 新特性,会感到知识点纷繁复杂,而例子又全然不贴切,完全感觉不到新特性解决的痛点。当然 qtl 也不是尽善尽美,例如在使用回调函数处理输出数据的情况下,能不能给输入数据来个“不限量”参数列表?qtl 没有这样做是 c 不支持,还是 qtl 懒没有做到这一步,这就暂时不得而知了。