DCDatabase 0.0.8

DCDatabase 0.0.8

×

测试已测试✗
语言语言 Obj-CObjective C
许可证 MIT
发布最后发布2016年9月

由 CoderXWChu--description=learning everyday.

DCDatabase 0.0.8

  • 作者
  • DanaChu

使用 DCDatabase，只需要一行代码就能实现缓存模型。

如何安装

安装

手动安装

  1. 下载 DCDatabase 文件夹内的所有内容。
  2. 将 DCDatabase 内的源文件添加(拖放)到您的工程中。
  3. 注意：需要添加依赖 libsqlite3。

使用

忽略部分属性

DCDatabase 的作用是把网络请求下来的模型数据缓存到本地数据库，模型中部分不需要缓存的成员变量，我们可以通过分类方法 - dc_ignorePropertys 来忽略掉。

// 1.在模型.m 文件中导入头文件 DCDatabase.h 或  NSObject+Database.h
// 2.实现下列方法 ,返回不需要存储的属性数组;

- (NSArray *)dc_ignorePropertys
{
    return @[@"creattime", @"imagePath"];
}

保存模型数据到本地数据库

// 哪个线程调用，在哪个线程执行
// 缓存一个 model
[[DCDatabase shareInstance] saveToDatabaseWithObject:model];
// 缓存模型数组
[[DCDatabase shareInstance] saveToDatabaseWithArray:models autoRollback:YES];

// 子线程调用
[[DCDatabase shareInstance] saveToDatabaseWithObject:model callBack:^(BOOL isFinish) {
    if (isFinish) {
        NSLog(@"保存模型数据到本地数据库成功！:)");
    }else {
        NSLog(@"保存模型数据到本地数据库失败！:(");
    }
}];

[[DCDatabase shareInstance] saveToDatabaseWithArray:models autoRollback:YES callBack:^(BOOL isFinish) {
    if (isFinish) {
        NSLog(@"保存模型数据到本地数据库成功！:)");
    }else {
        NSLog(@"保存模型数据到本地数据库失败！:(");
    }
}];


// 刷新数据库模型数据，将本地数据库模型数据删除后，再执行保存操作
[[DCDatabase shareInstance] refreshDataWithArray:self.dataSource autoRollback:NO callBack:^(BOOL isFinish) {

}];

// 例: 
[manager GET:requestURL parameters:parameters progress:nil
success:^(NSURLSessionDataTask * _Nonnull task, id  _Nullable responseObject) {

    NSArray *objs = (NSArray *)responseObject[@"result"];
    self.dataSource  = [[NSMutableArray alloc] initWithArray:[[DCCourseModel mj_objectArrayWithKeyValuesArray:objs] copy]];

    [[DCDatabase shareInstance] refreshDataWithArray:self.dataSource autoRollback:NO callBack:^(BOOL isFinish) {

    }];
}
failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {

// .... 

}];

从本地数据库获取模型数据

// 获取所有本地数据
[[DCDatabase shareInstance] getAllWithClassName:NSStringFromClass(DCModel.class) callBack:^(NSArray * _Nullable models) {

}];

// 获取根据模型某属性进行排序后的数据
[[DCDatabase shareInstance] getDataWithClassName:NSStringFromClass(DCModel.class) attribute:KEYPATH(self.model, createtime) isRise:YES callBack:^(NSArray * _Nullable models) {
    self.tableViewModel.dataSource = [NSMutableArray arrayWithArray:models];
    [self.tableView reloadData];
}];

删除本地数据库模型数据

// 删除所有数据
[[DCDatabase shareInstance] removeAllWithClassName:NSStringFromClass(DCModel.class) callBack:^(BOOL result) {

}];

更多 API 参照 DCDatabase.h

许可证

DCDatabase 使用 MIT 许可证，详情见 LICENSE 文件。