IOS swift 日常功能

iOS用对FMDB的超好用封装

2016-05-26  本文已影响3727人  scubers

一个对FMDB进行类Hibernate封装的iOS库,支持Objective-C 和 Swift。

GitHub: https://github.com/scubers/JRDB

Feedback: jr-wong@qq.com


Description


Installation 【安装】

use_frameworks!
pod 'JRDB'
@import JRDB;

Usage

Save 【保存】

Person *p = [[Person alloc] init];
p.a_int = 1;
p.b_unsigned_int = 2;
p.c_long = 3;
p.d_long_long = 4;
p.e_unsigned_long = 5;
p.f_unsigned_long_long = 6;
p.g_float = 7.0;
p.h_double = 8.0;
p.i_string = @"9";
p.j_number = @10;
p.k_data = [NSData data];
p.l_date = [NSDate date];
[p jr_save];
let p = Person()
p.name = "name"
p.age = 10
p.birthday = NSDate()
p.jr_save()

Update 【更新】

Person *p = [Person jr_findAll].firstObject;
p.name = @"abc";
[p jr_update columns:nil];
column: 需要更新的字段名,传入空为全量更新

--

Delete 【删除】

Person *p = [Person jr_findAll].firstObject;
[p jr_delete];

--

Select 【查找】

Person *P = [Person jr_findByID:@"111"];
NSArray *list = [Person jr_findAll];
NSArray *list1 = [Person jr_findAllOrderBy:@"_age" isDesc:YES];
NSArray *condis = @[
                    [JRQueryCondition condition:@"_l_date < ?" args:@[[NSDate date]] type:JRQueryConditionTypeAnd],
                    [JRQueryCondition condition:@"_a_int > ?" args:@[@9] type:JRQueryConditionTypeAnd],
                    ];
    
NSArray *arr = [Person jr_findByConditions:condis
                                   groupBy:@"_room"
                                   orderBy:@"_age"
                                     limit:@" limit 0,13 "
                                    isDesc:YES];
NSString *sql = @"select * from Person where age = ?";
NSArray *list = [Person jr_executeSql:sql args:@[@10]];

Other 【其他】

协议:JRPersistent

@protocol JRPersistent <NSObject>
@required
- (void)setID:(NSString *)ID;
- (NSString *)ID;
@optional
/**
 *  返回不用入库的对象字段数组
 *  The full property names that you want to ignore for persistent
 *  
 *  @return array
 */
+ (NSArray *)jr_excludePropertyNames;
@end

默认NSObject分类实现

@interface NSObject (JRDB) <JRPersistent>
(...methods)
@end

JRDBMgr

@interface JRDBMgr : NSObject
@property (nonatomic, strong) FMDatabase *defaultDB;
+ (instancetype)shareInstance;
+ (FMDatabase *)defaultDB;
- (FMDatabase *)createDBWithPath:(NSString *)path;
- (void)deleteDBWithPath:(NSString *)path;
/**
 *  在这里注册的类,使用本框架的数据库将全部建有这些表
 *  @param clazz 类名
 */
- (void)registerClazzForUpdateTable:(Class<JRPersistent>)clazz;
- (NSArray<Class> *)registedClazz;
/**
 * 更新默认数据库的表(或者新建没有的表)
 * 更新的表需要在本类先注册
 */
- (void)updateDefaultDB;
- (void)updateDB:(FMDatabase *)db;
@end

JRDBMgr持有一个默认数据库(~/Documents/jrdb/jrdb.sqlite),任何不指定数据库的操作,都在此数据库进行操作。默认数据库可以自行设置。

Method
- (void)registerClazzForUpdateTable:(Class<JRPersistent>)clazz;

在JRDBMgr中注册的类,可以使用

-(void)updateDB:(FMDatabase *)db

进行统一更新或者创建表。


Table Operation 【表操作】

Create 【建表】

// FMDatabase+JRDB 方法
[[JRDBMgr defaultDB] createTable4Clazz:[Person class]];
[Person jr_createTable];

// 删除原有的表,重新创建
[[JRDBMgr defaultDB] truncateTable4Clazz:[Person class]];
[Person jr_truncateTable];

//保存时,若发现没有表,将自动创建
[person jr_save];

Update 【更新表】

[[JRDBMgr defaultDB] updateTable4Clazz:[Person class]];
[Person jr_updateTable];

更新表时,只会添加不存在的字段,不会修改字段属性,不会删除字段,若有需要,需要自行写sql语句进行修改

Drop 【删表】

[[JRDBMgr defaultDB] dropTable4Clazz:[Person class]];
[Person jr_dropTable];

Thread Operation 【线程操作】

[person jr_saveWithComplete:^(BOOL success) {
    NSLog(@"%d", success);
}];

任何带complete block的操作,都将放入到FMDatabaseQueue进行顺序执行


MoreUsage


上一篇 下一篇

猜你喜欢

热点阅读