iOS-數據持久化-第三方框架FMDB的使用

FMDB簡單介紹

1、簡單說明

1.什麼是FMDB

FMDB是iOS平臺的SQLite數據庫框架

FMDB以OC的方式封裝了SQLite的C語言API

 

2.FMDB的優勢

使用起來更加面向對象，省去了不少麻煩、冗餘的C語言代碼

對比蘋果自帶的Core Data框架，更加輕量級和靈活

提供了多線程安全的數據庫操做方法，有效地防止數據混亂

 

3.FMDB的github地址

https://github.com/ccgus/fmdb

 

2、核心類

FMDB有三個主要的類

（1）FMDatabase

一個FMDatabase對象就表明一個單獨的SQLite數據庫

用來執行SQL語句

 

（2）FMResultSet

使用FMDatabase執行查詢後的結果集

 

（3）FMDatabaseQueue

用於在多線程中執行多個查詢或更新，它是線程安全的

 

3、打開數據庫

經過指定SQLite數據庫文件路徑來建立FMDatabase對象

FMDatabase *db = [FMDatabase databaseWithPath:path];

if (![db open]) {

    NSLog(@"數據庫打開失敗！");

}

 

文件路徑有三種狀況

（1）具體文件路徑

　　若是不存在會自動建立

 

（2）空字符串@""

　　會在臨時目錄建立一個空的數據庫

　　當FMDatabase鏈接關閉時，數據庫文件也被刪除

 

（3）nil

　　會建立一個內存中臨時數據庫，當FMDatabase鏈接關閉時，數據庫會被銷燬

 

4、執行更新

在FMDB中，除查詢之外的全部操做，都稱爲「更新」

create、drop、insert、update、delete等

 

使用executeUpdate:方法執行更新

- (BOOL)executeUpdate:(NSString*)sql, ...

- (BOOL)executeUpdateWithFormat:(NSString*)format, ...

- (BOOL)executeUpdate:(NSString*)sql withArgumentsInArray:(NSArray *)arguments

 

示例

[db executeUpdate:@"UPDATE t_student SET age = ? WHERE name = ?;", @20, @"Jack"]

 

5、執行查詢

查詢方法

- (FMResultSet *)executeQuery:(NSString*)sql, ...

- (FMResultSet *)executeQueryWithFormat:(NSString*)format, ...

- (FMResultSet *)executeQuery:(NSString *)sql withArgumentsInArray:(NSArray *)arguments

 

示例

// 查詢數據

FMResultSet *rs = [db executeQuery:@"SELECT * FROM t_student"];

 

// 遍歷結果集

while ([rs next]) {

    NSString *name = [rs stringForColumn:@"name"];

    int age = [rs intForColumn:@"age"];

    double score = [rs doubleForColumn:@"score"];

}

 

6、代碼示例

1.新建一個項目，導入libsqlite3庫，並在項目中包含主頭文件

2.下載第三方框架FMDB

　　

3.示例代碼

　　YYViewController.m文件

 1 //
 2 //  YYViewController.m
 3 //  04-FMDB基本使用
 4 //
 5 //  Created by apple on 14-7-27.
 6 //  Copyright (c) 2014年 wendingding. All rights reserved.
 7 //
 8 
 9 #import "YYViewController.h"
