IOS-SQLite数据库使用详解

使用SQLite数据库

创建数据库

创建数据库过程需要3个步骤：

1、使用sqlite3_open函数打开数据库；

2、使用sqlite3_exec函数执行Create Table语句，创建数据库表；

3、使用sqlite3_close函数释放资源。

这个过程中使用了3个SQLite3函数，它们都是纯C语言函数，通过Objective-C去调用C函数当然不是什么问题，但是也要注意Objective-C数据类型与C数据类型兼容性问题。

下 面我们使用SQLite技术实现备忘录案例，与属性列表文件实现一样，我们只需要修改持久层工程（PersistenceLayer）中NoteDAO类 就可以了。首先我们需要添加SQLite3库到工程环境中，有3个工程需要添加到哪个呢？应该添加到可以运行的工程即表示层工程 PresentationLayer。选择工程PresentationLayer中 TARGETS→PresentationLayer→Link Binary With Libraries，点击左下角的“+”，弹出对话框选择 libsqlite3.dylib或libsqlite3.0.dylib，在弹出的对话框中点击Add添加。

NoteDAO.h文件的修改：

Cpp代码  收藏代码
  1. #import ”Note.h”  
  2.   
  3. #import ”sqlite3.h”  
  4.   
  5.    
  6.   
  7. #define DBFILE_NAME @”NotesList.sqlite3″  
  8.   
  9.    
  10.   
  11. @interface NoteDAO : NSObject  
  12.   
  13. {  
  14.   
  15. sqlite3 *db;  
  16.   
  17. }  
  18.   
  19.    
  20.   
  21. + (NoteDAO*)sharedManager;  
  22.   
  23.    
  24.   
  25. - (NSString *)applicationDocumentsDirectoryFile;  
  26.   
  27. - (void)createEditableCopyOfDatabaseIfNeeded;  
  28.   
  29.    
  30.   
  31. //插入Note方法  
  32.   
  33. -(int) create:(Note*)model;  
  34.   
  35.    
  36.   
  37. //删除Note方法  
  38.   
  39. -(int) remove:(Note*)model;  
  40.   
  41.    
  42.   
  43. //修改Note方法  
  44.   
  45. -(int) modify:(Note*)model;  
  46.   
  47.    
  48.   
  49. //查询所有数据方法  
  50.   
  51. -(NSMutableArray*) findAll;  
  52.   
  53.    
  54.   
  55. //按照主键查询数据方法  
  56.   
  57. -(Note*) findById:(Note*)model;  
  58.   
  59.    
  60.   
  61. @end  



我们需要使用语句#import ”sqlite3.h”引入sqlite3头文件，而且需要定义sqlite3*成员变量db。NoteDAO.m中的createEditableCopyOfDatabaseIfNeeded方法：

