【iOS】FMDB

1.简介

FMDB 是一款简单，易用的封装库。它是对libsalite3框架的封装。

2.优点

1.对多线程的并发操作进行处理，线程是安全的
2.用OC语言封装C语言的API,更方便使用。
3.FMDB轻量级，使用灵活。

3.主要类

1.FMDatabase：一个FMDatabase对象就代表一个单独的SQLite数据库，用来执行SQL语句。
2.FMResultSet：使用FMDatabase执行查询后的结果集。
3.FMDatabaseQueue：用于在多线程中执行多个查询或更新，它是线程安全的。

4.使用步骤

1.将FMDB导入到项目中
2.导入libsqlite3.0框架，导入头文件FMDatabase.h
3.代码实现（创建库路径 > 创建数据库 > 打开数据库 > 创建表 > 对数据库进行增删改查 > 关闭数据库）

5.代码

1.创建数据库、创建表

#pragma mark - 创建数据库、创建表
- (void)creatTable {
    // 创建数据库
    // 1、找到数据库存储路径
    NSString *document = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) objectAtIndex:0];
    NSLog(@"document %@", document);
    self.filePath = [document stringByAppendingPathComponent:@"student.sqlite"];
    // 2、使用路径初始化FMDB对象
    self.dataBase = [FMDatabase databaseWithPath:self.filePath];
    // 3、判断数据库是否打开，打开时才执行sql语句
    if ([self.dataBase open]) {
        // 1、创建建表sql语句
        NSString *createSql = @"create table if not exists t_student(id integer primary key autoincrement not null, name text not null, age integer not null, sex text not null)";
        BOOL result = [self.dataBase executeUpdate:createSql];
        if (result) {
            NSLog(@"建表成功");
        } else {
            NSLog(@"建表失败 %d", result);
        }
    }
    // 关闭数据库
    [self.dataBase close];
}

2. 一切不是SELECT命令的命令都视为更新。这包括 CREAT,UPDATE,INSERT,ALTER,BEGIN,COMMIT,DETACH,DELETE,DROP,END,EXPLAIN,VACUUM,REPLACE等。
   简单来说，只要不是以SELECT开头的命令都是更新命令。
   更新方法有一下几种：

//1.executeUpdate:  不确定的参数用？来占位（后面参数必须是oc对象，；代表语句结束）
   [self.db executeUpdate:@“INSERT INTO t_student (name, age) VALUES (?,?);”,name,@(age)];

 //2.executeUpdateWithFormat：不确定的参数用%@，%d等来占位 （参数为原始数据类型，执行语句不区分大小写）
   [self.db executeUpdateWithFormat:@“insert into t_student (name,age) values (%@,%i);”, name,age];  

  //3.数组
   [self.db executeUpdate:@“INSERT INTO t_student(name,age) VALUES  (?,?);”  withArgumentsInArray:@[name, @(age)]];

#pragma mark - 增
- (IBAction)insertIntoAction:(id)sender {
    // 1、打开数据库
    [self.dataBase open];
    // 2、进行相关操作
    NSArray *nameArray = @[@"MBBoy", @"Boom Sky", @"小明"];
    for (int i = 0; i < nameArray.count; i++) {
        NSString *name = nameArray[i];
        // 创建插入语句
        NSString *insertSql = @"insert into t_student(name, age, sex) values (?, ?, ?)";
        BOOL result = [self.dataBase executeUpdate:insertSql, name, @69, @"男"];
        if (result) {
            NSLog(@"学生%@添加成功", name);
        } else {
            NSLog(@"学生%@添加失败, %d", name, result);
        }
    }
    // 关闭数据库
    [self.dataBase close];
}

#pragma mark - 删
- (IBAction)updateAction:(id)sender {
    // 打开数据库
    [self.dataBase open];
    BOOL result = [self.dataBase executeUpdate:@"delete from user where name = ?", @"MBBoy"];
    if (result) {
        NSLog(@"删除成功");
    } else {
        NSLog(@"删除失败 %d", result);
    }
    // 关闭数据库
    [self.dataBase close];
}

