iOS-FMDB 基础用法

作者: 它是一只肥猫 | 来源:发表于2016-06-29 15:48 被阅读668次

iOS-FMDB 基础用法
Alamofire高级用法
with open 在Python中的用法
神奇酷炫的下拉菜单(数据验证)
vue - store
Paint的用法_二
iOS-FMDB
Flutter 数据持久化-SQLite Sqflite数据库进
LitePal3.0基础用法
正则表达式

github链接地址 https://github.com/ccgus/fmdb
文顶http://www.cnblogs.com/wendingding/p/3871848.html>
http://www.sqlite.org/inmemorydb.html

1.FMDB

FMDB是iOS平台对 SQLite数据库框架以OC(面向对象)的方式进行封装的API.

2.FMDB 三大核心类

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

3.数据库的创建

一个FMDatabase 对象可以由 SQLite数据库文件路径创建。这个路径可以由以下三种方式创建:
1.系统文件路径，这个路径不必一定存在，如果该路径不存在，它会帮你创建一个该路径的文件；
2.如果是一个空的字符串(@""),那么在当前路径下会为你创建一个暂时的空的数据库，当FMDatabase连接关闭时，数据库会被删除；
3.如果是null, 在内存中创建一数据库，当FMDatabase连接关闭时，数据库会被销毁。
-注释：

     1.  NSString *path = [NSTemporaryDirectory() stringByAppendingPathComponent:@"tmp.db"];
//创建数据库
FMDatabase *db = [FMDatabase databaseWithPath:path];
//打开数据库(在使用数据库之前，必须确保数据库是打开的)
if (![db open]){
    // 打开失败
    db = nil;return;
}
2.执行更新数据的语句
//SQL语句中除了SELECT语句，其他任何语句都有更新数据库的作用,包括(CREATE, UPDATE, INSERT, ALTER, COMMIT, BEGIN, DETACH, DELETE, DROP, END, EXPLAIN, VACUUM, and REPLACE)。意思是只要SQL语句不是SELECT开始的语句，都是更新语句。
3.执行查询
//SELECT语句通过执行一次executeQuery...方法进行一次查询。
//执行的查询语句，如果执行成功的返回值是一个FMResultSet集合，如果执行失败可以使用-lastErrorMessage和-lastErrorCode方法确定为什么查询失败。
//可以用while()循环遍历你的查询结果，
FMResultSet *resultSet = [db executeQuery:@"SELECT  * FROM myTable"];
while ([resultSet next]){
    // 检索每个值
}
// 在查询结果集时，即使你只需要其中一个值，你也必须调用-[FMResultSet next]这个方法，去查找其中的一个值
FMResultSet *s = [db executeQuery:@"SELECT COUNT(*) FROM myTable"];
if ([s next]) {
    int totalCount = [s intForColumnIndex:0];
}
//FMResultSet 有很多不同的数据格式的方法去检索结果集中的数据：
  intForColumn:
  longForColumn:
  longLongIntForColumn:
  boolForColumn:
  doubleForColumn:
  stringForColumn:
  dateForColumn:
  dataForColumn:
  dataNoCopyForColumn:
  UTF8StringForColumnName:
  objectForColumnName:

//通常情况下，不必手动关闭FMResultSet，因为当任何一个结果集被释放或者父数据库被关闭时，FMResultSet会自动关闭。
4.关闭数据库
// 当执行完数据库查询或者更新时，应该手动关闭数据库，调用d -close方法,关闭数据库后SQLite 将会释放在执行过程中获取的所有数据。
[db close];
5.数据处理
// FMDatabase 能够调用一定方法去开始或者结束处理数据

4. 多语句操作和批量处理数据

//使用 FMDatabase's executeStatements:withResultBlock: 的语句处理多个SQL语句
NSString *sql = @"create table test1 (id integer primary key autoincrement , x test );
                  create table test2 (id integer primary key autoincrement , y test );
                  insert into test1 (x) values ('XXX');
                  insert into test2 (y) values ('YYY');";// 创建表名分别为test1 、test2 、test 3的表，autoincrement 自动增量为主键;insert into 往表test1 插入数据 
