SQLite3应用开发笔记

一.准备工作
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,            /*Database handle */
 const char *zSql,       /* SQLstatement, UTF-8 encoded */
  intnByte,              /* 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,       /* SQLstatement, UTF-16 encoded */
  intnByte,              /* Maximum length ofzSql in bytes. */
 sqlite3_stmt **ppStmt,  /* OUT:Statement handle */
 const void **pzTail     /* OUT:Pointer to unused portion of zSql */
);
int sqlite3_prepare16_v2(
 sqlite3 *db,            /*Database handle */
 const void *zSql,       /* SQLstatement, UTF-16 encoded */
  intnByte,              /* Maximum length ofzSql in bytes. */
 sqlite3_stmt **ppStmt,  /* 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好,减小了冲突的可能性。

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值