MQFMDB: An Objective-C repository from plumk97

MQFMDB

在FMDB上封装了一层以对象的方式操作数据库类似CoreData

由于使用了SQLCipher来加密数据库所以你需要安装FMDB/SQLCipher版本

pod 'FMDB/SQLCipher'

Demo提供了一个增删查找演示

Conf 文件说明

identify数据库标识符一个App里面每个数据库标识符必须是唯一的
version数据库版本号
path数据库存放位置

内置了两个目录<App>、<MQFMDB>
<App>在App根目录下一般用于读取内置数据库
<MQFMDB>在Documents目录下的__MQFMDB__文件夹如果没有则会自动创建

key数据库密码
upgrade数据库升级的相关

upgrade字段

假设TDSession类在1.0.0版本是这样的

@interface TDSession : MQFMDBObject

@property (nonatomic, copy) NSString * name;
@end

现在升级到1.0.1版本在这个类加了一个count属性

@interface TDSession : MQFMDBObject

@property (nonatomic, copy) NSString * name;

/** version-1.0.1 */
@property (nonatomic, assign) NSInteger count;
@end

那么需要在工程里面添加一个sql升级脚本，并在配置文件里面填入路径，如下所示

{
  "identify": "MQFMDB_Demo",
  "version": "1.0.1",
  "path": "<MQFMDB>/MQFMDB_Demo.sqlite",
  "key": "123456789",
  "upgrade": {
      "1.0.0": {
          "script": "<App>/db_upgrade_101.sql"
      }
  }
}

再次运行就完成了从1.0.0到1.0.1的升级,Demo中已经配置好了需要测试请按下面操作

取消TDSession.h文件中@property (nonatomic, assign) NSInteger count;注释
取消TDSession.m文件中@dynamic count;注释
注释ViewController中使用MQFMDB_Demo一行并且取消使用MQFMDB_Demo-1.0.1的注释

然后运行就可以了，运行之前需要保证当前数据库版本处于1.0.0版本

使用方法

具体使用方法请查看Demo 以下只是部分代码提取

创建数据库表

每个表都对应一个MQFMDBObject的子类，MQFMDBObject的_Id属性为主键不能手动去修改

MQFMDBObject的子类的属性如果使用@dynamic声明则视为表字段,并且属性名称不能以大写开头.

@interface TDSession : MQFMDBObject

@property (nonatomic, copy) NSString * name;
@end

@implementation TDSession
@dynamic name;


@end

创建数据库

/** 生成数据库并且打开相关配置在conf文件 */
self.userDB = [[MQFMDB alloc] initWithConfigContent:configContent];
[self.userDB openDatabaseWithOpertions:^(MQFMDB *db) {
/** 在这里创建表如果不存在才创建 */
[db insertNewTable:[TDMessage class]];
[db insertNewTable:[TDSession class]];
}];

查询

// 下面语句等于 SELECT * FROM TDMessage WHERE session == 1
// [self.dataArray setArray:[self.userDB queryTable:[TDMessage class] condition:[NSString stringWithFormat:@"session == 1"]]];
// 下面语句等于 SELECT * FROM TDMessage
[self.dataArray setArray:[self.userDB queryTable:[TDMessage class] condition:nil]];

插入

// 使用这种方法创建的对象才会保存进数据库
TDSession * session = [self.userDB insertNewObjectForTable:[TDSession class]];
session.name = @"session";

TDMessage * message = [self.userDB insertNewObjectForTable:[TDMessage class]];
message.session = session;
message.type = arc4random() % 10;
message.state = arc4random() % 3;
message.time = [NSDate date];
message.content = @"插入测试";

message.latitude = arc4random() % 1000;
message.longitude = arc4random() % 1000;

message.params = @{@"123":@(123), @"345" : @(345), @"params": @{@"123":@(123), @"345" : @(345)}};
message.array = @[@"1", @"2", @"3", @"4"];
// 执行这个方法只会才会保存操作
[self.userDB saveOpertion];

修改

TDMessage * message = [self.dataArray objectAtIndex:selectedIndexPath.row];
message.type = arc4random() % 10;
message.state = arc4random() % 3;
message.time = [NSDate date];
message.content = @"插入测试";

message.longitude = arc4random() % 1000;
message.latitude = arc4random() % 1000;

message.params = @{@"123":@(123), @"345" : @(345), @"params": @{@"123":@(123), @"345" : @(345)}};
message.array = @[@"1", @"2", @"3", @"4"];

[self.userDB saveOpertion];

删除

TDMessage * message = [self.dataArray objectAtIndex:selectedIndexPath.row];
[self.userDB deleteObject:message];

plumk97/MQFMDB

MQFMDB

Conf 文件说明

upgrade字段

使用方法