Cocos2d-x中创建SQLite数据库
创建数据库一般须要经过例如以下三个步骤。
(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实战 C++卷》现已上线,各大商店均已开售:
京东:http://item.jd.com/11584534.html
当当: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