iOS开发之SQLite--C语言接口规范(三)——Binding Values To Prepared Statements

在前面的博客中已经介绍了如何连接SQLite数据库，并且简单的查询和遍历结果集。在前面用到了 sqlite3_stmt *stmt，也就是预编译后的SQL语句。在本篇博客中会了解一下 sqlite3_stmt ，然后了解一下变量的绑定。变量绑定，简单的说就是往预编译后的SQL语句中传入相应的值。

一. sqlite3_stmt 的生命周期

这个对象的实例代表着一个被编译成二进制的SQL语句。每个SQL语句都必须经过预编译转换成sqlite3_stmt才能被执行。在iOS开发中，Application或者UIViewController等都是有自己的生命周期的， 预编译语句也是有自己的生命周期的，其生命周期如下：

1. sqlite3_stmt 对象的生命起源于 sqlite3_prepare_v2() , 使用 sqlite3_prepare_v2() 可以创建 sqlite3_stmt 对象。

2.使用 sqlite3_bind_*() 接口可以给 sqlite3_stmt 对象绑定变量。

3.调用 sqlite3_step() 一次或者多次来运行SQL语句。

4.调用 sqlite3_reset() 回到上一次执行的SQL语句，你可以调用 sqlite3_reset() 多次， sqlite3_reset() 更像版本管理中的回滚操作。

5.使用 sqlite3_finalize() 析构函数来释放 sqlite3_stmt 对象。

sqlite3_stmt对象的构造函数（推荐使用“v2”接口）： sqlite3_prepare() , sqlite3_prepare16() , sqlite3_prepare16_v2() , sqlite3_prepare_v2()

sqlite3_stmt对象的析构函数： sqlite3_finalize()

下方是有关sqlite3_stmt对象的接口，本篇博客主要介绍有关sqlite3_bind_*()的方法。

二、值绑定

先简单介绍一下什么是值绑定吧。用大白话说，值绑定就是在SQL语句预编译时把一些参数使用占位符（这里是?号）来代替，然后与程序中的变量进行绑定。类似于字符串的格式化。如果你之前搞过Java的JDBC或者PHP, 在他们操作数据库执行SQL语句时都有类似值绑定的一个概念。 就是把外界变量把SQL语句占位的值进行替换。值绑定经常在SELECT,INSERT,UPDATE等语句中进行使用。

1.为预编译SQL语句绑定变量，绑定不同类型变量需要不同的绑定接口，下方是常用的绑定变量的接口。

2.在 sqlite3_prepare_v2() 输入的SQL语句的文本中，下面的这些参数将会被替换掉，在下面的参数中，NNN表示一个整数(这个整数就代表这个参数的索引)，VVV代表一个字母标示符（参数的名字）。可以使用 sqlite3_bind_*() 函数为上面的这些占位符进行赋值。

说的直白一些，“?”号就是匿名参数，从第一个问号出现往后的索引默认是1，往后以此类推。而“?NNN”是为匿名参数指定索引，你可以这样写“?1” , "?2"等，而:VVV, @VVV, $VVV这些就是有名参数了，VVV就是参数的名字。比如:ludashi, @ludashi, $ludashi。

下面的实例给出了参数不同的几种表现形式, 前一种是匿名参数，后边参数就有自己的名字了。

3. sqlite3_bind_*() 参数介绍（这些绑定函数执行成功后回返回SQLITE_OK, 执行不成功的话回返回相应的错误代码）

(1) sqlite3_bind_*() 的第一个参数是含有上述占位符预编译后的语句指针，也就是sqlite3_stmt的对象。

(2)  sqlite3_bind_*() 的第二个参数是SQL语句中参数的索引，例如第一个参数的索引值是1，那么就传1。匿名参数的索引是从1开始往后递增的，而有参数名称的可以通过 sqlite3_bind_parameter_index() 接口传入参数名称来获取该参数的索引， sqlite3_bind_parameter_index() 用法如下，第一个参数是sqlite3_stmt的对象，而后边的参数是SQL参数名称，返回值就是该参数的索引。

int index = sqlite3_bind_parameter_index(statement, "$brandidMin");

(3) 第三个参数是要绑定的值。

(4) sqlite3_bind_blob(),  sqlite3_bind_text()和 sqlite3_bind_text16()这三个接口中还有有第四和第五个参数，第四个参数代表第三个参数“绑定值”的字节长度。第五个参数是一个指向内存管理回调函数的指针。

4.每个绑定函数的使用场景

(1) BLOB是数据库中存储大数据的一种数据类型，它是以二进制的形式来存储数据的。

1         SQLITE_API int sqlite3_bind_blob(sqlite3_stmt*, int, const void*, int n, void(*)(void*));

