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
1
|
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
这个函数是用来关闭数据库的。若不再使用数据库时,必须将数据库关闭,释放内存资源。
(1)sqlite3* : 即前面提到的关键数据结构。
(2)返回值: 如果为 SQLITE_OK ,则成功关闭数据库。
2.4、执行sql语句:sqlite3_exec
sqlite3_exec(sqlite3*,
*sql,
(*callback)(
void
*,monospace!important; font-size:1em!important; min-height:inherit!important">,monospace!important; font-size:1em!important; min-height:inherit!important">**,monospace!important; font-size:1em!important; min-height:inherit!important">**),monospace!important; font-size:1em!important; min-height:inherit!important">**errmsg)
|
这个函数是用来执行sql语句的,对数据库进行:增删改查。
(2)sql : 即sql语句(增删改查)。
(3)(*callback) : 执行exec时,每查到一条记录,就会调用这个回调函数(具体在 2.5 介绍)。
(4)void* : 传递数据,可以是任意值。会传递到回调函数callback,作为它的第一个参数传入。
(5)errmsg : 错误信息。
注意:后面三个参数,若不需要,可以填 NULL 。
2.5、sqlite3_exec的回调函数callback
(*sqlite3_callback)(
*para,monospace!important; font-size:1em!important; min-height:inherit!important">col_num,monospace!important; font-size:1em!important; min-height:inherit!important">**col_value,monospace!important; font-size:1em!important; min-height:inherit!important">**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,constchar*sql,monospace!important; font-size:1em!important; min-height:inherit!important">***result,monospace!important; font-size:1em!important; min-height:inherit!important">*row,monospace!important; font-size:1em!important; min-height:inherit!important">*col,serif; font-size:14px"> 这个函数是用来查询数据库的。
|