什么是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
------------