Cocos2d-x,SQLite3数据库用法,编译，配置

转至：http://cn.cocos2d-x.org/tutorial/show?id=2430

前言】

在Cocos2d-x中，简单数据存储，可以使用UserDefault。那么如何存储大量，不规则的数据？我们可以使用 sqlite数据库存储数据。sqlite 是使用非常广泛的嵌入式数据库，它有小巧、高效、跨平台、开源免费和易操作的特点。所以大量的被用于手机、PDA、MP3播放器、以及机顶盒设备。

sqlite数据库是使用C语言来编写的，因此在Cocos2d-x使用sqlite也是得心应手。

本文介绍一下sqlite3数据库的基础用法：增删改查。

PS：另外对于sqlite的可视化管理工具，本人使用的是 sqliteStudio，这个就自行了解吧。

Demo下载（Github地址）

【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

intsqlite3_open(constchar*filename,sqlite3**ppDb)

这个函数是用来打开数据库的。

（1）filename ：数据库文件名（如："/Users/apple/Documents/data.db" ）。文件名不需要一定存在，如果此文件不存在，sqlite 会自动建立它。如果它存在，就尝试把它当数据库文件来打开。

（2）ppDb ：即前面提到的关键数据结构。这个结构底层细节如何，你不要关它。

（3）返回值：如果为 sqlITE_OK ，则成功打开数据库。

2.3、关闭数据库：sqlite3_close

intsqlite3_close(sqlite3*)

这个函数是用来关闭数据库的。若不再使用数据库时，必须将数据库关闭，释放内存资源。

（1）sqlite3* ：即前面提到的关键数据结构。

（2）返回值：如果为 sqlITE_OK ，则成功关闭数据库。

2.4、执行sql语句：sqlite3_exec

intsqlite3_exec(sqlite3*,constchar*sql,int(*callback)(void*,int,char**,char**),void*,char**errmsg)

这个函数是用来执行sql语句的，对数据库进行：增删改查。

（2）sql ：即sql语句（增删改查）。

（3）(*callback) ：执行exec时，每查到一条记录，就会调用这个回调函数（具体在 2.5 介绍）。

（4）void* ：传递数据，可以是任意值。会传递到回调函数callback，作为它的第一个参数传入。

（5）errmsg ：错误信息。

注意：后面三个参数，若不需要，可以填 NULL 。

2.5、sqlite3_exec的回调函数callback

int(*sqlite3_callback)(void*para,intcol_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,serif; font-size:14px"> 这个函数是用来查询数据库的。 
 （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,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、关闭数据库 
  
 注意：
 最后，记得关闭数据库，否则会造成内存泄露。 
 
 使用sqlite一定要注意的内存管理问题，那就是打开数据库之后，数据操作完成之后，一定要关闭数据库，否侧会造成内存泄漏。 
  
sqlite3_close(pdb); 
 数据文件存放的位置 
 
 Android： 
 
    /data/data/com.youCompany.Helloworld/files/save.db 
 
 iOS: 
 
 
 位于程序沙盒的文档目录下 
../Documents/save.db
 原文链接：https://www.f2er.com/cocos2dx/341830.html

Cocos2d-x,SQLite3数据库用法,编译，配置

注意：

数据文件存放的位置

猜你在找的Cocos2d-x相关文章