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
作者:青玉伏案
出处:http://www.cnblogs.com/ludashi/
本文版权归作者和共博客园共有,欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文连接,否则保留追究法律责任的权利。
如果文中有什么错误,欢迎指出。以免更多的人被误导。
收简历:坐标美团(北京总部),长期招聘FE/iOS/Android靠谱工程师,入职后,可内部联系楼主,有小礼品赠送,有意者可邮箱投递简历:zeluli@foxmail.com