iOS开发之SQLite--C语言接口规范(五)——iOS开发使用SQLite实例

  本篇博客就使用前面操作SQLite的知识来实现如何去插入,删除和更新数据。然后再把操作SQlite数据库常用的方法进行一个封装。把常用方法进行封装后,把Cars数据库中的其中一个表的数据进行查询,并在UITableView上进行展示。因为本实例要对数据库的数据进行modify(修改)操作 ,在iOS系统上呢,为了安全起见,在Bundle中的数据库资源是不允许进行数据的插入修改和删除操作的。在之前的博客中我们只进行了查询操作,所以从Bundle加载数据库资源文件是可行的。

  如果对数据库进程insert, update, delete等操作,那么需要在打开数据库之前把Bundle中的数据库拷贝到沙盒中(每个App都有自己的沙盒,在没有越狱的机器上,App只可以访问自己的沙盒,这也是iOS比较安全的地方之一)。今天这篇博客会封装出一个操作SQLite数据库的工具类,并且调用这个工具类对数据库进行增删改查,实现一个小的实例。废话少说,直奔主题。

  一、数据库操作工具类

  为了操作数据库更为方便,对数据库操作:打开关闭数据库,无绑定值查询数据库,有绑定值查询数据库,插入数据,删除数据,更新数据等进行了简单的封装。当然有感兴趣的小伙伴可以继续完善,比如加上事务操作等。

  工具类对外接口介绍

  先来看一下封装的工具类对外的接口,然后介绍一下其使用方法。接口代码具体如下所示

 1 //
 2 //  OperationSqliteTools.h
 3 //  SettingBundleDemo
 4 //
 5 //  Created by Mr.LuDashi on 15/8/31.
 6 //  Copyright (c) 2015年 zeluli. All rights reserved.
 7 //
 8 
 9 #import <Foundation/Foundation.h>
10 #import <sqlite3.h>
11 
12 @interface OperationSqliteTools : NSObject
13 
14 /*******************************
15  *功能:打开数据库
16  *参数:databaseName -- 数据库名称
17  *返回:数据库对象(sqlite3对象)
18  *******************************/
19 + (sqlite3 *) openDatabaseWithName: (NSString *)databaseName;
20 
21 /*******************************
22  *功能:关闭数据库
23  *参数:database -- sqlite3 对象
24  *返回:空
25  *******************************/
26 + (void) closeDatabaseWithName: (sqlite3 *)database;
27 
28 /*******************************
29  *功能:查询数据,无绑定变量
30  *参数:database -- sqlite3 对象, SQL:要执行的SQL查询语句
31  *返回:封装成数组的查询数据
32  *******************************/
33 + (NSArray *) queryInfoWithDataBase: (sqlite3 *) database
34                             WithSQL: (NSString *) SQL;
35 
36 
37 /*******************************
38  *功能:查询数据,有绑定变量
39  *参数:database -- sqlite3 对象, SQL:要执行的SQL查询语句,parameter:绑定变量的值
40  *返回:封装成数组的查询数据
41  *******************************/
42 + (NSArray *) queryInfoWithDataBase: (sqlite3 *) database
43                             WithSQL: (NSString *) SQL
44                       WithParameter: (NSArray *)parameter;
45 
46 
47 /*******************************
48  *功能:插入数据
49  *参数:database -- sqlite3 对象, SQL:要执行的SQL插入语句,parameter:绑定变量的值
50  *返回:插入结果,YES:插入成功, NO:插入失败
51  *******************************/
52 + (BOOL) insertDataWithDataBase: (sqlite3 *) database
53                         WithSQL: (NSString *) SQL
54                   WithParameter: (NSArray *)parameter;
55 
56 /*******************************
57  *功能:更新数据
58  *参数:database -- sqlite3 对象, SQL:要执行的SQL插入语句,parameter:绑定变量的值
59  *返回:插入结果,YES:更新成功, NO:更新失败
60  *******************************/
61 + (BOOL) updateDataWithDataBase: (sqlite3 *) database
62                         WithSQL: (NSString *) SQL
63                   WithParameter: (NSArray *)parameter;
64 
65 
66 /*******************************
67  *功能:删除数据
68  *参数:database -- sqlite3 对象, SQL:要执行的SQL插入语句,parameter:绑定变量的值
69  *返回:插入结果,YES:删除成功, NO:删除失败
70  *******************************/
71 + (BOOL) deleteDataWithDataBase: (sqlite3 *) database
72                         WithSQL: (NSString *) SQL
73                   WithParameter: (NSArray *)parameter;
74 
75 /*******************************
76  *功能:打印出查询后的结果
77  *参数:array -- 结果数组
78  *返回:空
79  *******************************/
80 + (void) displayResultWithArray: (NSArray *) array;
81 
82 
83 @end

  二、 接口的具体介绍

    1、打开数据库

     下面的接口是打开数据库功能,把数据库的名字传入如(Cars.sqlite),返回的是一个sqlite3的对象,你可以通过这个对象来对打开的数据库进行操作。在这个方法中,先去沙盒中查看是否有该数据库,如果有就直接打开。如果没有就从Bundle中把数据库资源复制到沙盒中,然后再从沙盒中打开。你要知道在Bundle中是无法去更改数据库中的数据的。下方是对外暴漏的接口。

