iOS——FMDB的介绍与使用

什么是FMDB

FMDB是iOS平台用OC语言封装了SQLite API的数据库框架，其优点是：

• 面向对象，使用了oc语言，避免了和c打交道
• FMDB是轻量级框架，使用更加灵活、方便
• 提供了多线程的方式来操作数据库，可以防止多线程操作带来的数据混乱
  FMDB同时兼容ARC和非ARC工程，会自动根据工程配置来调整相关的内存管理代码。

FMDB常用类

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

使用方法

• 首先，我们需要导入FMDB库，和配置JSONModel、Masonry那些的方法一样。
• FMDB中对数据库中存储的每一个值都有一个类型
  NULL 值为空值
  INTEGER 值被标识为整数，依据值的大小可以依次被存储1～8个字节
  *REAL *所有值都是浮动的数值
  TEXT 值为文本字符串
  BLOB 值为blob数据

NSSearchPathForDirectoriesInDomains方法返回的是一个数组类型的数据，所以这里是获取它返回数组的最后一个元素。
NSSearchPathForDirectoriesInDomains 函数用于获取指定目录的路径。它的参数分别表示：

1. 目标目录的类型（Search Path Directory Type）：这是一个枚举值，用于指定你希望获取的目录的类型。常见的类型包括：

   • NSDocumentDirectory：文档目录，通常用于存储用户生成的文件，例如文档或用户数据。
   • NSLibraryDirectory：库目录，通常用于存储应用程序的支持文件和数据。
   • NSCachesDirectory：缓存目录，通常用于存储可以随时重建的临时文件或缓存数据。
   • NSApplicationSupportDirectory：应用程序支持目录，用于存储应用程序支持的数据文件。

2. 目标目录的域（Search Path Domain Mask）：这是一个枚举值，用于指定搜索目录的域。常见的域包括：

   • NSUserDomainMask：搜索用户的主目录，通常在此域中搜索应用特定的目录。
   • NSLocalDomainMask：搜索本地机器上的目录，通常在此域中搜索系统级的目录。
   • NSNetworkDomainMask：搜索网络上的目录，通常在此域中搜索网络共享目录。
   • NSAllDomainsMask：搜索所有域。

3. 是否展开波浪符号（Expanding Tilde to Path）：这是一个布尔值，如果设置为 YES，则会将波浪符号 (~) 扩展为用户的主目录路径。这通常用于获取用户特定的目录路径。如果设置为 NO，则波浪符号将保持不变。

stringByAppendingPathComponent是路径拼接，会在字符串前自动添加“/”，成为完整路径。

在创建文件的时候，会有几种情况：

1. 当数据库具体文件路径有效时，正常访问
2. 当数据库具体文件路径不存在时，自动创建一个该路径的数据库文件
3. 当数据库具体文件路径为空字符串时（@“”），会在临时目录创建一个空的数据库，当FMDatabase连接关闭时，数据库文件也被删除。
4. 当数据库具体文件路径为nil，会创建一个内存中临时数据库，当FMDatabase连接关闭时，数据库会被销毁。

CREATE TABLE IF NOT EXISTS collectionData：
意思是你创建了一个叫做collectionData的数据库，自己创建的话也可以改为自己方便识别的名字。
mainLabel text NOT NULL：
意思就是你在刚才的collectionData数据库里边添加了一个text类型的名叫mainLabel的一个索引，其它代码意思也相似。

FMDB的增删改查

以下用代码说明：

#import "test.h"

@implementation test

- (void)getData {
    //获取数据库文件路径
    NSString *doc = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject];
    
    //stringByAppendingPathComponent拼接路径
    NSString *fileName = [doc stringByAppendingPathComponent:@"collectionData.sqlite"];
    NSLog(@"%@", fileName);

    //获得数据库
    self.collectionDatabase = [FMDatabase databaseWithPath:fileName];
    
    //打开数据库
    if ([self.collectionDatabase open]) {
        //创表
        BOOL result = [self.collectionDatabase executeUpdate:@"CREATE TABLE IF NOT EXISTS collectionData (mainLabel text NOT NULL, nameLabel text NOT NULL, imageURL text NOT NULL, networkURL text NOT NULL, dateLabel text NOT NULL, nowLocation text NOT NULL, goodState text NOT NULL, collectionState text NOT NULL, id text NOT NULL);"];
        if (result) {
            NSLog(@"创表成功");
        } else {
            NSLog(@"创表失败");
        }
    }
}

//FMDB的增删改查
//插入数据
- (void)insertData {
    if ([self.collectionDatabase open]) {
        NSString *string = @"aaa";
        //INSERT INTO collectionData意思是向collectionData插入数据，(mainLabel, nameLabel, imageURL, networkURL, dateLabel, nowLocation, goodState, collectionState, id)表示你要赋值的索引，(?, ?, ?, ?, ?, ?, ?, ?, ?);", string, string, string, string, string, string, string, string, string表示你要赋的值
        BOOL result = [self.collectionDatabase executeUpdate:@"INSERT INTO collectionData (mainLabel, nameLabel, imageURL, networkURL, dateLabel, nowLocation, goodState, collectionState, id) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?);", string, string, string, string, string, string, string, string, string];
        if (!result) {
            NSLog(@"增加次数失败");
        } else {
            NSLog(@"增加次数成功");
        }
        //关闭文件
        [self.collectionDatabase close];
    }
}

//更新数据
- (void) updateData {
    if ([self.collectionDatabase open]) {
        //UPDATE collectionData SET id = ? WHERE nameLabel = ?意思是当nameLabel = ?条件成立的时候，更新collectionData中的id索引对应的数据
        NSString *sql = @"UPDATE collectionData SET id = ? WHERE nameLabel = ?";
        BOOL result = [self.collectionDatabase executeUpdate:sql, @"1", @"aaa"];
        if (!result) {
            NSLog(@"数据修改失败");
        } else {
            NSLog(@"数据修改成功");
        }
        [self.collectionDatabase close];
    }
}

//删除数据
- (void)deleteData {
    if ([self.collectionDatabase open]) {
        //delete from collectionData WHERE collectionState = ?意思是当collectionState = ?条件成立后删除collectionData数据库中的一组数据
        NSString *sql = @"delete from collectionData WHERE collectionState = ?";
        BOOL result = [self.collectionDatabase executeUpdate:sql, @"bbb"];
        if (!result) {
            NSLog(@"数据删除失败");
        } else {
            NSLog(@"数据删除成功");
        }
        [self.collectionDatabase close];
    }
}


- (void)queryData {
    if ([self.collectionDatabase open]) {
		//SELECT * FROM collectionData：选择collectionData中的数据，*处也可以改为WHERE条件。
        FMResultSet *resultSet = [self.collectionDatabase executeQuery:@"SELECT * FROM collectionData"];
        while ([resultSet next]) {
            NSString *mainLabel = [resultSet stringForColumn:@"mainLabel"];
            NSLog(@"mainLabel = %@", mainLabel);
        }
        [self.collectionDatabase close];
    }
}

@end

• 其中，stringForColumn 是 FMDB 库中的一个方法，用于从查询结果集中提取特定列的值，并将其作为字符串返回。这个方法的目的是将数据库中的数据以字符串的形式提取，适用于查询列中包含文本数据的情况。