(2) 顾名思义，下面的方法是绑定double类型的数据的

1         SQLITE_API int sqlite3_bind_double(sqlite3_stmt*, int, double);

(3) 绑定一个32位的整型值

1         SQLITE_API int sqlite3_bind_int(sqlite3_stmt*, int, int);

(4) 绑定一个64位的整型值

1         SQLITE_API int sqlite3_bind_int64(sqlite3_stmt*, int, sqlite3_int64);

(5)绑定一个NULL的值(在数据库中可以为NULL)

1         SQLITE_API int sqlite3_bind_null(sqlite3_stmt*, int);

(6)绑定一个UTF-8编码的字符串，第四个参数上面也提到了，是绑定字符串的长度，如果为负值的话，就是传多少就绑定多少。

1         SQLITE_API int sqlite3_bind_text(sqlite3_stmt*, int, const char*, int n, void(*)(void*));

(7)绑定一个UTF-16编码的字符串，第四个参数上面也提到了，是绑定字符串的长度，如果为负值的话，就是传多少就绑定多少。

1         SQLITE_API int sqlite3_bind_text16(sqlite3_stmt*, int, const void*, int, void(*)(void*));

(8) 绑定sqlite3_value结构体类型的值，sqlite3_value结构体可以保存任意格式的数据。

SQLITE_API int sqlite3_bind_value(sqlite3_stmt*, int, const sqlite3_value*);

(9)绑定一个任意长度的BLOB类型的二进制数据，它的每一个字节被置0。第3个参数是字节长度。这个函数的特殊用处是，创建一个大的BLOB对象，之后可以通过BLOB接口函数进行更新。

1         SQLITE_API int sqlite3_bind_zeroblob(sqlite3_stmt*, int, int n);

5.值绑定常用工具函数

（1）下方的函数返回预编译SQL语句中参数的个数，这些参数可以是匿名参数，也可以是有名参数。

具体用法如下：

1     int count = sqlite3_bind_parameter_count(statement); 2     NSLog(@"%d", count);

(2)通过索引获取对应参数的名称

具体用法如下：

1     const char * name = sqlite3_bind_parameter_name(statement, 1); 2     NSLog(@"%s", name);

(3) 在一个是通过名字获取索引了，正好和上面的方法相反。

调用方式如下：

1         int index = sqlite3_bind_parameter_index(statement, ":brandidMax"); 2         NSLog(@":brandidMax——index = %d", index);

三、值绑定实例

下面的实例是在查询语句中使用值绑定，绑定完值后，调用查询数据库的方法，然后进行数值的输出，因为上面说的够多了，下面的代码就不用加注释了。

 1 -(void) qureyInfoWithDataBase2: (sqlite3 *) database{  2       3     NSString * qureyInfo = @"SELECT * FROM CARBRAND WHERE BRANDID > :brandidMin AND BRANDID < :brandidMax";  4       5     sqlite3_stmt *statement;  6       7     const char * zSql = [qureyInfo UTF8String];  8       9     int result = sqlite3_prepare_v2(database, zSql, -1, &statement, nil); 10      11     int count = sqlite3_bind_parameter_count(statement); 12     NSLog(@"count = %d", count); 13      14     const char * name = sqlite3_bind_parameter_name(statement, 1); 15     NSLog(@"name = %s", name); 16      17     if (result == SQLITE_OK) { 18          19         int index = sqlite3_bind_parameter_index(statement, ":brandidMax"); 20         NSLog(@":brandidMax_index = %d", index); 21          22         //值绑定 23         sqlite3_bind_int(statement, 1, 180); 24         sqlite3_bind_int(statement, 2, 200); 25          26         [self queryUserInfoWith: database WithStatement: statement]; 27     } 28      29 }

查询数据库的方法

 1 //查询数据库  2 - (void) queryUserInfoWith: (sqlite3 *) database WithStatement: (sqlite3_stmt *) statement {  3           4     while (sqlite3_step(statement) == SQLITE_ROW) {  5           6         int rowNum = sqlite3_column_int(statement, 0);  7           8         char *rowDataOne = (char *) sqlite3_column_text(statement, 1);  9          10         char *rowDataTow = (char *) sqlite3_column_text(statement, 2); 11          12         NSString *nameString = [NSString stringWithUTF8String:rowDataOne]; 13          14         NSString *firstLetterString = [NSString stringWithUTF8String:rowDataTow]; 15          16         NSLog(@"BrandId = %d, Name = %@, FirstLetter = %@",rowNum , nameString, firstLetterString); 17          18     } 19     sqlite3_finalize(statement); 20      21 }

输入结果如下：

今天博客就先到这儿，关于SQLite数据库的东西会继续更新。