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;
}

该函数执行了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()是查询所有数据函数，相关代码如下：
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数据。

更多内容请关注最新Cocos图书《Cocos2d-x实战 C++卷》 ‍

本书交流讨论网站： http://www.cocoagame.net

更多精彩视频课程请关注智捷课堂Cocos课程： http://v.51work6.com

欢迎加入Cocos2d-x技术讨论群：257760386

‍

《Cocos2d-x实战 C++卷》现已上线，各大商店均已开售：‍

京东：http://item.jd.com/11584534.html

亚马逊：http://www.amazon.cn/Cocos2d-x%E5%AE%9E%E6%88%98-C-%E5%8D%B7-%E5%85%B3%E4%B8%9C%E5%8D%87/dp/B00PTYWTLU

当当：http://product.dangdang.com/23606265.html

互动出版网：http://product.china-pub.com/3770734‍

《Cocos2d-x实战 C++卷》源码及样章下载地址：

源码下载地址：http://51work6.com/forum.php?mod=viewthread&tid=1155&extra=page%3D1 

样章下载地址：http://51work6.com/forum.php?mod=viewthread&tid=1157&extra=page%3D1 ‍

欢迎关注智捷iOS课堂微信公共平台