將FMDB進行Hibernate式的封裝解析
項目簡介:
JRDB:一個對FMDB進行類Hibernate封裝的iOS庫,支持Objective-C 和 Swift。
Deion
使用分類的模式,模仿Hibernate,對FMDB進行簡易封裝
支持pod 安裝 『pod ‘JRDB’』,Podfile需要添加 use_framework!
使用協(xié)議,不用繼承基類,對任意NSObject可以進行入庫操作
支持swift 和 Objective-C
支持數(shù)據(jù)類型:基本數(shù)據(jù)類型(int,double,等),String,NSData,NSNumber,NSDate
注:Swift的基本數(shù)據(jù)類型,不支持Option類型,既不支持Int?Int!等,對象類型支持Option類型
Installation(安裝)
use_frameworks!
pod ‘JRDB’
@import JRDB;
Usage
Save(保存)
Objective-C
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];
Swift
Swift中需要入庫的類需要繼承NSObject(使用到runtime)
The Object that you want to persistent should inherit from NSObject
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(查找)
常規(guī)查找
Person *p = [Person jr_findByPrimaryKey:@“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];
SQL
NSString *sql = @“select * from Person where age = ?”;
NSArray *list = [Person jr_executeSql:sql args:@[@10]];
Other(其他)
協(xié)議:JRPersistent
@protocol JRPersistent @required
- (void)setID:(NSString * _Nullable)ID;
- (NSString * _Nullable)ID;
@optional
/**
* 返回不用入庫的對象字段數(shù)組
* The full property names that you want to ignore for persistent
* @return array
*/
+ (NSArray * _Nullable)jr_excludePropertyNames;
/**
* 返回自定義主鍵字段
* @return 字段全名
*/
+ (NSString * _Nullable)jr_customPrimarykey;
/**
* 返回自定義主鍵值
* @return 主鍵值
*/
- (id _Nullable)jr_customPrimarykeyValue;
@end
主鍵
默認每個Object的主鍵為ID, UUID字符串。
可以實現(xiàn) jr_customPrimarykey 以及 jr_customPrimarykeyValue 方法,自定義主鍵。
默認NSObject分類實現(xiàn)
@interface NSObject (JRDB) (。。.methods)
@end
JRDBMgr
@interface JRDBMgr : NSObject
@property (nonatomic, strong) FMDatabase *defaultDB;
+ (instancetype)shareInstance;
+ (FMDatabase *)defaultDB;
- (FMDatabase *)createDBWithPath:(NSString *)path;
- (void)deleteDBWithPath:(NSString *)path;
/**
* 在這里注冊的類,使用本框架的數(shù)據(jù)庫將全部建有這些表
* @param clazz 類名
*/
- (void)registerClazzForUpdateTable:(Class)clazz;
- (NSArray *)registedClazz;
/**
* 更新默認數(shù)據(jù)庫的表(或者新建沒有的表)
* 更新的表需要在本類先注冊
*/
- (void)updateDefaultDB;
- (void)updateDB:(FMDatabase *)db;
@end
JRDBMgr持有一個默認數(shù)據(jù)庫(~/Documents/jrdb/jrdb.sqlite),任何不指定數(shù)據(jù)庫的操作,都在此數(shù)據(jù)庫進行操作。默認數(shù)據(jù)庫可以自行設(shè)置。
Method
- (void)registerClazzForUpdateTable:(Class)clazz;
在JRDBMgr中注冊的類,可以使用
-(void)updateDB:(FMDatabase *)db
進行統(tǒng)一更新或者創(chuàng)建表。
Table Operation(表操作)
Create(建表)
// FMDatabase+JRDB 方法
[[JRDBMgr defaultDB] createTable4Clazz:[Person class]];
[Person jr_createTable];
// 刪除原有的表,重新創(chuàng)建
[[JRDBMgr defaultDB] truncateTable4Clazz:[Person class]];
[Person jr_truncateTable];
//保存時,若發(fā)現(xiàn)沒有表,將自動創(chuàng)建
[person jr_save];
Update 【更新表】
[[JRDBMgr defaultDB] updateTable4Clazz:[Person class]];
[Person jr_updateTable];
更新表時,只會添加不存在的字段,不會修改字段屬性,不會刪除字段,若有需要,需要自行寫sql語句進行修改
Drop(刪表)
[[JRDBMgr defaultDB] dropTable4Clazz:[Person class]];
[Person jr_dropTable];
Thread Operation(線程操作)
多線程操作使用FMDB自帶的 FMDatabaseQueue
[person jr_saveWithComplete:^(BOOL success) {
NSLog(@“%d”, success);
}];
任何帶complete block的操作,都將放入到FMDatabaseQueue進行順序執(zhí)行
注:所有需要立刻返回結(jié)果,或者影響其他操作的數(shù)據(jù)庫操作,都建議放在主線程進行更新,大批量更新以及多線程操作數(shù)據(jù)庫時,請使用帶complete block的操作。
MoreUsage
查看FMDatabase+JRDB.h
項目地址:https://github.com/scubers/JRDB(覺得可以的話就麻煩星一下唄~~~)
第一次寫這種東西,可能已經(jīng)Github上已經(jīng)有了很多類似的東西,如果有不足之處還請指教。
非常好我支持^.^
(0) 0%
不好我反對
(0) 0%
下載地址
將FMDB進行Hibernate式的封裝解析下載
相關(guān)電子資料下載
- iOS17.1可能明天發(fā)布,iOS17.1主要修復(fù)哪些問題? 380
- 華為全新鴻蒙蓄勢待發(fā) 僅支持鴻蒙內(nèi)核和鴻蒙系統(tǒng)應(yīng)用 719
- 蘋果手機系統(tǒng)iOS 17遭用戶質(zhì)疑 731
- iPhone12輻射超標?蘋果推送iOS 17.1解決此事 750
- 傳華為囤積零部件 目標明年智能手機出貨7000萬部;消息稱 MiOS 僅限國內(nèi),小米 28208
- 蘋果推送iOS17.0.3,解決iPhone15Pro系列存在機身過熱 216
- Testin云測兼容和真機服務(wù)平臺中上線iPhone 15系列手機 208
- 利爾達推出搭載HooRiiOS的Matter模組 145
- 運放參數(shù)解析:輸入偏置電流(Ibias)和失調(diào)電流(Ios) 128
- 昆侖太科發(fā)布支持國產(chǎn)飛騰騰銳D2000芯片的開源BIOS固件版本 448