cocos2dx之引入Sqlite3数据库

本文介绍了SQLite作为一款轻量级、高效的嵌入式数据库的特点及其在移动设备上的使用方法。探讨了SQLite如何通过简单的外部接口提供SQL支持,并通过示例展示了如何创建表、插入记录及读取数据。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

从性能上说,XML方式的存储基本可以满足1 MB以下的存储要求。但在更复杂的情景中,我们可能需要存储多种不同的类,每个类也需要存储不同的对象,此时XML存储的速度就将成为瓶颈。即便分文件存储,管理起来也很麻烦,这个时候可以引入数据库来提升存储效率。
 关系数据库是一种经典的数据库,其中的数据被组织成表的形式,具有相同形式的数据存放在同一张表中,表内每一行代表一个数据。在表的基础上,数据库为我们提供增、删、改、查等操作,这些操作通常采用SQL(结构化查询语言)表达。这种格式化、集中的存储再加上结构化的操作语言带来一个非常大的好处:可以进行深度的优化,大大提升存储和操作的效率。
 SQLite是移动设备上常用的一个嵌入式数据库,具有开源、轻量等特点,其源代码只有两个".c"文件和两个".h"文件,并且已经包括了充分的注释说明。相比MySQL或者SQL Server这样的专业级数据库,甚至是比起同样轻量级的Access,SQLite的部署都可谓非常简单,只要将这4个文件导入工程中即可,这使得编译之后的SQLite非常小。

 SQLite将数据库的数据存储在磁盘的单一文件中,并通过简单的外部接口提供SQL支持。由于其设计之初即是针对小规模数据的操作,在查询优化、高并发读写等方面做了极简化的处理,可以保证不占用系统额外的资源,因此,在大多数的嵌入式开发中,会比专业数据库有更快速、高效的执行效率。


好了,看看如何加入Sqlite3吧,先从官网http://www.sqlite.org/download.html,下载你所想要的版本的sqlite,我这下的是3.8.2的,在解压后,只有4个文件,没有.def或者是什么dll,lib,这个是要自己生成的。


解压后,将这四个文件添加到你的当前工程中,然后进行编译一下就可以了。


好了,先看个如何创建一个表:

回调函数的格式如下:
int sqlite_callback(
    void* pv,    /* 由 sqlite3_exec() 的第四个参数传递而来 */
    int argc,        /* 表的列数 */
    char** argv,    /* 指向查询结果的指针数组, 可以由 sqlite3_column_text() 得到 */
    char** col        /* 指向表头名的指针数组, 可以由 sqlite3_column_name() 得到 */
);

参数格式:
    传给sqlite3_exec的回调函数,用来显示查询结果
    对每一条查询结果调用一次该回调函数
参数:
    pv:由sqlite3_exec传递的初始化参数
    argc:表头的列数
    col:表头的名字数组指针
    argv:表头的数据数组指针
返回值:
    1:中断查找
    0:继续列举查询到的数据
示例表:
+-----------------------------------+
|  id  |  pic   |  data(16进制数据)  |
|-----------------------------------|
|   1  |  a.jpg |      00 00 00 ... |
|-----------------------------------|
|   2  |  b.jpg |     XX XX XX      |
+-----------------------------------+
对第一行数据:
    argc=3 即 [0]...[2]
    argv[0]="1",argv[1]="a.jpg",argv[2]="00 00 00..."(实际16进制数据,非这里显示的字符串形式)
    col[0]="id",col[1]="pic",col[2]="data"
 
说明:
    sqlite3_exec() 的回调函数必须按照此格式, 当然形参的名字任意.
    如果某列的数据类型不是char*, 则可以对结果执行相关的转换, 如:用atoi()把结果转换为整数(integer), 如果是二进制数据, 则可以直接强制类型转换, 如:(void*)argv[i].
    该回调函数有两种返回值类型.
        1.返回零:sqlite3_exec() 将继续执行查询.
        2.返回非零:sqlite3_exec()将立即中断查询, 且 sqlite3_exec() 将返回 SQLITE_ABORT.
示例:
    int i;
    for(i=0; i<argc; i++)
    {
        printf("%s\t%s\n\n", col[i], argv[i]);
    }

例子:
    m_pGameDataBase = prepareTableInDB( "MyGame2", "E:\\database\\MyGame");

    std::string insert_sql_("insert into MyGame2 values(123, \"aaa\", 26, \"man\")");
    insertRecordIntoSqlite(insert_sql_);
    
    readRecord();// read the record


//
int  readFromSQLite(void *anyParam, int iColumn, char **pColumnValue, char **pColumnName ) {
    int icolumenCount = iColumn;
    for(int i = 0; i < icolumenCount; ++i) {
        CCLOG("%s: %s \n", pColumnName[i], pColumnValue[i]);
    }
    return 0;
}

void GameController::readRecord() {
    std::string read_sql_("select * from MyGame2");
    char *perrMsg = 0;
    sqlite3_exec( m_pGameDataBase,
                        read_sql_.c_str(),
                        readFromSQLite,
                        NULL,
                        &perrMsg);
}

sqlite3* GameController::prepareTableInDB(const char* table, const char* dbFilename) {
    sqlite3 *splite2Data = 0;
    char *errMsg = 0;

    if(SQLITE_OK != sqlite3_open(dbFilename, &splite2Data)) {
        CCLOG("Open the Game Data Table falied\n");
        return 0;
    }

    std::string string_sql = "create table if not exists " + std::string(table) + "(  id int unsigned auto_increment primary key,  name varchar(50),  age int,  sex varchar(10))";

    sqlite3_exec(splite2Data,
                       string_sql.c_str(),
                       NULL,
                       NULL,
                       &errMsg); // create a table;

    if(errMsg != 0) {
        CCLOG("Create the Data table failed\n");
        sqlite3_close(splite2Data);
        return 0;
    }

    return splite2Data;
}

void GameController::insertRecordIntoSqlite(std::string &r_stringOrder) {
    char *perrMsg = 0;
    int info =  sqlite3_exec(  m_pGameDataBase,
                                        r_stringOrder.c_str(),
                                       0,
                                       0,
                                       &perrMsg);
   do{
       if(perrMsg != 0) { // execute the instruct failed
           CCLOG("insert a record into the table failed\n");
           CCLOG("reason: %d, Error Message: %s \n", info, perrMsg);
           break;
       }

   } while(0);  
   sqlite3_close(m_pGameDataBase); // 
}


评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值