Cocos2d-x中创建SQLite数据库
浏览数：19 /
时间：2015年06月12日
我们下边介绍如何通过SQLite3提供的API实现MyNotes数据库创建。创建数据库一般需要经过如下三个步骤。
(1) 使用sqlite3_open函数打开数据库。
(2) 使用sqlite3_exec函数执行Create Table语句，创建数据库表。
(3) 使用sqlite3_close函数释放资源。
在这个过程中，我们使用了三个SQLite3 API函数，它们都是纯C语言函数。在Cocos2d-x中通过C++调用C函数当然不是什么问题，NoteDAO.cpp中的NoteDAO::initDB()函数可以初始化数据库，它的相关代码如下：
上述代码initDB()函数是初始化数据库函数，通过这个函数创建数据库中的表等对象，每次对数据库进行CRUD操作时候都会调用它。这个函数中处理流程是先判断数据库文件NotesList.sqlite3是否存在，如果不存在就是初始化，如果已经存在则跳出该函数。其中代码第①行调用dbDirectoryFile()函数，该函数是我们自己封装的函数，用来获得可写入目录中数据库文件NotesList.sqlite3全路径。第②行代码是判断可写入目录中数据库文件NotesList.sqlite3是否存在，如果不存在程序跳出该函数。
第③行的代码是创建数据库，其中sqlite3_open函数的第一个参数是数据库文件的完整路径，需要注意的是在SQLite3函数中接受的是const char*类型数据，需要将string类型数据使用c_str()函数转换为const char*类型；第二个参数为sqlite3指针变量db的地址；返回值是int类型。在SQLite3中，我们定义了很多常量，如果返回值等于常量SQLITE_OK，则说明创建成功。如果打开数据库失败，我们需要使用第④行代码sqlite3_close(db)关闭数据库释放资源，类似的还有第⑧行和第⑩行代码。第⑤行代码使用CCASSERT断言宏，断言宏是判断第一个参数false情况下抛出异常，终止程序运行，并且输出把第二个参数作为日志内容输出。
第⑥行代码是编写建表SQL语句，代码如下：
CREATE TABLE IF NOT EXISTS Note (cdate TEXT PRIMARY KEY, content TEXT)
建表语句CREATE TABLE IF NOT EXISTS可以判断表是否存在，不存在则创建，存在则不创建。如果使用建表语句CREATE TABLE，在表存在的情况下，这会导致数据抛出异常。类似的还有第⑨行代码。
第⑦行代码是执行建表语句，其中语句sqlite3_exec(db,createSQL.c_str(),NULL,NULL,&err)执行第⑥行的建表SQL语句，sqlite3_exec函数的第一个参数是sqlite3指针变量db的地址，第二个参数是要执行的SQL语句，第三个参数是要回调的函数，第四个参数是要回调函数的参数，第五个参数是执行出错的错误信息。
为了能够调用NoteDAO中的初始化数据库函数initDB()，我们需要在HelloWorldScene场景中调用。HelloWorldScene.cpp主要代码如下：
(1) 使用sqlite3_open函数打开数据库。
(2) 使用sqlite3_exec函数执行Create Table语句，创建数据库表。
(3) 使用sqlite3_close函数释放资源。
在这个过程中，我们使用了三个SQLite3 API函数，它们都是纯C语言函数。在Cocos2d-x中通过C++调用C函数当然不是什么问题，NoteDAO.cpp中的NoteDAO::initDB()函数可以初始化数据库，它的相关代码如下：
int NoteDAO::initDB()
{
auto sharedFileUtils = FileUtils::getInstance();
string path = dbDirectoryFile(); ①
bool isExist = false;
isExist = sharedFileUtils->isFileExist(path); ②
if (!isExist) {
log("NotesList.sqlite3 doesn‘t exist.");
return -1;
}
sqlite3* db= NULL;
if (sqlite3_open(path.c_str(), &db) != SQLITE_OK) { ③
sqlite3_close(db); ④
CCASSERT(false, "DB open failure."); ⑤
} else {
char *err;
string createSQL = "CREATE TABLE IF NOT EXISTS
Note (cdate TEXT PRIMARY KEY, content TEXT)"; ⑥
if (sqlite3_exec(db,createSQL.c_str(),NULL,NULL,&err) != SQLITE_OK) { ⑦
sqlite3_close(db); ⑧
CCASSERT(false, "Create table failure."); ⑨
}
sqlite3_close(db); ⑩
}
return 0;
}上述代码initDB()函数是初始化数据库函数，通过这个函数创建数据库中的表等对象，每次对数据库进行CRUD操作时候都会调用它。这个函数中处理流程是先判断数据库文件NotesList.sqlite3是否存在，如果不存在就是初始化，如果已经存在则跳出该函数。其中代码第①行调用dbDirectoryFile()函数，该函数是我们自己封装的函数，用来获得可写入目录中数据库文件NotesList.sqlite3全路径。第②行代码是判断可写入目录中数据库文件NotesList.sqlite3是否存在，如果不存在程序跳出该函数。
第③行的代码是创建数据库，其中sqlite3_open函数的第一个参数是数据库文件的完整路径，需要注意的是在SQLite3函数中接受的是const char*类型数据，需要将string类型数据使用c_str()函数转换为const char*类型；第二个参数为sqlite3指针变量db的地址；返回值是int类型。在SQLite3中，我们定义了很多常量，如果返回值等于常量SQLITE_OK，则说明创建成功。如果打开数据库失败，我们需要使用第④行代码sqlite3_close(db)关闭数据库释放资源，类似的还有第⑧行和第⑩行代码。第⑤行代码使用CCASSERT断言宏，断言宏是判断第一个参数false情况下抛出异常，终止程序运行，并且输出把第二个参数作为日志内容输出。
第⑥行代码是编写建表SQL语句，代码如下：
CREATE TABLE IF NOT EXISTS Note (cdate TEXT PRIMARY KEY, content TEXT)
建表语句CREATE TABLE IF NOT EXISTS可以判断表是否存在，不存在则创建，存在则不创建。如果使用建表语句CREATE TABLE，在表存在的情况下，这会导致数据抛出异常。类似的还有第⑨行代码。
第⑦行代码是执行建表语句，其中语句sqlite3_exec(db,createSQL.c_str(),NULL,NULL,&err)执行第⑥行的建表SQL语句，sqlite3_exec函数的第一个参数是sqlite3指针变量db的地址，第二个参数是要执行的SQL语句，第三个参数是要回调的函数，第四个参数是要回调函数的参数，第五个参数是执行出错的错误信息。
为了能够调用NoteDAO中的初始化数据库函数initDB()，我们需要在HelloWorldScene场景中调用。HelloWorldScene.cpp主要代码如下：
void HelloWorld::OnClickMenu1(cocos2d::Ref* pSender)
{
NoteDAO::initDB();
NoteDAO::create("2008-08-16 10:01:02", "初始化数据.");
}HelloWorld::OnClickMenu1函数是玩家点击Init DB菜单时候回调的函数，在该函数中通过NoteDAO::initDB()语句实现数据库的初始化。NoteDAO中initDB()函数是静态函数，需要实例化NoteDAO就可以直接调用。下面的NoteDAO::create("2008-08-16 10:01:02", "初始化数据.")语句是调用NoteDAO中的create函数在Note表中插入一条数据。
更多内容请关注国内第一本Cocos2d-x 3.2版本图书《Cocos2d-x实战：C++卷》
欢迎加入Cocos2d-x技术讨论群：257760386
欢迎关注智捷iOS课堂微信公共平台
郑重声明：本站内容如果来自互联网及其他传播媒体，其版权均属原媒体及文章作者所有。转载目的在于传递更多信息及用于网络分享，并不代表本站赞同其观点和对其真实性负责，也不构成任何其他建议。
