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);//数据表字段