Cocos数据篇[3.4](6) ――SQLite3数据库基础用法
|
【唠叨】 在Cocos2d-x中，简单数据存储，可以使用UserDefault。那么如何存储大量，不规则的数据？我们可以使用 SQLite数据库 存储数据。SQLite 是使用非常广泛的嵌入式数据库，它有小巧 、高效、跨平台、开源免费和易操作的特点。所以大量的被用于手机、PDA、MP3播放器、以及机顶盒设备。 SQLite数据库是使用C语言来编写的，因此在Cocos2d-x使用SQLite也是得心应手。 本文介绍一下SQLite3数据库的基础用法：增删改查。 PS：另外对于SQLite的可视化管理工具，本人使用的是 SQLiteStudio，这个就自行了解吧。 【参考】 http://cn.cocos2d-x.org/tutorial/show?id=1351 （【官方文档】SQLite集成与用法） http://blog.chinaunix.net/uid-8447633-id-3321394.html （SQLite3使用总结） 【Demo下载】 https://github.com/shahdza/Cocos_LearningTest/tree/master/Sqlite3%E5%9F%BA%E7%A1%80%E7%94%A8%E6%B3%95 【SQLite3】 1、准备工作 Cocos引擎的external文件夹里的sqlite3好像只有两个 .h 文件，没有 sqlite3.c文件。所以我编译的时候一直编译不通过。后来去sqlite官网下了源文件，才编译成功的。 （1）首先，到下载sqlite3的源文件。 下载地址：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里最常用到的是：sqlite3* 类型。 从数据库打开开始，SQLite就要为这个类型准备好内存，直到数据库关闭，整个过程都需要用到这个类型。当数据库打开时开始，这个类型的变量就代表了你要操作的数据库。下面再详细介绍。 2.2、打开数据库：sqlite3_open int sqlite3_open(const char *filename,sqlite3 **ppDb) 这个函数是用来打开数据库的。 （1）filename ： 数据库文件名（如："/Users/apple/Documents/data.db" ）。文件名不需要一定存在，如果此文件不存在，sqlite 会自动建立它。如果它存在，就尝试把它当数据库文件来打开。 （2）ppDb ： 即前面提到的关键数据结构。这个结构底层细节如何，你不要关它。 （3）返回值： 如果为 SQLITE_OK ，则成功打开数据库。 2.3、关闭数据库：sqlite3_close int sqlite3_close(sqlite3 *) 这个函数是用来关闭数据库的。若不再使用数据库时，必须将数据库关闭，释放内存资源。 （1）sqlite3* ： 即前面提到的关键数据结构。 （2）SQLITE_OK ，则成功关闭数据库。 2.4、执行sql语句：sqlite3_exec int sqlite3_exec(sqlite3*,const char *sql,int (*callback)(void*,int,char**,char**),void*,char **errmsg) 这个函数是用来执行sql语句的，对数据库进行：增删改查。 （1）sqlite3* ： 即前面提到的关键数据结构。 （2）sql ： 即sql语句（增删改查）。 （3）(*callback) ： 执行exec时，每查到一条记录，就会调用这个回调函数（具体在 2.5介绍）。 （4）void* ： 传递数据，可以是任意值。会传递到回调函数callback，作为它的第一个参数传入。 （5）errmsg ： 错误信息。 注意：后面三个参数，若不需要，可以填 NULL 。 2.5、sqlite3_exec的回调函数callback 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 ： 即前面提到的关键数据结构。 （2）sql ： 即sql查询语句。 （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!");
}
//
3.5、查询数据，使用sqlite3_exec（查） 使用 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 " 。
3.9、关闭数据库 最后，记得关闭数据库，否则会造成内存泄露。 // sqlite3_close(pdb); // （编辑：李大同） 【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容! |
