c++ 11 是如何简化你的数据库访问接口的

之前写过一篇文章专门分析了 c++ 模板编译过程中报的一个错误：《fatal error C1045: 编译器限制 : 链接规范嵌套太深》，其中涉及到了 qtl —— 一个使用 c++ 11 构建的数据库访问库，当时限于篇幅，没有深入研究它是如何借助 c++ 11 来简化数据库访问接口的，本文现在就来探讨一下这方面的内容。

没有 c++ 11 之前，苦逼的程序员对于 sql 操作的输入输出，只好一行行敲代码，例如在调用数据库接口前设置绑定参数；在调用成功后，循环遍历查询的记录。很多时候数据库表对应在程序中就是一个结构体，程序员需要花费大量的精力将数据库表字段对应到结构体成员上、或反之，完全没有体现出来程序员应有的价值。而 qtl 这种 c++ 11 库的出现，可以极大的简化上面的程序编写，下面还是用之前文章中提到的例子作为演示，让大家感受一下：

插入单条数据

 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 %d\n", tmp, (int)id); 
 9     return id; 
10 }

插入操作需要输入数据，将数据编入 sql 是一种思路，但更好的方法是使用占位符 (?) 和数据绑定 (binding) 来防止 sql 注入问题，而这会给接口带来不定数量的输入参数，幸好 c++ 11 的可变模板参数特性允许用户提供不限数量与类型的输入数据，是不是很方便？下面是 qtl 提供的插入单条数据接口：

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 返回，方便后续操作这条记录。

更新单条数据

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 records\n", (int)rowid, (int)affected);
7 }

更新操作和插入操作类似，输入数据是必不可少的，但它有时也需要更新符合条件的记录，而这会带来另一坨不定数量的输入参数，不过好在二者都是输入参数，可以合二为一使用一个维度的可变模板参数，依次将更新参数与条件参数罗列在 qtl 接口提供的参数列表中即可：

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，如果这个参数为空，则不返回。

插入多条数据

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 record\n", (int)affected); 
}

插入多条数据时，可变模板参数列表的每一个参数表示一个输入绑定参数、针对一条新记录，这样一来就不太够用了。例如上面这个例子中，相当于插入了三条不同的 popbox_msg 记录，每个输入参数对应记录的 msgid 字段，如果一条记录有多个字段需要输入就不适用了，那种场景下就需要写个循环多次调用插入单条数据的操作了（其实插入多条的接口底层也是递归为插入单条来执行的，所以这样做性能没有太大损失）。

更新多条数据

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 record\n", (int)affected);
9 }

其实和插入多条数据非常相似，每条记录只能允许一个输入绑定参数。

删除数据

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 rows\n", (int)affected);
6 }

删除数据时由于只需要提供删除条件的输入绑定参数，而实际结果可能删除一条、也可能删除多条，所以不在数量上做区分。这里使用的是和更新数据一样的接口：execute 和 execute_direct，同样的，前者只能允许一个输入绑定参数，适合较简单的 sql 语句；后者可以允许多个输入绑定参数，适合较复杂的 sql。最后，删除的行数由 affected 参数返回给调用者。

查询单条数据

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: %s\n", (int)rowid, msg.c_str());
6 }

查询单条数据时可以直接将查询到的数据以输出参数方式回传，而查询条件往往又需要输入绑定参数，那 qtl 是如何区分可变模板参数列表中哪些是入参、哪些是出参呢？答案是区分不了。因此在接口设计上，qtl 的查询单条数据接口最多允许一个入参：

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

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 语句中，这十分不优雅，但没有办法。下面是使用的例子：

 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 %d\n", (int)rowid, status, count, (int)stamp);
10 }

从这个实际例子看，以后 c++ 可变模板参数列表可能需要支持两个参数列，一列是输入参数，一列是输出参数了。但是转念一想，这样好像也不对，因为出参与入参在调用点并无任何区别，编译器如何知道哪个是出参哪个是入参呢？所以这个问题可能还真是无解了。

查询多条数据

 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, %d\n", status, count, (int)stamp); 
 7         cnt++; 
 8     }); 
 9 
10     printf("query %d records\n", cnt); 
11 }

因为可能返回多条数据，这里使用回调函数（一般为 lambda 表达式）来接收读取的记录。回调函数参数列表必需与 select 选择的数据库表列相匹配。

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，请看下面这段代码：

 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, %d\n", 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 records\n", cnt); 
11 }

我增加了从数据库表中选取的字段，并相应的增加了 lambda 表达式的参数列表，当数量达到一个阈值时（亲测为8），VS2013 编译器将报错退出：

e:\code\qtl\include\qtl\apply_tuple.h(17): fatal error C1045: 编译器限制 : 链接规范嵌套太深

具体分析请参考我的另一篇文章：《fatal error C1045: 编译器限制 : 链接规范嵌套太深》。这里我着重想说明的是，使用这种方式传递的字段在某些编译器上是有上限的，所以可移植性不太好。相信聪明的你已经猜到了，由于 query_first_direct 使用了和 query 相同的底层机制，query_first_direct 在 VS2013 上也存在相同的问题。幸好 qtl 还有另外一种方法，可以解决上面的问题，这就是结构体成员绑定：

 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, %04d-%02d-%02d %02d:%02d:%02d, %s\n",
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 records\n", cnt);
64 }

同样是 query 接口，同样是 lambda 表达式作为回调函数，不同的是，我提前声明了一个结构体 popbox_msg_t，并提供了 qtl::bind_record 模板函数的一个特化、来将数据库表的列与结构体成员二者关联起来，这样我的 lambda 表达式只要接收结构体就够了，qtl 在底层会自动根据 bind_record 将读取的数据初始化到结构体中供我们使用。因为这种方式避免了罗列各个输出参数，所以可以很好的避免上述问题。另外关于 bind_record 补充一点，最新版本的 qtl 可以在 bind_record 模板特化中使用一个 bind_fields 来指定所有成员的对应关系了（我使用的旧版没有这个接口），类似于这样：

qtl::bind_fields(command, v.msgid, v.msgtype, v.appname, v.uid, v.status, v.count, v.msgbody, v.stamp);

是不是更简单了呢？有了结构体绑定，还可以玩出许多花样，例如直接用结构体的成员函数来代替 lambda 表达式：

 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, %04d-%02d-%02d %02d:%02d:%02d, %s\n",
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 records\n", cnt);
67 }

代码高亮的部分就是两个版本的差异，这里使用了 popbox_msg_t 的一个成员函数 print 来充当 lambda 表达式的作用，这样做可以将代码集中到结构体中进行维护。不过缺点也是明显的，就是不能自由的选取外部输入参数了，例如对遍历记录数的统计，在新版本中就没办法做到了。除了上面的方式，还有一种新花样：

 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 records\n", cnt);
11 }

这种方式已经脱离了 query 接口，使用的是 result 接口，虽然壳变了，但是底层机制和 query 是一致的，都是通过 bind_record 将查询到的数据填充到结构体中，下面是 result 的接口定义：

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 最新版本中包含了关于这方面的解决方案，那就是自定义绑定，请看下面这个例子：

 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, %d\n", pm.status, pm.count, pm.stamp); 
16         cnt++; 
17     });
18 
19     printf("query %d records\n", 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 语句的顺序来接收对应的查询结果了：

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 对象的基础，那么这个对象又是如何打开的呢，请看下面框架：

 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 OK\n");
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: %s\n", 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 懒没有做到这一步，这就暂时不得而知了。

posted @ 2021-03-10 09:13 goodcitizen 阅读(1074) 评论(1) 编辑收藏举报

刷新页面返回顶部