success = [db execteStatements:sql];
sql = @"select count(*) as count from test1;
        select count(*) as count from test2";
success = [self.db execteStatements:sql withResultBlock:^int(NSDictionary *dictionary) {
NSInteger count = [dictionary[@"count"] integerValue];
return 0;
}];]

5.数据处理

// 如果FMDB的执行语句是SQL语句，那么在插入之前不需要做任何处理，只需要使用标准化的SQL语法的语句
// 插入数据的语法，？该字符在SQLite语句中被用来作为占位符，作为要插入的值，
INSERT INTO myTable VALUES (? ,?, ?, ?)；

二、其他

1、优点：
使用起来更加面向对象，省去了很多麻烦、冗余的C语言代码
对比苹果自带的Core Data框架，更加轻量级和灵活
提供了多线程安全的数据库操作方法，有效地防止数据混乱
2、FM Database这个类是线程不安全的，如果在多个线程中同时使用一个FMDatabase实例，会造成数据混乱等问题，为了保证线程安全，FMDB提供方便快捷的FMDatabaseQueue。

三、FMDB的一些实用的用法总结

1、用一个唯一的主键来标记数据模型，可以更好的实现查询、插入、删除数据，这是最近做开发一个单机版的项目用到FMDB的总结。
总的来说，FMDB在项目中使用的话，还是相对比较简单的，就是处理复杂的逻辑关系时比较繁琐。
附上能够简单使用的FMDB的封装：

创建数据库
因为在工程中需要用到很多个数据库表，所以以不同的用户唯一的名称创建了不同的数据库，用以标记该数据库的唯一性，使在一个工程中数据的操作不会错乱。

 #import "FMDBDataManager.h"
 #import "FMDB.h"
 #import <objc/runtime.h>

 @implementation FMDBDataManager
  {
         FMDatabase *_fmdb;
  }

  - (instancetype)initPrivateWithDBName:(NSString     *)DBname{
    self = [super init];
    if (self) {
         [self createDBWithName:DBname];
     }
    return self;
  }
- (instancetype)init
{
    NSAssert(FALSE, @"FMDBDataManager 不能调用init创建对象，请使用单例方法获取。");
    return nil;
}
// 数据库相关操作
- (void)createDBWithName:(NSString *)DBname
{
 NSArray * documentsArray =             NSSearchPathForDirectoriesInDomains(NSDocument        Directory, NSUserDomainMask, YES);
 NSString * documentsPath = documentsArray.lastObject;
 NSString * dbPath = [documentsPath stringByAppendingPathComponent:[NSString stringWithFormat:@"%@.db",DBname]];
 NSLog(@"数据库地址 = %@", documentsPath);
  _fmdb = [[FMDatabase alloc] initWithPath:dbPath];
 if ([_fmdb open]) {}
 }

/**
 获取当前对象的所有属性

@param objcClass 对象
@return <#return value description#>
*/
- (NSArray *)getPropertiesFromClass:   (Class)objcClass{
  NSMutableArray *propertiesArr = [NSMutableArray array];

 unsigned int propertiesCount = 0;
 objc_property_t * objcPropertyArray = class_copyPropertyList(objcClass, &propertiesCount);
 for (int idx = 0; idx < propertiesCount; idx ++ ) {
  
  objc_property_t property = objcPropertyArray[idx];
  
  const char *propertyName = property_getName(property);
  NSString *nameStr = [NSString stringWithCString:propertyName encoding:NSUTF8StringEncoding];
  [propertiesArr addObject:nameStr];
 }
return propertiesArr;
}

/**
 获取当前对象的所有属性对应的值

 @param objcClass 当前对象
 @return <#return value description#>
 */
