【唠叨】
在Cocos2d-x中,简单数据存储,可以使用UserDefault。那么如何存储大量,不规则的数据?我们可以使用 sqlite数据库 存储数据。sqlite 是使用非常广泛的嵌入式数据库,它有小巧 、高效、跨平台、开源免费和易操作的特点。所以大量的被用于手机、PDA、MP3播放器、以及机顶盒设备。
sqlite数据库是使用C语言来编写的,因此在Cocos2d-x使用sqlite也是得心应手。
PS:另外对于sqlite的可视化管理工具,本人使用的是 sqliteStudio,这个就自行了解吧。
【参考】
http://cn.cocos2d-x.org/tutorial/show?id=1351 (【官方文档】sqlite集成与用法)
http://blog.chinaunix.net/uid-8447633-id-3321394.html (sqlite3使用总结)
【Demo下载】
【sqlite3】
1、准备工作
Cocos引擎的external文件夹里的sqlite3好像只有两个 .h 文件,没有 sqlite3.c文件。所以我编译的时候一直编译不通过。后来去sqlite官网下了源文件,才编译成功的。
下载地址:http://www.sqlite.org/download.html
(2)将sqlite3的三个源文件拷贝到项目的Classes文件中,并导入到项目里。
如果是Android平台的话,还需要修改 Android.mk 文件。
2、sqlite3的基础API
这里只介绍一下sqlite3最基本的API,可以帮助你完成数据库的 增删改查 功能。
注意:sqlite3 数据库使用的编码格式为:UTF-8 。如果出现乱码的话,就将其转为 UTF-8 格式。
2.1、关键数据结构:sqlite3*
从数据库打开开始,sqlite就要为这个类型准备好内存,直到数据库关闭,整个过程都需要用到这个类型。当数据库打开时开始,这个类型的变量就代表了你要操作的数据库。下面再详细介绍。
int sqlite3_open(const char *filename,sqlite3 **ppDb)
(1)filename : 数据库文件名(如:"/Users/apple/Documents/data.db" )。文件名不需要一定存在,如果此文件不存在,sqlite 会自动建立它。如果它存在,就尝试把它当数据库文件来打开。
(2)ppDb : 即前面提到的关键数据结构。这个结构底层细节如何,你不要关它。
(3)返回值: 如果为 sqlITE_OK ,则成功打开数据库。
这个函数是用来关闭数据库的。若不再使用数据库时,必须将数据库关闭,释放内存资源。
(1)sqlite3* : 即前面提到的关键数据结构。
int sqlite3_exec(sqlite3*,const char *sql,int (*callback)(void*,int,char**,char**),void*,char **errmsg)
(1)sqlite3* : 即前面提到的关键数据结构。
(3)(*callback) : 执行exec时,每查到一条记录,就会调用这个回调函数(具体在 2.5介绍)。
(4)void* : 传递数据,可以是任意值。会传递到回调函数callback,作为它的第一个参数传入。
(5)errmsg : 错误信息。
注意:后面三个参数,若不需要,可以填 NULL 。
int (*sqlite3_callback)(void* para,int col_num,char** col_value,char** col_name)
这个函数作为 sqlite3_exec 的第三个参数。执行exec时,每查询到一条记录,就会调用一次。
(1)para : 即 exec 的第四个参数,传递来的数据。
(2)col_num : 一条记录有多少个字段(即这条记录的列数)。
(3)col_value : 查询出来的数据(即:每个字段的值 )。它是个一维数组(不要以为是2维数组),每个元素都是一个字符串 char * 值,是一个字段内容。
(4)col_name : 每一个字段的字段名称(即:列名),与 col_value 对应。
2.6、不使用回调查询数据库:sqlite3_get_table
sqlite3_get_table(sqlite3 *db,char ***result,int *row,int *col,char **errmsg)
(1)db : 即前面提到的关键数据结构。
(3)result : 查询结果。它依然一维数组(不要以为是二维数组,更不要以为是三维数组)。它内存布局是:第一行是字段名称,后面是紧接着是每个字段的值。即:0~col-1是字段名称,col~2*col-1是第一行记录,2*col~3*col-1是第二行记录,……以此类推。
(4)row : 行数。
(5)col : 列数。
(6)errmsg : 错误信息。
注意:这个函数的 result 访问完后,需要使用sqlite3_free_table(retult),释放资源。
3、使用方法
3.1、引入头文件
添加从sqlite官网下载的源代码 sqlite3.h 头文件。
// #include"sqlite3.h" //
3.2、创建数据库
创建数据库,若文件不存在,sqlite会自动建立。若文件存在,就尝试把它当数据库文件来打开。
// //数据库路径 std::stringpath="/soft/cocos2d-x-3.4/projects/Demo34/Resources/data.db"; std::stringsql;//sql语句 intret;//执行结果,sqlITE_OK表示成功执行 //创建sqlite数据库:sqlite3* sqlite3*pdb=nullptr; //打开sqlite数据库:sqlite3_open ret=sqlite3_open(path.c_str(),&pdb); //当sqllite数据库打开失败时 if(ret!=sqlITE_OK){ //获得sqltite数据库打开错误的信息 constchar*errmsg=sqlite3_errmsg(pdb); CCLOG("sqliteopenerror:%s",errmsg); sqlite3_close(pdb); returnfalse; } //
3.3、创建表
创建一张表:create table 表名(ID,name,sex)
表名:student 。 有三个字段:ID、name、sex (其中ID为主键自增)。
PS:创建表,不需要回调函数。sqlite3_exec 的后面三个参数都填 NULL 。
// //创建表的sql语句:createtable sql="createtablestudent(IDintegerprimarykeyautoincrement,nametext,sextext)"; //执行sql语句:sqlite3_exec ret=sqlite3_exec(pdb,sql.c_str(),nullptr,nullptr); if(ret!=sqlITE_OK){ CCLOG("createtableFailed"); } //
3.4、插入数据(增)
插入三条数据:insert into 表名 value(1,"name","sex")
PS:插入数据,不需要回调函数。sqlite3_exec 的后面三个参数都填 NULL 。
// //(1,'student1','male') sql="insertintostudentvalues(1,'male')"; ret=sqlite3_exec(pdb,nullptr); if(ret!=sqlITE_OK){ CCLOG("insertdataFailed!"); } //(2,'student3','female') sql="insertintostudentvalues(2,'student2','female')"; ret=sqlite3_exec(pdb,nullptr); if(ret!=sqlITE_OK){ CCLOG("insertdataFailed!"); } //(3,'male') sql="insertintostudentvalues(3,nullptr); if(ret!=sqlITE_OK){ CCLOG("insertdataFailed!"); } //
使用 sqlite3_exec 来查询:select * from 表名
// //查询语句 sql="select*fromstudent"; ret=sqlite3_exec(pdb,&callback,(void*)"para",nullptr); //回调函数 intcallback(void*para,intcol_num,char**col_value,char**col_name) { CCLOG("%s:总共有%d个字段",(char*)para,col_num); for(inti=0;i<col_num;i++){ CCLOG("%s=%s",col_name[i],col_value[i]); } CCLOG("------------------------------");//分隔符 return0; } //
控制台输出结果:
3.6、删除数据(删)
删除第一条记录:delete from 表名 where 条件
// //删除第一条记录 sql="deletefromstudentwhereID=1"; ret=sqlite3_exec(pdb,nullptr); if(ret!=sqlITE_OK){ CCLOG("deletedataFailed!"); } //
3.7、修改数据(改)
修改数据:update 表名 set name = "hello" where 条件
// //修改第三条记录的name字段 sql="updatestudentsetname='hello'whereID=3"; ret=sqlite3_exec(pdb,nullptr); if(ret!=sqlITE_OK){ CCLOG("updatedataFailed!"); } //
3.8、查询数据,使用sqlite3_get_table(查)
使用sqlite3_get_table 来查询:select * from 表名
// char**table;//查询结果 intr,c;//行数、列数 sql="select*fromstudent"; sqlite3_get_table(pdb,&table,&r,&c,nullptr); CCLOG("行数is%d,列数is%d",r,c); //第0行(0~c-1),为字段名 //第1行(c~2*c-1),第一条记录 //...... for(inti=0;i<=r;i++){ for(intj=0;j<c;j++){ CCLOG("%s",table[i*c+j]); } CCLOG("------------------------------"); } //记得是否查询表 sqlite3_free_table(table); //
控制台输出结果:
可以看到 ID = 1 的数据已经被删除了,并且ID = 3 的数据name被改为了 " hello " 。
// sqlite3_close(pdb); //原文链接:https://www.f2er.com/cocos2dx/344331.html