PYFMDB基于FMDB数据库操作类
前言
之前是一直做web开发，对于做web开发的人而言一定熟悉各种ORM,各种语言针对mysql的ORM有很多，比如PHP的各类框架yii，thinkphp，laravel，ruby语言的rails, GO语言的beego等，IOS开发则面对的数据库是sqlite。FMDB 是基于sqlite的数据库操作类,稳定，但用起来还是不够简洁，PYFMDB是基于FMDB的更高层次的数据库操作类。
程序介绍
PYFMDB分为三部分，PYFMDB 基于FMDB负责数据库底层操作处理，PYTable是自定义Table的基类，提供基于具体数据库表的操作，是更高层次的封装PYFMDB,PYStructure是定义数据库表结构处理类。
快速入门
导入PYFMDB
你可以在 Podfile 中加入下面一行代码来使用PYFMDB
pod 'PYFMDB'
创建自定义Table类
创建一个Table类继承PYTable，例如演示代码中创建了CarTable类。
设置数据库表名
在CarTable.m 中 重写如下方法:
-(NSString *)tableName{
return @"car";
}
设置数据库表结构
在CarTable.m 中 重写如下方法:
-(PYStructure *)structure{
PYStructure * st = [[PYStructure alloc] init];
[st addWithField:@"id" andType:PYStructureTypeAutoInc];
[st addWithField:@"name" andType:PYStructureTypeNormalText];
[st addWithField:@"wheels" andType:PYStructureTypeNormalInt];
return st;
}
PYStructureType
PYStructureTypeAutoInc = 0,//主键，int类型，自增
PYStructureTypePrimaryInt = 1,//主键，int类型，自增
PYStructureTypePrimaryText = 2,//主键，text类型
PYStructureTypeNormalInt = 3,//普通列，int类型
PYStructureTypeNormalText = 4,//普通列，text类型
自定义Table类的使用
table类可以实现针对当前table的增删改查数据库操作。
CarTable *table = [[CarTable alloc] init];
新增数据
普通新增数据
NSDictionary *fields = @{@"name":@"宝马",@"wheels":@1};
[table addFields:fields];
新增或者更新数据【判断数据是否已存在，存在则更新数据，不存在则新增数据】
NSDictionary *fields = @{@"name":@"宝马",@"wheels":@1};
[table addOrUpdateFields:fields andWhere:@"name='宝马'"];
判断是否已经存在数据，仅不存在数据时更新数据
NSDictionary *fields = @{@"name":@"宝马",@"wheels":@1};
[table addFieldsIfNotExist:fields];
删除数据
指定字段删除
NSString *where = @"name='宝马'"; [table deleteWithWhere:where];
多种条件删除
NSString *where = @"name='宝马' and id >=5"; [table deleteWithWhere:where];
清空数据表
[table truncate];
更新数据
更新多个字段
NSString *where = @"name='宝马'";
NSDictionary *fields = @{@"name":@"奔驰",@"wheels":@2};
[table updateFields:fields andWhere:where];
更新1个字段
[table setField:@"name" andValue:@"奔驰" andWhere:@"name='宝马'"];
查询数据
查询表全部数据，全部字段，返回的结果为NSArray
NSArray *results = [table selectAll];
按条件查询数据，全部字段，返回的结果为NSArray
NSString *where = @"name='宝马'"; NSArray *results = [table selectWithWhere:where];
按条件查询数据，指定字段，返回结果为NSArray 多个字段用半角逗号隔开
NSString *where = @"name='宝马'"; NSString *fields = @"id,wheels"; NSArray *results = [table selectWithWhere:where andFields:fields];
按条件查询数据，指定字段，设置分页，返回结果为NSArray 要查询全部字段时 用 * 代表查询全部字段
NSString *where = @"name='宝马'"; NSString *fields = @"id,wheels"; //NSString *fields = @"*"; NSArray *results = [table selectWithWhere:where andFields:fields andPage:1 andPageSize:10];//取第一页，每页10条
按条件查询数据，指定字段，设置分页，设置排序，返回结果为NSArray 排序中 desc 代表 降序，asc代表升序 单个字段排序 如 id desc 多个字段排序 如 id,wheel asc
NSString *where = @"name='宝马'"; NSString *fields = @"id,wheels"; //NSString *fields = @"*"; NSArray *results = [table selectWithWhere:where andFields:fields andPage:1 andPageSize:10 andOrder:@"id desc"];
按条件查询单行数据,返回结果为NSDictionary
NSString *where = @"name='宝马'"; NSDictionary *result = [table findWithWhere:where];
按条件查询单行单个字段数据，返回结果为id类型
id result = [table getField:@"name" andWhere:@"id=1"];
统计表总行数
NSUInteger tableCount = [table count];
判断表是否为空
if([table isEmpty]){
//table is empty
}
判断数据是否存在
NSDictionary *fields = @{@"name":@"宝马",@"wheels":@1};
if([table hasFields:fields]){
//数据已存在
}
判断where查询是否有数据
if([table hasWhere:@"name='宝马'"]){
//有查询结果
}
原生sql支持
执行一个sql查询
NSString *sql = @"select * from car"; NSArray *results = [table executeQueryWithSql:sql];
执行一个sql操作，如更新，删除，插入等
NSString *sql = @"delete from car where name='BMW'"; BOOL result = [table executeUpdateWithSql:sql];
调试信息
NSLog(@"dbpath:%@",table.databasePath);//数据库位置 NSLog(@"lastSql:%@",table.lastSql);//最后执行的sql NSLog(@"dbname:%@",table.databaseName);//数据库名 NSLog(@"tablename:%@",table.tableName);//数据表名 NSLog(@"table structure:%@",table.structure.structureDictory);//数据表结构 NSLog(@"table fields:%@",table.structure.fieldsString);//数据表字段