SQLite数据库框架之FMDB
什么是FMDB？
FMDB是iOS平台的SQLite数据库框架，FMDB以OC的方式封装了SQLite的C语言API。对比苹果自带的Core Data框架，更加轻量级和灵活，使用起来更加面向对象，省去了很多麻烦、冗余的C语言代码。并且FMDB提供了多线程安全的数据库操作方法，能有效地防止数据混乱。
如何集成FMDB？
这里我只写swift中的集成方式，Objective-C类似，只是不需要添加Swift extensions和桥接。
GitHub地址：https://github.com/ccgus/fmdb
方式一：
下载后将fmdb-master/src/fmdb和fmdb-master/src/extra/Swift extensions拖入项目中，添加系统库文件libsqlite3.tbd。如下图所示：
方式二：
通过CocoaPods添加，但是不推荐这种方式，因为这不是官方的。
|
1 2 |
use_frameworks! pod ‘FMDB‘, :git => ‘https://github.com/robertmryan/fmdb.git‘ |
FMDB核心类
FMDatabase: 一个FMDatabase表示一个sqlite数据库，所有对数据库的操作都是通过这个类。
executeStatements: 执行多条sql。
executeQuery: 执行查询语句。
executeUpdate: 执行除查询以外的语句,create, drop, insert, delete, update。
FMDatabaseQueue: 内部封装FMDatabase和串行queue，用于多线程操作数据库，并且提供事务，建议使用这个。
inDatabase: 参数是一个闭包,在闭包里面可以获得FMDatabase对象。
inTransaction: 使用事务。
FMResultSet: 查询的结果集。
通过字段名称获取字段值。
如何使用FMDB？
一、创建表
使用FMDB和使用AFNetworking类似，最好单独创建一个工具类，使用单例进行数据库操作。
新建JFSQLiteManager类，继承NSObject。在这个类中重写构造方法创建FMDatabaseQueue对象，并创建一张数据表JF_Person。表中有4个字段，分别是id（主键）、name、age、height。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 |
import UIKit class JFSQLiteManager: NSObject { /// 创建单例 static let shareManager = JFSQLiteManager() /// 数据库名称 private let dbName = "person.db" /// FMDatabaseQueue对象，用于操作数据库 let dbQueue: FMDatabaseQueue // 构造方法 override init() { // 获取沙盒路径 let documentPath = NSSearchPathForDirectoriesInDomains(NSSearchPathDirectory.DocumentDirectory, NSSearchPathDomainMask.UserDomainMask, true).last! // 拼接数据库完整路径 let dbPath = (documentPath as NSString).stringByAppendingPathComponent(dbName) // 创建FMDatabaseQueue对象，会自动打开数据库，并创建一个串行队列 dbQueue = FMDatabaseQueue(path: dbPath) super.init() // 创建数据表 createTable("JF_Person") } // 创建数据表 - parameter tbName: 表名 private func createTable(tbName: String) { // sql语句 let sql = "CREATE TABLE IF NOT EXISTS \(tbName) ( \n" + "id INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT, \n" + "name TEXT, \n" + "age INTEGER, \n" + "height REAL \n" + ");" // db表示一个数据库 dbQueue.inDatabase { (db) -> Void in // 执行sql语句，创建一张表。返回Bool类型是否创建成功 if db.executeUpdate(sql) { print("建表成功") } else { print("建表失败") } } } } |
然后在AppDelegate中调用这个单例，测试我们的代码
|
1 |
JFSQLiteManager.shareManager |
显示 建表成功！
二、删除表
在JFSQLiteManager类中实现删除表的方法，删除指定表名的数据表。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
// 删除指定数据库 - parameter tbName: 表名 func dropTable(tbName: String) { // sql语句 let sql = "DROP TABLE \(tbName);" // db表示一个数据库 dbQueue.inDatabase { (db) -> Void in // 执行sql语句，创建一张表。返回Bool类型是否创建成功 if db.executeUpdate(sql) { print("删除表成功") } else { print("删除表失败") } } } |
然后在AppDelegate中调用这个方法，测试我们的代码
|
1 |
JFSQLiteManager.shareManager.dropTable("JF_Person") |
显示 删除表成功！
三、增加数据
在JFSQLiteManager类中实现添加数据的方法，插入一条测试数据。这里只是测试学习，所以SQL语句就直接写死了。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
// 添加数据 func insertData() { // sql语句 let sql = "INSERT INTO JF_Person (name, age, height) VALUES (?, ?, ?);" JFSQLiteManager.shareManager.dbQueue.inDatabase { (db) -> Void in if db.executeUpdate(sql, "7ag", 23, 1.95) { print("插入数据成功") // 获取插入数据的主键 let id = db.lastInsertRowId() print("插入数据的id: \(id)") } } } |
然后在AppDelegate中调用这个方法，测试我们的代码
|
1 |
JFSQLiteManager.shareManager.insertData() |
显示 插入数据成功 插入数据的id: 1！
四、删除数据
在JFSQLiteManager类中实现删除数据的方法，删除id = 1的数据。这里只是测试学习，所以SQL语句就直接写死了。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 |
// 删除数据 func deleteData() { // sql语句 let sql = "DELETE FROM JF_Person WHERE id = 1;" JFSQLiteManager.shareManager.dbQueue.inDatabase { (db) -> Void in if db.executeUpdate(sql) { print("删除数据成功") } } } |
然后在AppDelegate中调用这个方法，测试我们的代码
|
1 |
JFSQLiteManager.shareManager.deleteData() |
显示 删除数据成功！
五、修改数据
上面一步我们把添加的数据给删除，所以我们需要再次调用添加数据的方法，添加一条数据以供我们学习测试使用。
在JFSQLiteManager类中实现更新数据的方法，更新id = 1的数据。这里只是测试学习，所以SQL语句就直接写死了。
|
1 2 3 4 5 6 7 8 9 10 11 12 |
// 更新数据 func updateData() { // sql let sql = "UPDATE JF_Person SET name = ‘6ag‘, age = 24, height = 1.92 WHERE id = 1;" JFSQLiteManager.shareManager.dbQueue.inDatabase { (db) -> Void in if db.executeUpdate(sql) { print("更新数据成功") } } } |
然后在AppDelegate中调用这个方法，测试我们的代码
|
1 |
JFSQLiteManager.shareManager.updateData() |
显示 更新数据成功 ！
六、查找数据
上面增、删、改中，我们执行sql语句的方法都是使用executeUpdate。但是查找数据，我们就必须使用executeQuery了。其实不管是神马操作，改变的基本都是SQL语句而已。这一点比起C语言的sqlite API来说，简直是太方便了。如果对于SQL语句不是很熟悉也没关系，在下已经为各位大神准备好了常用SQL语句：http://blog.6ag.cn/1227.html
在JFSQLiteManager类中实现更新数据的方法，查询JF_Person表中所有记录的id，name，age，height字段的值。这里只是测试学习，所以SQL语句就直接写死了。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 |
// 查询数据 func queryData() { // sql let sql = "SELECT id, name, age, height FROM JF_Person;" JFSQLiteManager.shareManager.dbQueue.inDatabase { (db) -> Void in guard let result = db.executeQuery(sql) else { print("没有查询到数据") return } // 获取查询结果 // next() 表示获取一条记录, 返回true表示获取到记录，false表示没有记录。所以我们使用循环来获取所有查询到的数据 while result.next() { let id = result.intForColumn("id") let name = result.stringForColumn("name") let age = result.intForColumn("age") let height = result.doubleForColumn("height") // 打印出查询到的数据 print("id: \(id), name: \(name), age: \(age), height: \(height)") print("------------") } } } |
然后在AppDelegate中调用这个方法，测试我们的代码
|
1 |
JFSQLiteManager.shareManager.queryData() |
打印出
id: 1, name: 6ag, age: 24, height: 1.92
------------