對FMDB物件導向封裝

weixin_33860722發表於2016-03-22

LKFMDB

Demo下載地址 gitHub
最好是在github上看上面有詳細介紹,不斷更新修改問題。
FMDB物件導向封裝,支援任意型別主鍵,可對每個欄位修飾,傻瓜式操作,一鍵即可儲存更新。

如何使用

  1. 首先確保你的程式匯入過FMDB
  2. 匯入檔案LKFMDB
  3. 是否需要加密,不需要不用匯入SQLCipher,下面會介紹如何加密。
  4. 對需要建立資料庫的類繼承LKDBModel

支援SQLCipher加密

具體請看對FMDB加密-SQLCipher如何使用
預設為加密模式
如需要取消在FMDB檔案下FMDatabase.m檔案下

//註釋掉低150行和177行程式碼
else{
[self setKey:DB_SECRETKEY];
}

基本模組介紹

  • LKDBTool 建立單例對資料庫操作
  • LKDBModel 核心業務模組 對FMDB封裝。 核心模組runtime 對屬性的獲取,下面會對核心程式碼講解。
  • LKDBColumnDes 欄位修飾模組 對欄位修飾
  • LKDBSQLState sql語句封裝模組 -------------正在對此模組封裝中......

常用方法介紹 - 具體檢視Demo

LKDBTool

/** 單列 運算元據庫保證唯一*/
+ (instancetype)shareInstance;
/**  資料庫路徑*/
+ (NSString *)dbPath;
/**  切換資料庫*/
- (BOOL)changeDBWithDirectoryName:(NSString *)directoryName;

LKDBModel

#pragma mark 常用方法
/** 儲存或更新
 * 如果不存在主鍵,儲存,
 * 有主鍵,則更新
 */
- (BOOL)saveOrUpdate;
/** 儲存單個資料 */
- (BOOL)save;
/** 批量儲存資料 */
+ (BOOL)saveObjects:(NSArray *)array;
/** 事物儲存或跟新 */
+(BOOL)saveOrUpdateObjects:(NSArray *)array;
/** 更新單個資料 */
- (BOOL)update;
/** 批量更新資料*/
+ (BOOL)updateObjects:(NSArray *)array;
/** 刪除單個資料 */
- (BOOL)deleteObject;
/** 批量刪除資料 */
+ (BOOL)deleteObjects:(NSArray *)array;
/** 通過條件刪除資料 */
+ (BOOL)deleteObjectsByCriteria:(NSString *)criteria;
/** 通過條件刪除  */
+ (BOOL)deleteObjectsWithFormat:(NSString *)format, ...;
/** 清空表 */
+ (BOOL)clearTable;
/** 查詢全部資料 */
+ (NSArray *)findAll;
/** 查詢某條資料 */
+ (instancetype)findFirstByCriteria:(NSString *)criteria;
/** 通過條件查詢資料*/
+ (NSArray *)findByCriteria:(NSString *)criteria;

//必須要重寫的方法
/** 如果子類中有一些property不需要建立資料庫欄位,或者對欄位加修飾屬性 具體請參考LKDBColumnDes類*/
+ (NSDictionary *)describeColumnDict;

LKDBColumnDes

/** 別名 */
@property (nonatomic, copy)  NSString *columnName;
/** 限制 */
@property (nonatomic, copy)  NSString *check;
/** 預設 */
@property (nonatomic, copy)  NSString *defaultValue;
/** 外來鍵 */
@property (nonatomic, copy)  NSString *foreignKey;
/** 是否為主鍵 */
@property (nonatomic, assign, getter=isPrimaryKey)  BOOL      primaryKey;
/** 是否為唯一 */
@property (nonatomic, assign, getter=isUnique)  BOOL      unique;
/** 是否為不為空 */
@property (nonatomic, assign, getter=isNotNull)  BOOL      notNull;
/** 是否為自動升序 如何為text就不能自動升序 */
@property (nonatomic, assign, getter=isAutoincrement)  BOOL      autoincrement;
/** 此屬性是否建立資料庫欄位 */
@property (nonatomic, assign, getter=isUseless) BOOL useless;
/**
 *  主鍵便利構造器
 */
- (instancetype)initWithAuto:(BOOL)isAutoincrement isNotNull:(BOOL)notNull check:(NSString *)check defaultVa:(NSString *)defaultValue;
/**
 *  一般欄位便利構造器
 */
- (instancetype)initWithgeneralFieldWithAuto:(BOOL)isAutoincrement  unique:(BOOL)isUnique isNotNull:(BOOL)notNull check:(NSString *)check defaultVa:(NSString *)defaultValue;
/**
 *  外來鍵構造器
 */
- (instancetype)initWithFKFiekdUnique:(BOOL)isUnique isNotNull:(BOOL)notNull check:(NSString *)check default:(NSString *)defaultValue foreignKey:(NSString *)foreignKey;
/**
 *  判斷是否起別名
 */
- (BOOL)isCustomColumnName:(NSString *)attribiteName;
/**
 *  生成修飾語句
 */
- (NSString *)finishModify;

LKDBSQLState

/**
 *  查詢方法
 *
 *  @param obj   model類
 *  @param type  查詢型別
 *  @param key   key
 *  @param opt   條件
 *  @param value 值
 */
- (LKDBSQLState *)object:(Class)obj
                       type:(QueryType)type
                        key:(id)key
                        opt:(NSString *)opt
                      value:(id)value;
/**
 *  生成查詢語句
 */
-(NSString *)sqlOptionStr;

核心程式碼

通過runtime獲取一個類的屬性名稱和型別,根據名稱和型別生成建表語句。

// 獲得一個類的屬性名稱操作
  objc_property_t * properties = class_copyPropertyList([self class], &outCount);
  for (int i = 0; i < outCount; i++) {
      objc_property_t property = properties[i];
      //獲得屬性名稱
       NSString *propertyName = [NSString stringWithCString:property_getName(property) encoding:NSUTF8StringEncoding];
      //獲得屬性型別
       NSString *propertyType = [NSString stringWithCString: property_getAttributes(property) encoding:NSUTF8StringEncoding];
  }

Demo下載地址 gitHub

相關文章