Cocos2d-x数据持久化中的数据查询之一个很重要的环节,所以对于这方面的知识,我们要了解的也就更多,现在我们就来看一下Cocos2d-x数据持久化之数据查询

数据查询一般会带有查询条件,这可以使用SQL语句的where子句实现,但是在程序中需要动态绑定参数给where子句。查询数据的具体操作步骤如下所示。

(1) 使用sqlite3_open函数打开数据库。
(2) 使用sqlite3_prepare_v2函数预处理SQL语句。
(3) 使用sqlite3_bind_text函数绑定参数。
(4) 使用sqlite3_step函数执行SQL语句,遍历结果集。
(5) 使用sqlite3_column_text等函数提取字段数据。

(6) 使用sqlite3_finalize和sqlite3_close函数释放资源。

NoteDAO.cpp中的NoteDAO::findById是按照主键查询数据函数,相关代码如下:
  1. ValueMap NoteDAO::findById(string pDate)
  2. {
  3. //初始化数据库
  4. initDB();
  5. sqlite3* db= NULL;
  6. ValueMap dict ;
  7. string path = dbDirectoryFile();
  8. if (sqlite3_open(path.c_str(), &db) != SQLITE_OK) {                  ①
  9. sqlite3_close(db);
  10. CCASSERT(false, "DB open failure.");
  11. } else {
  12. string qsql = "SELECT cdate,content FROM Note where cdate =?";
  13. sqlite3_stmt *statement;
  14. //预处理过程
  15. if (sqlite3_prepare_v2(db, qsql.c_str(), -1, &statement, NULL) == SQLITE_OK) {                                                                                               ②
  16. //绑定参数开始
  17. sqlite3_bind_text(statement, 1, pDate.c_str(), -1, NULL);            
  18. //执行
  19. if (sqlite3_step(statement) == SQLITE_ROW) {                          
  20. char *cdate = (char *)sqlite3_column_text(statement, 0);             ⑤
  21. char *content = (char *)sqlite3_column_text(statement, 1);
  22. dict["date"] = Value(cdate);
  23. dict["content"] = Value(content);
  24. }
  25. }
  26. sqlite3_finalize(statement);                                                          
  27. sqlite3_close(db);                                                                      
  28. }
  29. return dict;
  30. }

该函数执行了6个步骤,

其中第(1)个步骤如代码第行所示,它与创建数据库的第一个步骤一样,这里就不再介绍了。

第(2)个步骤如代码第行所示,语句sqlite3_prepare_v2(db, qsql.c_str(), -1, &statement, NULL)是预处理SQL语句。预处理的目的是将SQL编译成二进制代码,提高SQL语句的执行速度。sqlite3_prepare_v2函数的第三个参数表示SQL字符串的长度,-1表示全部SQL字符串。第四个参数是sqlite3_stmt指针的地址,它是语句对象,通过语句对象可以执行SQL语句,第五个参数是SQL语句没有执行的部分语句。

第(3)个步骤如代码第行所示,语句sqlite3_bind_text(statement, 1, pDate.c_str(), -1, NULL)是绑定SQL语句的参数,其中第一个参数是statement指针,第二个参数为序号(从1开始),第三个参数为字符串值,第四个参数为字符串长度,第五个参数为一个函数指针。如果SQL语句中带有问号,则这个问号(它是占位符)就是要绑定的参数,示例代码如下所示:

string qsql = "SELECT cdate,content FROM Note where cdate =?";

第(4)个步骤为使用sqlite3_step(statement)执行SQL语句,如代码第行所示。如果sqlite3_step函数返回int类型(即等于SQLITE_ROW),则说明还要其它行数据没有遍历。

第(5)个步骤为提取字段数据,如代码第行所示,它使用sqlite3_column_text(statement, 0)函数读取字符串类型的字段。需要说明的是,sqlite3_column_text函数的第二个参数用于指定select字段的索引(从0开始)。读取字段函数的选择与字段类型有关系,SQLite3中类似的常用函数还有:

sqlite3_column_blob()
sqlite3_column_double()
sqlite3_column_int()
sqlite3_column_int64()
sqlite3_column_text()

sqlite3_column_text16()

关于其它API,读者可以参考http://www.sqlite.org/cintro.html。

第(6)个步骤是释放资源,与创建数据库过程不同。使用sqlite3_close函数关闭数据库(见第行)之前,还要使用sqlite3_finalize函数释放语句对象statement,见代码第行所示。

NoteDAO.cpp中的NoteDAO::findAll()是查询所有数据函数,相关代码如下:
  1. ValueVector NoteDAO::findAll()
  2. {
  3. //初始化数据库
  4. initDB();
  5. sqlite3* db= NULL;
  6. string path = dbDirectoryFile();
  7. ValueVector listData;
  8. if (sqlite3_open(path.c_str(), &db) != SQLITE_OK) {
  9. sqlite3_close(db);
  10. CCASSERT(false, "DB open failure.");
  11. } else {
  12. string qsql = "SELECT cdate,content FROM Note";
  13. sqlite3_stmt *statement;
  14. //预处理过程
  15. if (sqlite3_prepare_v2(db, qsql.c_str(), -1, &statement, NULL) == SQLITE_OK) {
  16. //执行
  17. while (sqlite3_step(statement) == SQLITE_ROW) {
  18. char *cdate = (char *)sqlite3_column_text(statement, 0);
  19. char *content = (char *)sqlite3_column_text(statement, 1);
  20. ValueMap dict ;
  21. dict["date"] = Value(cdate);
  22. dict["content"] = Value(content);
  23. listData.push_back(Value(dict));
  24. }
  25. }
  26. sqlite3_finalize(statement);
  27. sqlite3_close(db);
  28. }
  29. return listData;
  30. }
查询所有数据函数与按照主键查询数据函数类似,区别在于本函数没有查询条件不需要绑定参数。遍历的时候使用while循环语句,不是if语句:

  1. while (sqlite3_step(statement) == SQLITE_ROW)
  2.  {
  3. ……
  4. }

为了能够调用NoteDAO中查询函数findAll (),我们需要在HelloWorldScene场景中调用。HelloWorldScene.cpp主要代码如下:

  1. void HelloWorld::OnClickMenu5(Ref* pSender)
  2. {
  3. auto arry = NoteDAO::findAll();                    
  4. for (auto& v: arry)
  5. {
  6. log("-----------------");
  7. ValueMap row = v.asValueMap();                     
  8. string date = row["date"].asString();                
  9. string content = row["content"].asString();      
  10. log("===>date: : %s", date.c_str());
  11. log("===>content: : %s", content.c_str());
  12. }
  13. }
HelloWorld::OnClickMenu5函数是玩家点击Read Data菜单时候回调的函数。其中代码第行是调用NoteDAO中查询所有函数findAll (),第行代码是把从列表中取出的元素v,转换为ValueMap字典类型。第行代码是从字典中取值date数据。第行代码是从字典中取值content数据。