iOS 开发 -- SQLite 重要框架 FMDB 的使用

1,788 阅读4分钟
原文链接: www.jianshu.com
什么是FMDB:

FMDB是一个和iOS的SQLite数据库操作相关的第三方框架。主要把C语言操作数据库的代码用OC进行了封装。使用者只需调用该框架的API就能用来创建并连接数据库,创建表,查询等。

为什么要使用FMDB

1、轻量级,灵活。不消耗太多性能
2、FMDB将C语言的iOS系统的SQLite数据库的操作代码用OC进行封装,面向对象,容易理解和使用
3、提供了线程不安全的解决方案。

该框架有三个重要的类

1、FMDatabase
一个FMDatabase对象就代表一个单独的SQLite数据库,通过下面代码添加一个FMDatabase

首先声明为对象

///创建一个dataBase的一个全局对象

   var db : FMDatabase?

然后在openDB方法中初始化
func openDB(dbName : String){
        ///给路径后面加一个!
        let path = NSSearchPathForDirectoriesInDomains(.DocumentDirectory, .UserDomainMask, true).last!

  print(path)

        ///创建一个dbBase的数据库的对象
  db = FMDatabase(path:"\(path)/\(dbName)")
        ///判断是否创建成功,需要强制解包
  if db!.open() {
          print("数据库创建成功")
  }else{
          print("数据库创建失败")
  }
    }

2、FMResultSet
使用FMDatabase执行查询后,得到结果集
3、FMDatabaseQueue
用于解决线程不安全的类,避免每个线程创建一个数据库,导致数据库冗余。

下面是两个重要的方法,用于执行sqlite语句,我们在插入数据和查询数据的时候都需要使用到该方法。

///查询数据
  class func query() -> [[String : AnyObject]]{

    let sql = "SELECT * FROM t_emotion"
    var resultArray: [[String : AnyObject]] = []

  FMDBQueueManager.shareFMDBQueueManager.dbQueue?.inDatabase({ (db)->Void in

     ///执行查询
      if let result = try? db.executeQuery(sql, values: []){
      ///简历查询后的数据
        while result.next(){
          ///获取数据
        let png = result.stringForColumn("png")
        let text = result.stringForColumn("text")
          let dict = ["png": png, "text": text]
          resultArray.append(dict)
        }
      }
    })
    ///查找到数据后将数据返回
    return resultArray
  }

下面这一份代码是FMBD的常见用法,我们使用FMDB框架来创建一个本地数据库,然后给该数据库中插入一百条数据。然后执行查询方法,来查找我们需要用到的数据。
我们在ViewController中调用插入数据和查询数据的方法。

import UIKit

class ViewController: UIViewController {

  override func viewDidLoad() {
    super.viewDidLoad()
    insert()
    query()
  }

  func insert(){

    for i in 0...100 {
      let emotion = FMDBModel(dict: ["png" : "啊啊啊哈\(i).png","text": "hahh\(i)"])
      emotion.insert()
    }
  }

  func query(){
    let dataArray = FMDBModel.query()
    print(dataArray)
  }
}

下面这一份代码是一个FMDBQueueManager管理类,我们在管理类中openDB(可以理解为打开数据库),然后creatTable创建一个表格。

import UIKit
import FMDB

class FMDBQueueManager: NSObject {

  static let shareFMDBQueueManager = FMDBQueueManager()

  var dbQueue : FMDatabaseQueue?

  func openDB(dbName : String){

    let path = NSSearchPathForDirectoriesInDomains(.DocumentDirectory, .UserDomainMask, true).last!
    print(path)
    dbQueue = FMDatabaseQueue(path: "\(path)/\(dbName)")

    createTable()
  }

  func createTable () {
    let sql = "CREATE TABLE IF NOT EXISTS t_emotion ('id' integer NOT NULL,'png' text NOT NULL,'text' text NOT NULL,PRIMARY KEY('id'))"
    dbQueue?.inDatabase({ (db) -> Void in
      try! db.executeUpdate(sql, values: [])
    })
  }

}

下面是FMDB模型类的代码,我们需要给模型添加一个属性,就在该类中添加。模型类需要实现 setValuesForKeysWithDictionary()方法,这一点和OC的用法有点像。除此之外,我们还需要有增加数据,删除数据,添加数据,查询数据的方法。我们将SQLite代码写在let sql = ""中,然后使用FMDB中的FMDBQueueManager来执行SQLite代码。所以使用FMDB框架我们可以更面向对象地来执行SQLite语句。

import UIKit

class FMDBModel: NSObject {

  ///属性
  var png : String?
  var text : String?

  init(dict : [String : AnyObject]) {
    super.init()
    setValuesForKeysWithDictionary(dict)
  }

  override func setValue(value: AnyObject?, forUndefinedKey key: String) { }

  ///给一个插入
  func insert(){

    let sql = "INSERT INTO 't_emotion' ('png', 'text') values ('\(self.png!)', '\(self.text!)')"
    ///下面第一种写法存在线程不安全的问题
//    try! FMDBManager.ShareManager.db?.executeUpdate(sql, values: [])

    ///下面的写法是线程安全的写法
  FMDBQueueManager.shareFMDBQueueManager.dbQueue?.inDatabase({ (db) ->Void in

      try! db.executeUpdate(sql, values: [])
    })
  }

  func delete(){
    let sql = ""
  FMDBQueueManager.shareFMDBQueueManager.dbQueue?.inDatabase({ (db) -> Void in
      try! db.executeUpdate(sql, values: [])
    })
  }

  func update(){
    let sql = ""
    FMDBQueueManager.shareFMDBQueueManager.dbQueue?.inDatabase({ (db) -> Void in
      try! db.executeUpdate(sql, values: [])
    })
  }

  ///查询数据
  class func query() -> [[String : AnyObject]]{

    let sql = "SELECT * FROM t_emotion"
    var resultArray: [[String : AnyObject]] = []

  FMDBQueueManager.shareFMDBQueueManager.dbQueue?.inDatabase({ (db)->Void in

     ///执行查询
      if let result = try? db.executeQuery(sql, values: []){
      ///简历查询后的数据
        while result.next(){
          ///获取数据
        let png = result.stringForColumn("png")
        let text = result.stringForColumn("text")
          let dict = ["png": png, "text": text]
          resultArray.append(dict)
        }
      }
    })
    ///查找到数据后将数据返回
    return resultArray
  }
}

上面是用swift语言来使用FMDB,使用OC来使用FMDB代码逻辑跟上面相同。使用swift主要是最近开发中使用到了swift语言,而且swift在排名上已经和OC不想上下,按照趋势,swift作为强语言替换掉OC弱语言应该是板上钉钉的事。如果swift入门了,使用起swift语言会比OC的代码更简单,逻辑也会更清晰。
下面是demo地址
demo地址