- (NSArray *)getAllValuesFromObject:(id)objc{

NSMutableArray * valuesArray = [NSMutableArray array];
NSArray * propArray = [self getPropertiesFromClass:[objc class]];
for (NSString * prop in propArray) {
  id value = [objc valueForKey:prop];
  if (!value) {
      [valuesArray addObject:[NSNull null]];
  }
  else {
      [valuesArray addObject:value];
  }
 }
  return valuesArray;
}

#pragma mark ------------- Public Method -------------
static FMDBDataManager * dataManager = nil;
static dispatch_once_t onceToken;
+ (instancetype)sharedManagerWithDBName:(NSString *)DBName{
 dispatch_once(&onceToken, ^{
      if (!dataManager) {
      dataManager = [[FMDBDataManager alloc] initPrivateWithDBName:DBName];
    }
  });
  return dataManager;
}

- (void)closeDB{
    onceToken = 0;
    dataManager = nil;
    [_fmdb close];
}

/**
 创建数据库表

 @param object 创建表所需对象
 @param tableName 表名
 @return <#return value description#>
 */
- (BOOL)createTableWithObject:(id)object tableName:(NSString *)tableName{

  NSArray * propertiesArray = [self getPropertiesFromClass:[object class]];

  NSString * propertiesStr = [propertiesArray componentsJoinedByString:@" , "];
  propertiesStr = [propertiesStr stringByAppendingString:@" "];

  NSString * createSql = [NSString stringWithFormat:@"CREATE TABLE IF NOT EXISTS %@ (id INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT, %@);", tableName, propertiesStr];
  BOOL isSuccess = [_fmdb executeUpdate:createSql];

  return isSuccess;
}

/**
   插入某条数据

   @param object 插入的对象
   @param keyID 插入对象的在该表中的唯一ID
   @param tableName 插入表的表名，如果当前表存在，直接插入，如果当前表名的表不存在，先创建表再插入
 @return 插入是否成功
 */
  - (BOOL)insertTableWithObject:(id)object withIdentifier:(NSString *)identifier tableName:(NSString *)tableName{
      if ([self isExistWithIdentifiert:identifier tableName:tableName]) {
      return NO;
    }

  Class objcClass = [object class];

  [self createTableWithObject:object tableName:tableName];

  NSArray * propertiesArray = [self getPropertiesFromClass:objcClass];
  NSString * propStr = [propertiesArray componentsJoinedByString:@", "];
  NSArray * valuesArray = [self getAllValuesFromObject:object];
  NSMutableArray * placeHolderArray = [NSMutableArray array];
  for (NSString * prop in propertiesArray) {
  [placeHolderArray addObject:@"?"];
  }
  NSString * placeHolderStr = [placeHolderArray componentsJoinedByString:@", "];
  NSString * insertSql = [NSString stringWithFormat:@"INSERT INTO %@  (%@) VALUES (%@);", tableName, propStr, placeHolderStr];
BOOL isSuccess =[_fmdb executeUpdate:insertSql withArgumentsInArray:valuesArray];
if (isSuccess) {
    NSLog(@"数据插入成功 ========= %@", NSStringFromClass(objcClass));
}
  return isSuccess;
}
/**
   判断当前标准是否存在该对象

 @param identifier 查找对象的ID
 @param tableNam 查找表名
 @return <#return value description#>
 */
  - (BOOL)isExistWithIdentifiert:(NSString *)identifier tableName:(NSString *)tableName{

    NSString * selectSql = [NSString stringWithFormat:@"SELECT * FROM %@ WHERE identifier = '%@'", tableName, identifier];
    FMResultSet * resultSet = [_fmdb executeQuery:selectSql];
    while ([resultSet next]) {
       return YES;
    }
    return NO;
}

/**
   获取当前表的所有数据

 @param tableName 表名
 @return 获取是否成功
 */
