一.准备工作
sqlite官网地址:http://www.sqlite.org,截止目前的最新版本:3.7.14。
下载sqlite源码及对应版本的文档:sqlite-amalgamation-3071400.zip,sqlite-doc-3071400.zip
解压源码压缩包,释放出4个文件:shell.c sqlite3.c sqlite3.h sqlite3ext.h
开始编译!(windows平台,vs2005)
首先用vs建一个工程,我的目标是编译成lib,所以建一个静态库工程,工程建好后将解压出来的4个文件加入工程,编译,生成lib文件。
编译选项:
关于编译选项的设置compile.html文档中有介绍,选项很多,慢慢看。
其中有一个sqlITE_THREADSAFE=<0 or 1 or 2>选项决定了多线程环境下的安全问题,
0 多线程不安全。
1 多线程安全。
2 可以在多线程中使用,但多线程之间不能共享database connection和任何从其派生的prepared statements。
默认sqlITE_THREADSAFE=1
如果使用的是别人编译好的dll或lib,自己不知道编译选项里设置的值,别着急,可以调用sqlite3_threadsafe()取得设置。
还可以调用sqlite3_config()修改设置。
二.使用sqlite3的C/C++接口
两个常用的对象:
The database connection object: sqlite3
The prepared statement object: sqlite3_stmt
常用的接口:
sqlite3_open()
通常这个函数被第一个调用,这个操作打开一个数据库文件的链接,输出一个database connection对象,database connection对象在调用之后的接口时使用。
函数原型:
int sqlite3_open(
const char *filename,/*Database filename (UTF-8) */
sqlite3 **ppDb /* OUT:sqlite db handle */
);
int sqlite3_open16(
const void *filename,/*Database filename (UTF-16) */
sqlite3 **ppDb /* OUT:sqlite db handle */
);
int sqlite3_open_v2(
constchar *filename,/* Database filename(UTF-8) */
sqlite3 **ppDb,/* OUT:sqlite db handle */
intflags,/* Flags */
const char *zVfs /* Name ofVFS module to use */
);
通过filename参数指定要打开的数据库,sqlite3_open()和sqlite3_open_v2()的filename参数是utf8编码格式,sqlite3_open16()的filename参数是UTF-16编码。
如果成功,sqlite3*被创建,返回值sqlITE_OK,如果失败,返回错误码,调用sqlite3_errmsg() 或 sqlite3_errmsg16()将得到错误信息。
无论成功与否, database connection句柄资源已经被分配,在不使用时应该将数据库连接句柄传递给sqlite3_close()释放资源。
sqlite3_open_v2的第三个参数,有3个值和其他的值(sqlITE_OPEN_NOMUTEX,sqlITE_OPEN_FULLMUTEX,sqlITE_OPEN_SHAREDCACHE,sqlITE_OPEN_PRIVATECACHE,and/or sqlITE_OPEN)组合:
sqlITE_OPEN_READONLY
sqlITE_OPEN_READWRITE
sqlITE_OPEN_READWRITE | sqlITE_OPEN_CREATE
如何不是用上面的3个值之一和其他值组合,其行为是未定义的。
sqlite3_prepare()
这个操作第一个参数输入database connection对象,第二个参数输入sql语句,该接口将输入的sql语句转变成prepared statement对象,输出prepared statement对象,在调用之后的接口时使用,记住,这个函数不执行sql语句,只为执行sql做准备。
函数原型:
int sqlite3_prepare(
sqlite3 *db,/*Database handle */
const char *zsql,/* sqlstatement,UTF-8 encoded */
intnByte,/* Maximum length ofzsql in bytes. */
sqlite3_stmt **ppStmt,/* OUT:Statement handle */
const char **pzTail /* OUT:Pointer to unused portion of zsql */
);
int sqlite3_prepare_v2(
sqlite3 *db,/* Maximum length of zsql in bytes. */
sqlite3_stmt **ppStmt,/* OUT:Statement handle */
const char **pzTail /* OUT:Pointer to unused portion of zsql */
);
int sqlite3_prepare16(
sqlite3 *db,/*Database handle */
const void *zsql,UTF-16 encoded */
intnByte,/* OUT:Statement handle */
const void **pzTail /* OUT:Pointer to unused portion of zsql */
);
int sqlite3_prepare16_v2(
sqlite3 *db,/* OUT:Statement handle */
const void **pzTail /* OUT: Pointer to unused portion of zsql*/
);
sqlite3_step()
这个操作执行sqlite3_prepare()接口返回的prepared statement,如果是SELECT操作,结果集的第一行将被返回,如果想得到第二行,还须再调用一次该函数,也就是每调用一次返回一行,直到完成。
有些操作仅需调用1次该函数,如:INSERT,UPDATE,DELETE语句。
使用老接口得到的statement,执行sqlite3_step返回sqlITE_BUSY,sqlITE_DONE,sqlITE_ROW,sqlITE_ERROR,or sqlITE_MISUSE;
使用v2接口得到的statement,执行sqlite3_step返回任意的result code或extended result codes。
sqlite3_column()
sqlite3接口并没有sqlite3_column()函数,这里所说的是一组函数:
sqlite3_column_blob()
sqlite3_column_bytes()
sqlite3_column_bytes16()
sqlite3_column_count()
sqlite3_column_double()
sqlite3_column_int()
sqlite3_column_int64()
sqlite3_column_text()
sqlite3_column_text16()
sqlite3_column_type()
sqlite3_column_value()
这个操作输入执行过sqlite3_step()的prepared statement对象,返回单列的结果,要得到一行中全部列的值需要调用多次这个函数。
sqlite3_finalize()
销毁之前调用sqlite3_prepare()创建的prepared statement,prepared statement必须由该函数销毁,否则会导致内存泄露。
sqlite3_close()
关闭之前调用sqlite3_open()创建的database connection,在调用该函数之前,必须保证所有的prepared statements都被finalized。
开发sqlite应用一般的流程:
首先用sqlite3_open()创建一个数据库连接,该函数根据输入参数可以打开一个已存在的数据库,也可以创建一个新的数据库文件。不用数据库的时候记得调用 sqlite3_close() 关闭数据库连接。
执行一个sql statement,有以下步骤:
1. 调用sqlite3_prepare()创建 preparedstatement。
2. 调用sqlite3_step()一次或多次执行preparedstatement。
3. 对于查询操作,在两次sqlite3_step()之间调用sqlite3_column()获取结果。
4. 调用sqlite3_finalize()销毁preparedstatement。
在调用 sqlite3_step()之后,可以调用sqlite3_reset()初始化prepared statement。
很多时候,每次调用的sql语句都是相似的,比如使用INSERT语句,每次执行只是插入不同的值,为了适应这种灵活性,sqlite允许sql statements带参数,在执行statements前给这些参数绑定一个值,绑定的值在 prepared statement第二次执行的时候还可以改变。
获得错误信息的函数:
int sqlite3_errcode(sqlite3 *db);
int sqlite3_extended_errcode(sqlite3 *db);
const char *sqlite3_errmsg(sqlite3*);
const void *sqlite3_errmsg16(sqlite3*);
三.sqlite3的线程模式
sqlite支持3种不同的线程模式:
Single-thread:这种模式下,所有的互斥被禁用,多线程使用sqlite是不安全的。
Multi-thread:这种模式下,sqlite可以安全地用于多线程,但多个线程不能共享一个database connect。
Serialized:这种模式下,sqlite可以安全地用于多线程,无限制。
sqlite线程模式的选择可以在编译时(当sqlitelibrary 源码被编译时)或启动时(使用sqlite的应用初始化时)或运行时(新的 database connection被创建时)。
一般来说,运行时覆盖启动时,启动时覆盖编译时,不过,Single-thread模式一旦被选择了,就不能被重改。
编译时设置线程模式:
用sqlITE_THREADSAFE选择线程模式,
如果sqlITE_THREADSAFE没有被设置或设置了-DsqlITE_THREADSAF=1,则是Serialized模式;
如果设置了-DsqlITE_THREADSAF=0,线程模式是Single-thread;
如果设置了-DsqlITE_THREADSAF=2,线程模式是Multi-thread.
启动时设置线程模式:
假设编译时线程模式被设置为非Single-thread模式,在初始化时可以调用sqlite3_config()改变线程模式,参数可以为sqlITE_CONFIG_SINGLETHREA,sqlITE_CONFIG_MULTITH,sqlITE_CONFIG_SERIALIZED.
运行时设置线程模式:
如果Single-thread模式在编译时和启动时都没被设置,则可以在database connections被创建时设置Multi-thread或Serialized模式,但不可以降级设置为Single-thread模式,也不可以升级编译时或启动时设置的Single-thread模式。
sqlite3_open_v2()的第三个参数决定单个databaseconnection的线程模式,sqlITE_OPEN_NOMUTEX使database connection为Multi-thread模式,sqlITE_OPEN_FULLMUTE使database connection为Serialized模式。
如果不指定模式或使用sqlite3_open()或sqlite3_open16()接口,线程模式为编译时或启动时设置的模式。
四.其它需要注意的
1. 如果需要用sqlite的*16函数(e.g. sqlite3_prepare16),需要传入UTF-16 (i.e. wstring) 参数,一定要用2*wcslen 作为字符穿长度传入,否则会被截断。
2. 对多个表同时操作时,为每个表建一个connection要比共享connection好,减小了冲突的可能性。