Cocos2d-x数据持久化之数据查询

在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函数用于按照主键查询数据，相关代码如下：

ValueMap NoteDAO::findById(string pDate)
{
// 初始化数据库
initDB();
sqlite3* db = NULL;
ValueMap dict;
string path = dbDirectoryFile();

if (sqlite3_open(path.c_str(), &db) != SQLITE_OK) {
sqlite3_close(db);
CCASSERT(false, "DB open failure.");
} else {
string qsql = "SELECT cdate,content FROM Note where cdate =?";
sqlite3_stmt *statement;

// 预处理过程
if (sqlite3_prepare_v2(db, qsql.c_str(), -1, &statement, NULL) == SQLITE_OK) {
// 绑定参数开始
sqlite3_bind_text(statement, 1, pDate.c_str(), -1, NULL);

// 执行
if (sqlite3_step(statement) == SQLITE_ROW) {
char *cdate = (char *)sqlite3_column_text(statement, 0);
char *content = (char *)sqlite3_column_text(statement, 1);
dict["date"] = Value(cdate);
dict["content"] = Value(content);
}
}
sqlite3_finalize(statement);
sqlite3_close(db);
}
return dict;
}

代码详细解释

• 步骤1：打开数据库：代码中的第①行，使用sqlite3_open函数打开数据库，这与创建数据库的第一个步骤相同，此处不再赘述。
• 步骤2：预处理SQL语句：代码第②行的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：执行SQL语句：代码第④行使用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()函数用于查询所有数据，相关代码如下：

ValueVector NoteDAO::findAll()
{
// 初始化数据库
initDB();
sqlite3* db = NULL;
string path = dbDirectoryFile();
ValueVector listData;

if (sqlite3_open(path.c_str(), &db) != SQLITE_OK) {
sqlite3_close(db);
CCASSERT(false, "DB open failure.");
} else {
string qsql = "SELECT cdate,content FROM Note";
sqlite3_stmt *statement;

// 预处理过程
if (sqlite3_prepare_v2(db, qsql.c_str(), -1, &statement, NULL) == SQLITE_OK) {
// 执行
while (sqlite3_step(statement) == SQLITE_ROW) {
char *cdate = (char *)sqlite3_column_text(statement, 0);
char *content = (char *)sqlite3_column_text(statement, 1);
ValueMap dict;
dict["date"] = Value(cdate);
dict["content"] = Value(content);
listData.push_back(Value(dict));
}
}
sqlite3_finalize(statement);
sqlite3_close(db);
}
return listData;
}

与按主键查询的区别

查询所有数据函数与按照主键查询数据函数类似，区别在于本函数没有查询条件，因此不需要绑定参数。在遍历结果集时，使用while循环语句，而不是if语句：

while (sqlite3_step(statement) == SQLITE_ROW)
{
// ...
}

在场景中调用查询函数

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

void HelloWorld::OnClickMenu5(Ref* pSender)
{
auto arry = NoteDAO::findAll();
for (auto& v : arry)
{
log("-----------------");
ValueMap row = v.asValueMap();
string date = row["date"].asString();
string content = row["content"].asString();
log("===>date: : %s", date.c_str());
log("===>content: : %s", content.c_str());
}
}

代码解释

HelloWorld::OnClickMenu5函数是玩家点击Read Data菜单时回调的函数。其中，代码第①行调用NoteDAO中的查询所有函数findAll()；第②行代码将从列表中取出的元素v转换为ValueMap字典类型；第③行代码从字典中获取date数据；第④行代码从字典中获取content数据。