XTFMDB: An Objective-C repository from kryhear

#XTFMDB

特性

Model直接存储.获取. 无需再转换
增删改查. 脱离sql语句
主键自增. 插入不需设主键. pkid
Model满足. 无容器, 无嵌套. model的第一个属性必须是数字主键.且命名中须包含'pkid'.默认为pkid
任何操作. 线程安全
批量操作支持实务. 支持操作失败事务回滚. 且线程安全
支持每个字段自定义设置关键字. 已经集成默认关键字, 以下情况无需再写( NOT NULL, DEFAULT''字符类型默认值,DEFAULT'0'数字类型默认值 )
可指定哪些字段不参与建表.

使用方法

导入 XTFMDB.h

初始化在app启动时调用配置函数

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
// 在这初始化数据库
[[XTFMDBbase sharedInstance] configureDB:@"akateason"] ;

return YES;
}

使用ACID

先创建一个自定义模型类Model1

支持两种建模方式

方式1) XTDBModel的子类, 可以直接实现对数据库操作增删改查等.并且无需设置主键pkid

@interface Model1 : XTDBModel
// 无需设置主键 默认 pkid
@property (nonatomic)       int             age         ;
@property (nonatomic)       float           floatVal    ;
@property (nonatomic)       long long       tick        ;
@property (nonatomic,copy)  NSString        *title      ;
@property (nonatomic,copy)  NSString        *abcabc     ; // 不想在表里出现这个 !!
@end

方式2) 任意创建一个类, 可以直接实现对数据库操作增删改查等.但需要手动设置主键pkid

@interface Model1 : NSObject
@property (nonatomic)       int             pkid        ; // primary key
@property (nonatomic)       int             age         ;
@property (nonatomic)       float           floatVal    ;
@property (nonatomic)       long long       tick        ;
@property (nonatomic,copy)  NSString        *title      ;
@property (nonatomic,copy)  NSString        *abcabc     ; // 不想在表里出现这个 !!
@end

可配置各个字段关键字

注意:

在.m中覆盖基类modelPropertiesSqliteKeywords方法. 返回一个Dictionary. key为字段名. val为关键字, 加入想要多个关键字,以空格隔开即可 .
无需添加NOT NULL和DEFAULT关键字. (已集成) .

+ (NSDictionary *)modelPropertiesSqliteKeywords
{
return @{
@"title" : @"UNIQUE" ,  // 
...           
} ;
}

配置不想参与建表的字段

在.m中覆盖基类ignoreProperties方法. 返回Array. 列出不想参与建表的字段

+ (NSArray *)ignoreProperties
{
return @[
@"abcabc" ,
...
] ;
}

只需要导入`"XTFMDB.h"就可使用

创建表

马上创建一张名为Model1的数据库表

[Model1 xt_createTable] ; // [Model1 createTable] ; 当Model1是XTDBModel子类时,也可以用这个方法.以下方法均可以同上.

插入

插入单个

// 生成aModel对象. 直接插入
int lastRowID = [aModel xt_insert] ; // 默认返回Sqlite LastRowId

批量插入

Bool isSuccess = [Model1 xt_insertList:modelList] ;

更新

更新单个

Bool isSuccess = [aModel xt_update] ;

批量更新

Bool isSuccess = [Model1 xt_updateList:modelList] ;

查询

查询表中所有数据

NSArray *list = [Model1 xt_selectAll] ;

按条件查询

NSArray *list = [Model1 xt_selectWhere:@" title = 'aaaaaa' "] ; // 直接传入where条件即可

按条件查询单个

Model1 *model = [Model1 xt_findFirstWhere:@"pkid == 2"] ;

按条件查询是否包含

BOOL isContained = [Model1 xt_hasModelWhere:@"pkid == 1"] ;

删除

删除当前Model

BOOL isDel = [aModel xt_deleteModel] ;

按条件删除某Model

BOOL isDel = [Model1 xt_deleteModelWhere:@" title == 'aaa' "] ;

删除本表

BOOL isDel = [Model1 xt_dropTable] ;

你的star是我的动力

有任何疑问或建议. 欢迎在github或博客里issue我.

kryhear/XTFMDB

特性