/*******************************
 *功能:打开数据库
 *参数:databaseName -- 数据库名称
 *返回:数据库对象(sqlite3对象)
 *******************************/
+ (sqlite3 *) openDatabaseWithName: (NSString *)databaseName;

    

    该接口实现的具体方法如下,在关键代码出都加了注释,阅读代码时可以看一下注释,对于代码的东西就不做过多的赘述了。

 1 /*******************************
 2  *功能:打开数据库
 3  *参数:databaseName -- 数据库名称
 4  *返回:数据库对象(sqlite3对象)
 5  *******************************/
 6 + (sqlite3 *) openDatabaseWithName: (NSString *)databaseName{
 7     
 8     //将数据库文件复制到沙盒中
 9     NSFileManager *fileManager = [NSFileManager defaultManager];
10     
11     //获取沙盒路径
12     NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
13     
14     NSString *documentDirectory = paths[0];
15     
16     //拼接出数据库文件在沙盒中的路径
17     NSString *sqlPath = [documentDirectory stringByAppendingPathComponent:databaseName];
18     
19     //判断沙盒中是否已经存在我们要打开的数据库文件
20     BOOL success = [fileManager fileExistsAtPath:sqlPath];
21     
22     //不存在的情况,会从Bundle中把资源复制过去
23     if (!success) {
24         NSString *defautlDBPath = [[[NSBundle mainBundle] resourcePath] stringByAppendingPathComponent:databaseName];
25         
26         NSError *error = nil;
27         
28         success = [fileManager copyItemAtPath:defautlDBPath toPath:sqlPath error:&error];
29         
30         if (!success) {
31             NSLog(@"%@", [error localizedDescription]);
32         }
33     }
34     //把路径转成C字符串
35     const char * filePath = [sqlPath UTF8String];
36     
37     //声明sqlite3对象
38     sqlite3 * database = nil;
39     
40     //打开数据库
41     int result = sqlite3_open_v2(filePath, &database, SQLITE_OPEN_READWRITE | SQLITE_OPEN_CREATE, NULL);
42     
43     //成功打开
44     if (result == SQLITE_OK) {
45         return database;
46     }
47     
48     return nil;
49 }

 

    2.关闭数据库

    关闭数据库就比较简单了,直接把传入的sqlite3对象进行一个关闭即可,具体代码如下:

1 /*******************************
2  *功能:关闭数据库
3  *参数:database -- sqlite3 对象
4  *返回:空
5  *******************************/
6 + (void) closeDatabaseWithName: (sqlite3 *)database{
7     sqlite3_close(database);
8 }

 

   3. 代码好多,博客篇幅有限,就不一一的去往上粘贴代码了,具体代码实现回在GitHub上进行分享,gitHub连接请看本博客的末尾处,在代码中也是在关键部分添加了相应的注释。

 

  三、实例实现

  调用上述简单封装的方法实现实例,对Cars.sqlite数据中其中一个表进行操作。先读取数据库中的数据,在TableView上进行加载,然后可以对数据进行添加和删除操作,更新操作就不做演示了。在插入操作中有如果有这条数据就进行Replace,这变相是一个update操作。

  下方是Demo的运行效果,为了体现数据插入和删除的变化效果,给我们的Cell添加了一个动画效果,便于观察数据的变化。这个Demo也会在Github上进行分享,你可以自己运行去看一下效果。下方是动态的运行效果。为了简化操作,点击加号会有预先设定好的数据进行插入(当然你可以把用户输入的数据进行一个添加),删除的话就是TableView自带的效果删除。

  下方Demo的实现并没有什么困难之处,就是对TableView的简单操作,如果你感兴趣的话,可以从Github上进行clone,然后进行扩展,添加上搜索,更新等功能。关于CoreData的操作就要看之前的博客iOS开发之表视图爱上CoreData》.

 

    gitHub分享地址:https://github.com/lizelu/SQLiteResource

posted @ 2015-09-23 11:22  青玉伏案  阅读(1451)  评论(0编辑  收藏  举报