10 #import "FMDB.h"
11 
12 @interface YYViewController ()
13 @property(nonatomic,strong)FMDatabase *db;
14 @end
15 
16 @implementation YYViewController
17 
18 - (void)viewDidLoad
19 {
20     [super viewDidLoad];
21     //1.得到數據庫文件的路徑
22     NSString *doc=[NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject];
23     NSString *fileName=[doc stringByAppendingPathComponent:@"student.sqlite"];
24     
25     //2.得到數據庫
26     FMDatabase *db=[FMDatabase databaseWithPath:fileName];
27     
28     //3.打開數據庫
29     if ([db open]) {
30         //4.創表
31         BOOL result=[db executeUpdate:@"CREATE TABLE IF NOT EXISTS t_student (id integer PRIMARY KEY AUTOINCREMENT, name text NOT NULL, age integer NOT NULL);"];
32         if (result) {
33             NSLog(@"創表成功");
34         }else
35         {
36             NSLog(@"創表失敗");
37         }
38     }
39     self.db=db;
40 
41 }
42 
43 -(void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event
44 {
45     [self delete];
46     [self insert];
47     [self query];
48 }
49 
50 //插入數據
51 -(void)insert
52 {
53     for (int i = 0; i<10; i++) {
54         NSString *name = [NSString stringWithFormat:@"jack-%d", arc4random_uniform(100)];
55         // executeUpdate : 不肯定的參數用?來佔位
56         [self.db executeUpdate:@"INSERT INTO t_student (name, age) VALUES (?, ?);", name, @(arc4random_uniform(40))];
57         //        [self.db executeUpdate:@"INSERT INTO t_student (name, age) VALUES (?, ?);" withArgumentsInArray:@[name, @(arc4random_uniform(40))]];
58         
59         // executeUpdateWithFormat : 不肯定的參數用%@、%d等來佔位
60         //        [self.db executeUpdateWithFormat:@"INSERT INTO t_student (name, age) VALUES (%@, %d);", name, arc4random_uniform(40)];
61     }
62 }
63 
64 //刪除數據
65 -(void)delete
66 {
67     //    [self.db executeUpdate:@"DELETE FROM t_student;"];
68     [self.db executeUpdate:@"DROP TABLE IF EXISTS t_student;"];
69     [self.db executeUpdate:@"CREATE TABLE IF NOT EXISTS t_student (id integer PRIMARY KEY AUTOINCREMENT, name text NOT NULL, age integer NOT NULL);"];
70 }
71 
72 //查詢
73 - (void)query
74 {
75     // 1.執行查詢語句
76     FMResultSet *resultSet = [self.db executeQuery:@"SELECT * FROM t_student"];
77     
78     // 2.遍歷結果
79     while ([resultSet next]) {
80         int ID = [resultSet intForColumn:@"id"];
81         NSString *name = [resultSet stringForColumn:@"name"];
82         int age = [resultSet intForColumn:@"age"];
83         NSLog(@"%d %@ %d", ID, name, age);
84     }
85 }
86 
87 @end

打印查看結果：

提示：

若是ID設置爲逐漸，且設置爲自動增加的話，那麼把表中的數據刪除後，從新插入新的數據，ID的編號不是從0開始，而是接着以前的ID進行編號。

注意：

　　不要寫成下面的形式，不要加''，直接使用%@,它會自動認爲這是一個字符串。

 --------------------------------------------------------------------------------------------------------------------------------------------------------------

FMDB數據庫隊列

1、代碼示例

1.須要先導入FMDB框架和頭文件，因爲該框架依賴於libsqlite庫，因此還應該導入該庫。

2.代碼以下：

 1 //
 2 //  YYViewController.m
 3 //  05-FMDB數據庫隊列
 4 //
 5 //  Created by apple on 14-7-28.
 6 //  Copyright (c) 2014年 wendingding. All rights reserved.
 7 //
 8 
 9 #import "YYViewController.h"
10 #import "FMDB.h"
11 
12 @interface YYViewController ()
13 @property(nonatomic,strong)FMDatabaseQueue *queue;
14 @end
15 
16 @implementation YYViewController
17 
18 - (void)viewDidLoad
19 {
20     [super viewDidLoad];
21     
22     //1.得到數據庫文件的路徑
23     NSString *doc=[NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject];
24     NSString *fileName=[doc stringByAppendingPathComponent:@"person.sqlite"];
25     
26     //2.得到數據庫隊列
27     FMDatabaseQueue *queue=[FMDatabaseQueue databaseQueueWithPath:fileName];
28 //    FMDatabase *db=[FMDatabase databaseWithPath:fileName];
29     
30     //3.打開數據庫
31     [queue inDatabase:^(FMDatabase *db) {
32          BOOL result=[db executeUpdate:@"CREATE TABLE IF NOT EXISTS t_person (id integer PRIMARY KEY AUTOINCREMENT, name text NOT NULL, age integer NOT NULL);"];
33         if (result) {
34             NSLog(@"創表成功");
35         }else
36         {
37             NSLog(@"創表失敗");
38         }
39     }];
40     self.queue=queue;
41     
42 }
43 
44 -(void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event
45 {
46     //插入數據
47 //    [self.queue inDatabase:^(FMDatabase *db) {
48 //        [db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);",@"wendingding", @22];
49 //    }];
50     
51     //查詢數據
52     [self.queue inDatabase:^(FMDatabase *db) {
53         // 1.執行查詢語句
54         FMResultSet *resultSet = [db executeQuery:@"SELECT * FROM t_person"];
55 
56         // 2.遍歷結果
57         while ([resultSet next]) {
58             int ID = [resultSet intForColumn:@"id"];
59             NSString *name = [resultSet stringForColumn:@"name"];
60             int age = [resultSet intForColumn:@"age"];
61             NSLog(@"%d %@ %d", ID, name, age);
62         }
63     }];
64 
65 }
66 
67 @end

先插入數據，以後查詢結果，打印以下：

3.代碼說明

有了一個隊列對象，它的內部自動就擁有一個數據庫對象，且數據庫的操做是線程安全的。

 

2、事務

事務，沒有事務的話會出現問題。

舉例：銀行的例子

 

張三和李四帳戶都有1000塊錢，若是張三要轉帳給李四，須要執行兩條SQL語句，考慮到安全性，要求這兩條魚具要麼所有執行成功，要不所有執行失敗。

事務：把多條語句放到同一個事務中，要麼所有成功，要不所有失敗（若是中途出現問題，那麼會自動回滾）。事務的執行具備原子性。

　　事務代碼處理：

　　把多條語句添加到一個事務中去執行：

1    //插入數據
2     [self.queue inDatabase:^(FMDatabase *db) {
3         [db beginTransaction];
4         [db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);",@"wendingding", @22];
5         [db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);",@"wendingding", @23];
6         [db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);",@"wendingding", @24];
7         [db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);",@"wendingding", @25];
8         [db commit];
9     }];

若是中途出現問題，那麼會自動回滾，也能夠選擇手動回滾。

 1     //插入數據
 2     [self.queue inDatabase:^(FMDatabase *db) {
 3         [db beginTransaction];
 4         [db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);",@"wendingding", @22];
 5         [db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);",@"wendingding", @23];
 6         [db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);",@"wendingding", @24];
 7         [db rollback];
 8         [db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);",@"wendingding", @25];
 9         [db commit];
10     }];

上面的代碼。前三條插入語句是做廢的。

事務處理的另外一種方式：

1    [self.queue inTransaction:^(FMDatabase *db, BOOL *rollback) {
2         [db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);",@"wendingding", @22];
3         [db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);",@"wendingding", @23];
4         [db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);",@"wendingding", @24];
5     }];

說明：先開事務，再開始事務，以後執行block中的代碼段，最後提交事務。