- (NSArray *)getAllObjectFromWithClass:(Class)objcClass TabelName:(NSString *)tableName{

    NSString * selectAllSql = [NSString stringWithFormat:@"SELECT * FROM %@", tableName];
    FMResultSet * resultSet = [_fmdb executeQuery:selectAllSql];
    NSMutableArray * objectsArray = [NSMutableArray array];
    NSArray * propArray = [self getPropertiesFromClass:objcClass];
 while ([resultSet next]) {
  id object = [[objcClass alloc] init];
  for (NSString * prop in propArray) {
      id value = [resultSet objectForColumnName:prop];
      [object setValue:value forKey:prop];
  }
  [objectsArray addObject:object];
}
  return objectsArray;
}

/**
 删除当前表中的某一个对象

 @param keyID 删除的对象的ID
 @param tableName 表名
 @return <#return value description#>
 */
- (BOOL)deleteTableRecordWithObject:(id)object withIdentifier:(NSString *)identifier withTableName:(NSString *)tableName{
    if (![self isExistWithIdentifiert:identifier tableName:tableName]) {
      return NO;
  }
NSArray * valueArray = [self getAllValuesFromObject:object];
NSString * deleteSql = [NSString stringWithFormat:@"DELETE FROM %@ WHERE identifier = '%@'", tableName, identifier];

  BOOL isSuccess = [_fmdb executeUpdate:deleteSql withArgumentsInArray:valueArray];
  return isSuccess;
}
- (BOOL)deleteTableRecordWithTableName:(NSString *)tableName{
  NSString * deleteSql = [NSString stringWithFormat:@"DELETE FROM %@ ", tableName];
  BOOL isSuccess = [_fmdb executeUpdate:deleteSql];
  return isSuccess;
}

/**
   更新某个表中的某个对象

 @param object 该对象
 @param tableName 当前表名
 @return <#return value description#>
 */
- (BOOL)uploadObjectFromWithIdentifier:(NSString *)identifier toProperty:(NSString *)property withNewValue:(NSString *)value  withTableName:(NSString *)tableName{

// 获得新对象的属性、值    
  NSString *updataSql = [NSString stringWithFormat:@"UPDATE %@ SET %@ = %@  WHERE identifier = '%@'",tableName,property,value,identifier];

  BOOL isSuccess = [_fmdb executeUpdate:updataSql];
  if (isSuccess) {
          NSLog(@"数据更新成功");
  }
  return isSuccess;
}

用过FMDB 之后，觉得其实这个框架并不是很难，一般运用也只会用到一些简单的方法，我在使用的时候有很多需求不会写SQL语句的时候就去http://www.w3school.com.cn/sql/index.asp
然后执行久行了，大家可以尝试一下，有什么更好的运用和比较坑的地方都可以告诉我，毕竟坑不踩就不是坑了🐤。有点乱，以后再整理吧。😅

iOS-FMDB 基础用法
github链接地址 https://github.com/ccgus/fmdb文顶http://www.cnbl...
Alamofire高级用法
基础用法和高级用法的区别：基础用法:AF.request()、AF.download()、AF.upload()...
with open 在Python中的用法
基础用法
神奇酷炫的下拉菜单(数据验证)
今天讲的数据验证，最主要的还是把基础用法一定要掌握扎实、熟练，后面的高级用法都是在基础用法的基础之上进行拓展、应用...
vue - store
基础用法抽离
Paint的用法_二
Paint的用法_二 ColorFilter的基础用法 ColorMatrixColorFilter 上代码：上...
iOS-FMDB
前言：今天,就让我们，重点学习一下FMDB。 FMDB学习一、基本介绍简介:-由于iOS中原生的 SQLit...
Flutter 数据持久化-SQLite Sqflite数据库进
基础用法请移步：Flutter 数据持久化-SQLite Sqflite数据库基础使用进阶用法分页查询实际应...
LitePal3.0基础用法
LitePal3.0基础用法
正则表达式
前言：re模块是爬虫的基础，文章主要从符号和用法来介绍它的基础用法符号各个符号及用法如下：方法各种方法代码...