Cpp代码  收藏代码
  1. - (void)createEditableCopyOfDatabaseIfNeeded {  
  2.   
  3.    
  4.   
  5. NSString *writableDBPath = [self applicationDocumentsDirectoryFile];  
  6.   
  7. if (sqlite3_open([writableDBPath UTF8String], &db) != SQLITE_OK) { ①  
  8.   
  9. sqlite3_close(db);  ②  
  10.   
  11. NSAssert(NO,@”数据库打开失败。”);  
  12.   
  13. } else {  
  14.   
  15. char *err;  
  16.   
  17. NSString *createSQL = [NSString stringWithFormat:@"CREATE TABLE IF NOT EXISTS Note  
  18.   
  19. (cdate TEXT PRIMARY KEY, content TEXT);"]; ③  
  20.   
  21. if (sqlite3_exec(db,[createSQL UTF8String],NULL,NULL,&err) != SQLITE_OK) { ④  
  22.   
  23. sqlite3_close(db); ⑤  
  24.   
  25. NSAssert1(NO, @”建表失败, %s”, err);  ⑥  
  26.   
  27. }  
  28.   
  29. sqlite3_close(db);  ⑦  
  30.   
  31. }  
  32.   
  33. }  



createEditableCopyOfDatabaseIfNeeded方法用于创建数据库，第1步打开数据 库，代码①行，语句是 sqlite3_open([writableDBPath UTF8String], &db)，sqlite3_open函数的第1个参数是 数据库文件完整的路径，但是需要注意的是在SQLite3函数中接受的是char*的UTF-8类型数据，需要将NSString*转换为UTF-8，使 用NSString*的UTF8String方法可以转换，sqlite3_open函数第2个参数sqlite3指针变量db的地址。该函数的返回值是 int类型，在SQLite3中定义了很多常量，返回值等于常量SQLITE_OK则说明操作成功。

第2步执行建表语句，代码第④行，语句 sqlite3_exec(db,[createSQL UTF8String],NULL,NULL,&err)执行建表的SQL。第1个参数 是sqlite3指针变量db的地址，第2个参数是要执行的sql语句，第3个参数是要回调函数，第4个参数是要回调函数的参数，第5个参数是执行出错的 字符串。建表SQL语句是，如果表Note存在这不用创建。

CREATE TABLE IF NOT EXISTS Note (cdate TEXT PRIMARY KEY, content TEXT)

第3步使用sqlite3_close函数释放资源，代码②、⑤、⑦行所示，在数据库打开失败、Create Table执行失败和成功执行完成时候调用。原则上无论正常结束还是异常结束必须使用sqlite3_close函数释放资源。

查询数据

数据查询一般会带有查询条件，这个使用SQL语句where子句很容易实现，但是在程序中需要动态绑定参数给where子句。执行查询数据步骤如下：

1、使用sqlite3_open函数打开数据库；

2、使用sqlite3_prepare_v2函数预处理SQL语句；

3、使用sqlite3_bind_text函数绑定参数；

4、使用sqlite3_step函数执行SQL语句，遍历结果集；

5、使用sqlite3_column_text等函数提取字段数据；

6、使用sqlite3_finalize和sqlite3_close函数释放资源。

NoteDAO.m中的按照主键查询数据方法：

Cpp代码  收藏代码
  1. -(Note*) findById:(Note*)model  
  2.   
  3. {  
  4.   
  5. NSString *path = [self applicationDocumentsDirectoryFile];  
  6.   
  7. if (sqlite3_open([path UTF8String], &db) != SQLITE_OK) { ①  
  8.   
  9. sqlite3_close(db);  ②  
  10.   
  11. NSAssert(NO,@”数据库打开失败。”);  
  12.   
  13. } else {  
  14.   
  15.    
  16.   
  17. NSString *qsql = @”SELECT cdate,content FROM Note where cdate =?”;  
  18.   
  19.    
  20.   
  21. sqlite3_stmt *statement;  
  22.   
  23. //预处理过程  
  24.   
  25. if (sqlite3_prepare_v2(db, [qsql UTF8String], -1, &statement, NULL) == SQLITE_OK) { ③  
  26.   
  27. //准备参数  
  28.   
  29. NSDateFormatter *dateFormatter = [[NSDateFormatter alloc] init]; ④  
  30.   
  31. [dateFormatter setDateFormat:@"yyyy-MM-dd HH:mm:ss"];  
  32.   
  33. NSString *nsdate = [dateFormatter stringFromDate:model.date];  
  34.   
  35. //绑定参数开始  
  36.   
  37. sqlite3_bind_text(statement, 1, [nsdate UTF8String], -1, NULL); ⑤  
  38.   
  39. //执行  
  40.   
  41. if (sqlite3_step(statement) == SQLITE_ROW) { ⑥  
  42.   
  43. char *cdate = (char *) sqlite3_column_text(statement, 0); ⑦  
  44.   
  45. NSString *nscdate = [[NSString alloc] initWithUTF8String: cdate];  
  46.   
  47.    
  48.   
  49. char *content = (char *) sqlite3_column_text(statement, 1);  
  50.   
  51. NSString * nscontent = [[NSString alloc] initWithUTF8String: content];  
  52.   
  53. Note* note = [[Note alloc] init];  
  54.   
  55. note.date = [dateFormatter dateFromString:nscdate];  
  56.   
  57. note.content = nscontent;  
  58.   
  59.    
  60.   
  61. sqlite3_finalize(statement);  
  62.   
  63. sqlite3_close(db);  
  64.   
  65. return note;  
  66.   
  67. }  
  68.   
  69. }  
  70.   
  71.    
  72.   
  73. sqlite3_finalize(statement); ⑧  
  74.   
  75. sqlite3_close(db);  ⑨  
  76.   
  77.    
  78.   
  79. }  
  80.   
  81. return nil;  
  82.   
  83. }  



该方法执行了6个步骤，其中第1个步骤，代码第①行所示，它与创建数库的第1个步骤是一样的，不用再介绍了。

第 2个步骤，代码第③行所示，语句 sqlite3_prepare_v2(db, [qsql UTF8String], -1, &statement, NULL)是预处理 SQL语句，预处理目的是将SQL编译成二进制代码，提高SQL语句执行的速度。sqlite3_prepare_v2函数的第3个参数-1代表全部 sql字符串长度，第4个参数&statement是sqlite3_stmt指针的地址，它是语句对象，通过语句对象可以执行SQL语句，第5 个参数是sql语句没有被执行的部分语句。

第3个步骤，代码第⑤行所示，语句sqlite3_bind_text(statement, 1, [nsdate UTF8String], -1, NULL)是绑定SQL语句参数。在SQL语句中带有问号，这个问号就是要绑定的参数，问号是占位符。

NSString *qsql = @”SELECT cdate,content FROM Note where cdate =?”;

sqlite3_bind_text函数是绑定参数，第1个参数是statement指针，第2个参数为序号（从1开始），第3个参数为字符串值，第4个参数为字符串长度，第5个参数为一个函数指针。

第4个步骤sqlite3_step(statement)执行SQL语句，代码第⑥行所示，sqlite3_step返回int类型，等于SQLITE_ROW说明还要其它的行没有遍历。

第 5个步骤提取字段数据，代码第⑦行所示，使用sqlite3_column_text(statement, 0)函数可以读取字符串类型字段，第2参数 是指定select字段的索引（从0开始）。同样char*转换成为NSString*类型，需要initWithUTF8String:构造方法。读取 字段函数采用与字段类型有关系，SQLite3的类似的常用函数还有：

sqlite3_column_blob()

sqlite3_column_double()

sqlite3_column_int()

sqlite3_column_int64()

sqlite3_column_text()

sqlite3_column_text16()

关于其它的API可以参考http://www.sqlite.org/cintro.html。

第6个步骤是释放资源，创建数据库过程不同,除了使用sqlite3_close函数关闭数据库，代码第⑧行所示，还要使用sqlite3_finalize函数释放语句对象statement代码第⑨行所示。

NoteDAO.m中的查询所有数据方法：

Cpp代码  收藏代码
  1. -(NSMutableArray*) findAll  
  2.   
  3. {  
  4.   
  5. NSString *path = [self applicationDocumentsDirectoryFile];  
  6.   
  7. NSMutableArray *listData = [[NSMutableArray alloc] init];  
  8.   
  9. if (sqlite3_open([path UTF8String], &db) != SQLITE_OK) {  
  10.   
  11. sqlite3_close(db);  
  12.   
  13. NSAssert(NO,@”数据库打开失败。”);  
  14.   
  15. } else {  
  16.   
  17.    
  18.   
  19. NSString *qsql = @”SELECT cdate,content FROM Note”;  
  20.   
  21.    
  22.   
  23. sqlite3_stmt *statement;  
  24.   
  25. //预处理过程  
  26.   
  27. if (sqlite3_prepare_v2(db, [qsql UTF8String], -1, &statement, NULL) == SQLITE_OK) {  
  28.   
  29. NSDateFormatter *dateFormatter = [[NSDateFormatter alloc] init];  
  30.   
  31. [dateFormatter setDateFormat:@"yyyy-MM-dd HH:mm:ss"];  
  32.   
  33. //执行  
  34.   
  35. while (sqlite3_step(statement) == SQLITE_ROW) {  
  36.   
  37. char *cdate = (char *) sqlite3_column_text(statement, 0);  
  38.   
  39. NSString *nscdate = [[NSString alloc] initWithUTF8String: cdate];  
  40.   
  41.    
  42.   
  43. char *content = (char *) sqlite3_column_text(statement, 1);  
  44.   
  45. NSString * nscontent = [[NSString alloc] initWithUTF8String: content];  
  46.   
  47. Note* note = [[Note alloc] init];  
  48.   
  49. note.date = [dateFormatter dateFromString:nscdate];  
  50.   
  51. note.content = nscontent;  
  52.   
  53. [listData addObject:note];  
  54.   
  55. }  
  56.   
  57. }  
  58.   
  59.    
  60.   
  61. sqlite3_finalize(statement);  
  62.   
  63. sqlite3_close(db);  
  64.   
  65.    
  66.   
  67. }  
  68.   
  69. return listData;  
  70.   
  71. }  



查询所有数据方法与按照主键查询数据方法类似，区别在于本方法没有查询条件不需要绑定参数。遍历的时候使用while循环语句，不是if语句。

while (sqlite3_step(statement) == SQLITE_ROW) {

… …

}

修改数据 

修改数据包括：insert、update和delete语句。这3个SQL语句都可以带有参数，关于参数的绑定与查询where子句绑定的方式是一样的。执行修改数据步骤如下：

1、使用sqlite3_open函数打开数据库；

2、使用sqlite3_prepare_v2函数预处理SQL语句；

3、使用sqlite3_bind_text函数绑定参数；

4、使用sqlite3_step函数执行SQL语句；

5、使用sqlite3_finalize和sqlite3_close函数释放资源。

修改数据的步骤与查询数据的步骤相比少了一个提取字段数据步骤。下面我们看看代码部分。其它的步骤是一样的。

NoteDAO.m中的插入Note方法：

Cpp代码  收藏代码
  1. -(int) create:(Note*)model  
  2.   
  3. {  
  4.   
  5. NSString *path = [self applicationDocumentsDirectoryFile];  
  6.   
  7. if (sqlite3_open([path UTF8String], &db) != SQLITE_OK) { ①  
  8.   
  9. sqlite3_close(db);  ②  
  10.   
  11. NSAssert(NO,@”数据库打开失败。”);  
  12.   
  13. } else {  
  14.   
  15.    
  16.   
  17. NSString *sqlStr = @”INSERT OR REPLACE INTO note (cdate, content) VALUES (?,?)”;  
  18.   
  19.    
  20.   
  21. sqlite3_stmt *statement;  
  22.   
  23. //预处理过程  
  24.   
  25. if (sqlite3_prepare_v2(db, [sqlStr UTF8String], -1, &statement, NULL) == SQLITE_OK) { ③  
  26.   
  27. NSDateFormatter *dateFormatter = [[NSDateFormatter alloc] init];  
  28.   
  29. [dateFormatter setDateFormat:@"yyyy-MM-dd HH:mm:ss"];  
  30.   
  31. NSString *nsdate = [dateFormatter stringFromDate:model.date];  
  32.   
  33. //绑定参数开始  
  34.   
  35. sqlite3_bind_text(statement, 1, [nsdate UTF8String], -1, NULL);  ④  
  36.   
  37. sqlite3_bind_text(statement, 2, [model.content UTF8String], -1, NULL);  
  38.   
  39.    
  40.   
  41. //执行插入  
  42.   
  43. if (sqlite3_step(statement) != SQLITE_DONE) { ⑤  
  44.   
  45. NSAssert(NO, @”插入数据失败。”);  
  46.   
  47. }  
  48.   
  49. }  
  50.   
  51.    
  52.   
  53. sqlite3_finalize(statement);  ⑥  
  54.   
  55. sqlite3_close(db);  ⑦  
  56.   
  57. }  
  58.   
  59. return 0;  
  60.   
  61. }  



第⑤行代码sqlite3_step(statement)语句执行插入语句，常量SQLITE_DONE执行完成。

NoteDAO.m中的删除Note方法：

Cpp代码  收藏代码
    1. -(int) remove:(Note*)model  
    2.   
    3. {  
    4.   
    5. NSString *path = [self applicationDocumentsDirectoryFile];  
    6.   
    7. if (sqlite3_open([path UTF8String], &db) != SQLITE_OK) {  
    8.   
    9. sqlite3_close(db);  
    10.   
    11. NSAssert(NO,@”数据库打开失败。”);  
    12.   
    13. } else {  
    14.   
    15.    
    16.   
    17. NSString *sqlStr = @”DELETE  from note where cdate =?”;  
    18.   
    19.    
    20.   
    21. sqlite3_stmt *statement;  
    22.   
    23. //预处理过程  
    24.   
    25. if (sqlite3_prepare_v2(db, [sqlStr UTF8String], -1, &statement, NULL) == SQLITE_OK) {  
    26.   
    27. NSDateFormatter *dateFormatter = [[NSDateFormatter alloc] init];  
    28.   
    29. [dateFormatter setDateFormat:@"yyyy-MM-dd HH:mm:ss"];  
    30.   
    31. NSString *nsdate = [dateFormatter stringFromDate:model.date];  
    32.   
    33. //绑定参数开始  
    34.   
    35. sqlite3_bind_text(statement, 1, [nsdate UTF8String], -1, NULL);  
    36.   
    37. //执行插入  
    38.   
    39. if (sqlite3_step(statement) != SQLITE_DONE) {  
    40.   
    41. NSAssert(NO, @”删除数据失败。”);  
    42.   
    43. }  
    44.   
    45. }  
    46.   
    47.    
    48.   
    49. sqlite3_finalize(statement);  
    50.   
    51. sqlite3_close(db);  
    52.   
    53. }  
    54.   
    55. return 0;  
    56.   
    57. }  
    58.   
    59. NoteDAO.m中的修改Note方法：  
    60.   
    61. -(int) modify:(Note*)model  
    62.   
    63. {  
    64.   
    65. NSString *path = [self applicationDocumentsDirectoryFile];  
    66.   
    67. if (sqlite3_open([path UTF8String], &db) != SQLITE_OK) {  
    68.   
    69. sqlite3_close(db);  
    70.   
    71. NSAssert(NO,@”数据库打开失败。”);  
    72.   
    73. } else {  
    74.   
    75.    
    76.   
    77. NSString *sqlStr = @”UPDATE note set content=? where cdate =?”;  
    78.   
    79.    
    80.   
    81. sqlite3_stmt *statement;  
    82.   
    83. //预处理过程  
    84.   
    85. if (sqlite3_prepare_v2(db, [sqlStr UTF8String], -1, &statement, NULL) == SQLITE_OK) {  
    86.   
    87. NSDateFormatter *dateFormatter = [[NSDateFormatter alloc] init];  
    88.   
    89. [dateFormatter setDateFormat:@"yyyy-MM-dd HH:mm:ss"];  
    90.   
    91. NSString *nsdate = [dateFormatter stringFromDate:model.date];  
    92.   
    93. //绑定参数开始  
    94.   
    95. sqlite3_bind_text(statement, 1, [model.content UTF8String], -1, NULL);  
    96.   
    97. sqlite3_bind_text(statement, 2, [nsdate UTF8String], -1, NULL);  
    98.   
    99. //执行插入  
    100.   
    101. if (sqlite3_step(statement) != SQLITE_DONE) {  
    102.   
    103. NSAssert(NO, @”修改数据失败。”);  
    104.   
    105. }  
    106.   
    107. }  
    108.   
    109.    
    110.   
    111. sqlite3_finalize(statement);  
    112.   
    113. sqlite3_close(db);  
    114.   
    115. }  
    116.   
    117. return 0;  
    118.   
    119. }  
【推广】 免费学中医，健康全家人
原文地址：https://www.cnblogs.com/oc-bowen/p/5345972.html