將FMDB進(jìn)行Hibernate式的封裝解析

　　項(xiàng)目簡介：

　　JRDB：一個(gè)對FMDB進(jìn)行類Hibernate封裝的iOS庫，支持Objective-C 和 Swift。

　　Deion

　　使用分類的模式，模仿Hibernate，對FMDB進(jìn)行簡易封裝

　　支持pod 安裝 『pod ‘JRDB’』，Podfile需要添加 use_framework！

　　使用協(xié)議，不用繼承基類，對任意NSObject可以進(jìn)行入庫操作

　　支持swift 和 Objective-C

　　支持?jǐn)?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］;

　?。踦 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”;

　?。踦 jr_update columns:nil］;

　　column： 需要更新的字段名，傳入空為全量更新

　　Delete（刪除）

　　Person *p = ［Person jr_findAll］.firstObject;

　?。踦 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 = @［

　?。跩RQueryCondition 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

　　主鍵

　　默認(rèn)每個(gè)Object的主鍵為ID， UUID字符串。

　　可以實(shí)現(xiàn) jr_customPrimarykey 以及 jr_customPrimarykeyValue 方法，自定義主鍵。

　　默認(rèn)NSObject分類實(shí)現(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;

　　/**

　　* 更新默認(rèn)數(shù)據(jù)庫的表（或者新建沒有的表）

　　* 更新的表需要在本類先注冊

　　*/

　　- （void）updateDefaultDB;

　　- （void）updateDB：（FMDatabase *）db;

　　@end

　　JRDBMgr持有一個(gè)默認(rèn)數(shù)據(jù)庫（~/Documents/jrdb/jrdb.sqlite），任何不指定數(shù)據(jù)庫的操作，都在此數(shù)據(jù)庫進(jìn)行操作。默認(rèn)數(shù)據(jù)庫可以自行設(shè)置。

　　Method

　　- （void）registerClazzForUpdateTable：（Class）clazz;

　　在JRDBMgr中注冊的類，可以使用

　　-（void）updateDB：（FMDatabase *）db

　　進(jìn)行統(tǒng)一更新或者創(chuàng)建表。

　　Table Operation（表操作）

　　Create（建表）

　　// FMDatabase+JRDB 方法

　?。郏跩RDBMgr defaultDB］ createTable4Clazz：［Person class］］;

　　［Person jr_createTable］;

　　// 刪除原有的表，重新創(chuàng)建

　　［［JRDBMgr defaultDB］ truncateTable4Clazz：［Person class］］;

　?。跴erson jr_truncateTable］;

　　//保存時(shí)，若發(fā)現(xiàn)沒有表，將自動創(chuàng)建

　　［person jr_save］;

　　Update 【更新表】

　?。郏跩RDBMgr defaultDB］ updateTable4Clazz：［Person class］］;

　　［Person jr_updateTable］;

　　更新表時(shí)，只會添加不存在的字段，不會修改字段屬性，不會刪除字段，若有需要，需要自行寫sql語句進(jìn)行修改

　　Drop（刪表）

　?。郏跩RDBMgr defaultDB］ dropTable4Clazz：［Person class］］;

　?。跴erson jr_dropTable］;

　　Thread Operation（線程操作）

　　多線程操作使用FMDB自帶的 FMDatabaseQueue

　　［person jr_saveWithComplete：^（BOOL success） {

　　NSLog（@“%d”， success）;

　　}］;

　　任何帶complete block的操作，都將放入到FMDatabaseQueue進(jìn)行順序執(zhí)行

　　注：所有需要立刻返回結(jié)果，或者影響其他操作的數(shù)據(jù)庫操作，都建議放在主線程進(jìn)行更新，大批量更新以及多線程操作數(shù)據(jù)庫時(shí)，請使用帶complete block的操作。

　　MoreUsage

　　查看FMDatabase+JRDB.h

　　項(xiàng)目地址：https://github.com/scubers/JRDB（覺得可以的話就麻煩星一下唄~~~）

　　第一次寫這種東西，可能已經(jīng)Github上已經(jīng)有了很多類似的東西，如果有不足之處還請指教。