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好，减小了冲突的可能性。