IOS开发之sqlit3应用

sqlite是iphone中持久存储数据的一种方法，在很多的应用开发中都要用到，我把我了解的一些记录下来，方便自己之后应用，废话少说，马上开始。

在应用sqlite之前我们需要首先向项目条件framework

1：libsqlite3.0.dylib；

2：之后添加头文件#import "/usr/include/sqlite3.h"

现在我们就可以在项目中应用sqlite了；首先我简单介绍一下sqlite支持的数据类型（NULL：空值，INTEGER：带符号的整型，REAL：浮点数字；TEXT：字符串文本；BLOB：二进制对象——类如我们希望存储媒体类型可以转换成二进制）；一般情况下这几种类型已经足够我们开发中应用，但是有些个别的情况我们还可以应用的数据：float——32位浮点数，double——64位浮点数，char(n)——n<=254代表字符串长度，varchar(n)——n<=4000长度不固定，smallint——16位整数，interger——32位整数，data——包含年/月/日期，time——包含时/分/秒，timestamp——包含年月日时分秒微秒 等。

其实再用sqlite的时候准确的说是没有数据类型的，类如create table file1(a, b, c)，abc可以是任意类型，那么这个时候只有自动递增的列才有用是integer primary key。虽然sqlite允许我们不设置每一列的数据类型，但是我们任然要设置数据类型，这样也方便自己和他人程序易读性增加。

- (NSString *)getPath:(NSString *)string {

    NSArray *paths =NSSearchPathForDirectoriesInDomains(NSDocumentDirectory,NSUserDomainMask, YES);

    NSString *documentsDirectory = [paths objectAtIndex:0];

    NSString *path = [documentsDirectory stringByAppendingPathComponent:string];

    return path;

}

//初始化数据库

- (BOOL) initializeDb {            

    NSString *dbFilePath = [selfgetPath:@"puzzle.db"];

    

    if (![[NSFileManagerdefaultManager] fileExistsAtPath:dbFilePath]) { //检查是否存在数据库，没有执行

        if (sqlite3_open([dbFilePathUTF8String], &database) == SQLITE_OK) {  //没有则创建成功

            sqlite3_close(database); 

            return YES;

        } else { //失败

            NSLog(@"create bad");

            return NO;

        }

    } 

    return YES; //已经存在数据库

}

//创建表

- (BOOL)createTable {  

    char *err;  

    char *sql ="create table if not exists images (id integer primary key autoincrement, a integer, b blob)";//创建表语句  

    if (sql == NULL) {  

        return NO;  

    }  

    

    if (SQLITE_OK !=sqlite3_open([[self getPath:@"puzzle.db"] UTF8String], &database)){  

        return NO;  

    }  

    

    /*sqlite3_exec用于针对SQLite3运行任何不返回数据的命令，用于执行更新，插入和删除操作*/

    if (SQLITE_OK ==sqlite3_exec(database, sql, NULL, NULL, &err)) {//执行创建表语句成功  

        sqlite3_close(database);  

        return YES;  

    } else {//创建表失败  

        return NO;  

    }  

}  

//插入记录

- (BOOL)insertRecordWithNumber:(NSInteger)_int Image:(UIImage *)_image {  

    int ret = 0;  

    if (SQLITE_OK !=sqlite3_open([[self getPath:@"puzzle.db"] UTF8String], &database)){//打开数据库  

        return NO;  

    }  

    

    NSData *_data =UIImagePNGRepresentation(_image);

    

    char *sql ="insert into dictionary(_int, _image) values(?, ?);";//插入语句，3个参数  

    sqlite3_stmt *stmt;

    if (sqlite3_prepare_v2(database, sql, -1, &stmt,nil)==SQLITE_OK) {//准备语句 

        sqlite3_bind_int(stmt, 1, _int);

        sqlite3_bind_blob(stmt, 2, [_data bytes] , [_data length],NULL);   

    } else {  

        return NO;  

    }  

    if (SQLITE_DONE == (ret =sqlite3_step(stmt))) {//执行查询  

        sqlite3_finalize(stmt);  

        sqlite3_close(database);  

        return YES;  

    }else{  

        return NO;  

    }  

}  

CHAR。CHAR存储定长数据很方便，CHAR字段上的索引效率级高，比如定义char(10)，那么不论你存储的数据是否达到了10个字节，都要占去10个字节的空间,不足的自动用空格填充。

VARCHAR。存储变长数据，但存储效率没有CHAR高。如果一个字段可能的值是不固定长度的，我们只知道它不可能超过10个字符，把它定义为 VARCHAR(10)是最合算的。VARCHAR类型的实际长度是它的值的实际长度+1。为什么“+1”呢？这一个字节用于保存实际使用了多大的长度。从空间上考虑，用varchar合适；从效率上考虑，用char合适，关键是根据实际情况找到权衡点。

TEXT。text存储可变长度的非Unicode数据，最大长度为2^31-1(2,147,483,647)个字符。

NCHAR、NVARCHAR、NTEXT。这三种从名字上看比前面三种多了个“N”。它表示存储的是Unicode数据类型的字符。我们知道字符中，英文字符只需要一个字节存储就足够了，但汉字众多，需要两个字节存储，英文与汉字同时存在时容易造成混乱，Unicode字符集就是为了解决字符集这种不兼容的问题而产生的，它所有的字符都用两个字节表示，即英文字符也是用两个字节表示。nchar、nvarchar的长度是在1到4000之间。和char、varchar比较起来，nchar、nvarchar则最多存储4000个字符，不论是英文还是汉字；而char、varchar最多能存储8000个英文，4000个汉字。可以看出使用nchar、nvarchar数据类型时不用担心输入的字符是英文还是汉字，较为方便，但在存储英文时数量上有些损失。

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()函数类似。