iOS —— SQLite3 功能使用详解 (三)

SQLite3 功能

1、获取sqlite3的数据库文件路径
<span style="font-size:14px;">NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
NSString *documentsDirectory = [paths objectAtIndex:0];
NSString *path = [documentsDirectory stringByAppendingPathComponent:@"database_name"];</span>
2、打开iPhone上的sqlite3的数据库文件

<span style="font-size:14px;">sqlite3 *database;
sqlite3_open([path UTF8String], &database);</span>

3、准备sql文－－－sql语句
<span style="font-size:14px;">sqlite3_stmt *stmt;
const char *sql = "SELECT * FROM table_name WHERE pk=? and name=?";
sqlite3_prepare_v2(database, sql, -1, &stmt, NULL);</span>
4、邦定参数
<span style="font-size:14px;">// 邦定第一个int参数
sqlite3_bind_int(stmt, 1, 1);
// 邦定第二个字符串参数
sqlite3_bind_text(stmt, 2, [title UTF8String], -1, SQLITE_TRANSIENT);</span>
5、执行sql文
sqlite3_step(stmt);
6、释放sql文资源
 
sqlite3_finalize(stmt);
 
7、关闭iPhone上的sqlite3的数据库

sqlite3_close(database);

先创建一个数据库，然后查询其中的内容。2个重要结构体和5个主要函数：

sqlite3               *pdb, 数据库句柄，跟文件句柄FILE很类似

sqlite3_stmt      *stmt, 这个相当于ODBC的Command对象，用于保存编译好的SQL语句

sqlite3_open(),   打开数据库

sqlite3_exec(),   执行非查询的sql语句

sqlite3_prepare(), 准备sql语句，执行select语句或者要使用parameter bind时，用这个函数（封装了sqlite3_exec）.

Sqlite3_step(), 在调用sqlite3_prepare后，使用这个函数在记录集中移动。

Sqlite3_close(), 关闭数据库文件

从记录集字段中获取数据，如

sqlite3_column_text(), 取text类型的数据。

sqlite3_column_blob（），取blob类型的数据

sqlite3_column_int(), 取int类型的数据

PreparedStatement方式处理SQL请求的过程

特点：可以绑定参数，生成过程。执行的时候像是ADO一样，每次返回一行结果。

1. 首先建立statement对象：

int sqlite3_prepare(

  sqlite3 *db,            /* Database handle */

  const char *zSql,       /* SQL statement, UTF-8 encoded */

  int nBytes,             /* Length of zSql in bytes. */

  sqlite3_stmt **ppStmt,  /* OUT: Statement handle */

  const char **pzTail     /* OUT: Pointer to unused portion of zSql */

);

2. 绑定过程中的参数（如果有没有确定的参数）

   int sqlite3_bind_xxxx(sqlite3_stmt*, int, ...);

第二个int类型参数－表示参数的在SQL中的序号（从1开始）。

第三个参数为要绑定参数的值。

  对于blob和text数值的额外参数：

第四参数是字符串（Unicode 8or16）的长度，不包括结束'\0'。

第五个参数，类型为void(*)(void*)，表示SQLite处理结束后用于清理参数字符串的函数。

没有进行绑定的未知参数将被认为是NULL。

3. 执行过程

  int sqlite3_step(sqlite3_stmt*);

可能的返回值：

 *SQLITE_BUSY:   数据库被锁定，需要等待再次尝试直到成功。

 *SQLITE_DONE:   成功执行过程（需要再次执行一遍以恢复数据库状态）

 *SQLITE_ROW:    返回一行结果（使用sqlite3_column_xxx(sqlite3_stmt*,, int iCol)得到每一列的结果。

         再次调用将返回下一行的结果。

 *SQLITE_ERROR:  运行错误，过程无法再次调用（错误内容参考sqlite3_errmsg函数返回值）

 *SQLITE_MISUSE: 错误的使用了本函数（一般是过程没有正确的初始化）

4. 结束的时候清理statement对象

  int sqlite3_finalize(sqlite3_stmt *pStmt);

应该在关闭数据库之前清理过程中占用的资源。

5. 重置过程的执行 

  int sqlite3_reset(sqlite3_stmt *pStmt);

过程将回到没有执行之前的状态，绑定的参数不会变化。

其他函数

1. 得到结果总共的行数

  int sqlite3_column_count(sqlite3_stmt *pStmt);

如果过程没有返回值，如update，将返回0

2. 得到当前行中包含的数据个数

  int sqlite3_data_count(sqlite3_stmt *pStmt);

如果sqlite3_step返回SQLITE_ROW，可以得到列数，否则为零。

3. 得到数据行中某个列的数据

  sqlite3_column_xxx(sqlite3_stmt*, int iCol);

在sqlite3_step返回SQLITE_ROW后，使用它得到第iCol列的数据。

其中的xxx代表：

blob：指向保存数据内存的指针

bytes, bytes16: 得到该blob类型数据的大小，或者text转换为UTF8/UTF16的字符串长度。

double, int, int64： 数值

text,text16：字符串指针

type:该列的数据类型（SQLITE_INTEGER，SQLITE_FLOAT，SQLITE_TEXT，SQLITE_BLOB，SQLITE_NULL）

注意：如果对该列使用了不同与该列本身类型适合的数据读取方法，得到的数值将是转换过的结果。

4. 得到数据行中某个列的数据的类型

  int sqlite3_column_type(sqlite3_stmt*, int iCol);

返回值：SQLITE_INTEGER，SQLITE_FLOAT，SQLITE_TEXT，SQLITE_BLOB，SQLITE_NULL

使用的方法和sqlite3_column_xxx()函数类似。