#pragma mark - 改
- (IBAction)updateAction:(id)sender {
    // 打开数据库
    [self.dataBase open];
    BOOL result = [self.dataBase executeUpdate:@"update t_student set name = ? where name = ?", @"mlx", @"MBBoy"];
    if (result) {
        NSLog(@"更新成功");
    } else {
        NSLog(@"更新失败 %d", result);
    }
    // 关闭数据库
    [self.dataBase close];
}

#pragma mark - 查单个
- (IBAction)searchStudentAction:(id)sender {
    // 打开数据库
    [self.dataBase open];
    // 接收查询结果的类 -- FMResultSet
    FMResultSet *resultSet = [self.dataBase executeQuery:@"select * from t_student where name = ?", @"小明"];
    if (resultSet) {
        // 遍历出需要的结果内容
        while ([resultSet next]) {
            NSString *name = [resultSet objectForColumnName:@"name"];
            NSInteger age = [resultSet intForColumn:@"age"];
            NSString *sex = [resultSet objectForColumnIndex:3];
            NSLog(@"name = %@, age = %ld, sex = %@", name, age, sex);
        }
    } else {
        NSLog(@"查询失败");
    }
    // 关闭数据库
    [self.dataBase close];
}


#pragma mark - 查所有
- (IBAction)searchAllStudentsAction:(id)sender {
    // 打开数据库
    [self.dataBase open];
    // 接收查询结果的类 -- FMResultSet
    FMResultSet *resultSet = [self.dataBase executeQuery:@"select * from t_student"];
    if (resultSet) {
        // 遍历出需要的结果内容
        while ([resultSet next]) {
            NSString *name = [resultSet objectForColumnName:@"name"];
            NSInteger age = [resultSet intForColumn:@"age"];
            NSString *sex = [resultSet objectForColumnIndex:3];
            NSLog(@"name = %@, age = %ld, sex = %@", name, age, sex);
        }
    } else {
        NSLog(@"查询失败");
    }
    // 关闭数据库
    [self.dataBase close];
}

3.删除表

1 //如果表格存在 则销毁
2 [self.db executeUpadate:@“drop table if exists t_student;”]; 

6.线程安全

如果应用使用多线程操作数据库就得需要FMDatabaseQueue 是用来来保障线程安全，不可以在多个线程中共同使用一个FMDatabase对象操作数据库。

#pragma mark - 以队列形式插入多个学生，这种方式添加数据是FMDB比较常用的添加方式，
// FMDB不支持多个线程同时操作，所以一般以串行的方式实现相关操作
- (IBAction)insertStudnetWithQueue:(id)sender {
    // 打开数据库
    [self.dataBase open];
    // 创建操作队列
    FMDatabaseQueue * queue = [FMDatabaseQueue databaseQueueWithPath:self.filePath];
    // 记录插入操作是否成功
    __block BOOL isSuccess = YES;
    // 把任务包装到事务里
    [queue inTransaction:^(FMDatabase *db, BOOL *rollback) {
        
        // 串行队列
        isSuccess = [db executeUpdate:@"insert into t_student(name, age, sex) values (?, ?, ?)", @"隔壁老王", @38, @"男"] && isSuccess;
        isSuccess = [db executeUpdate:@"insert into t_student(name, age, sex) values (?, ?, ?)", @"-1", @438, @"男"] && isSuccess;
        isSuccess = [db executeUpdate:@"insert into t_student(name, age, sex) values (?, ?, ?)", @"Rose", @18, @"女"] && isSuccess;
        
        if (!isSuccess) {
            // 如果插入不成功，对rollback(bool类型的指针)进行处理
            // 如果有一条语句不成功，就回滚，撤销所有插入语句执行的结果都取消
            *rollback = YES;
            return;
        }
    }];
    [self.dataBase close];
}

7.总结

FMDB 是在 iOS 开发中尝尝用到的数据库，因其灵活性，管理起来比较方便使用。