1.x的文档请移步
这里
2.x的文档请移步 这里
- 为什么会有FFDB？
- CoreData、Realm和对FMDB封装后的FFDB对比
- 适合在什么地方使用以及优势
- 怎么使用？如何集成？(请直接戳我)
- 2.x和3.x的版本有什么不同？
- 补充
- Pod版本更新说明
- UML类图
- 直接用FMDB代码并不优雅而且十分繁琐，而且并不能像使用CoreData能面向对象管理;
- 在项目中经常会遇到不得不使用数据库去存储数据的情况；
- 主流的移动端数据库，用过的只有FMDB，CoreData，CoreData在使用的时候觉得要写太多代码了，后来放弃了，只用FMDB的话，没有使用ORM的方便，所以有了FFDB。
4. 解释下FFDB的名字含义，是因为了纪念可能再也见不到的芳芳，不能一起工作真是太可惜了
下面这部分代码出自于Realm的文档
CoreData插入对象
//Create a new Dog
Dog *newDog = [NSEntityDescription insertNewObjectForEntityForName:@"Dog" inManagedObjectContext:myContext];
newDog.name = @"McGruff";
//Save the new Dog object to disk
NSError *saveError = nil;
[newDog.managedObjectContext save:&saveError];
//Rename the Dog
newDog.name = @"Pluto";
[newDog.managedObjectContext save:&saveError];
Realm插入对象
//Create the dog object
Dog *newDog = [[Dog alloc] init];
newDog.name = @"McGruff";
//Save the new Dog object to disk (Using a block for the transaction)
RLMRealm *defaultRealm = [RLMRealm defaultRealm];
[defaultRealm transactionWithBlock:^{
[defaultRealm addObject:newDog];
}];
//Rename the dog (Using open/close methods for the transaction)
[defaultRealm beginWriteTransaction];
newDog.name = @"Pluto";
[defaultRealm commitWriteTransaction];
FFDB插入对象
Dog *newDog = [[Dog alloc] init];
newDog.name = @"McGruff";
[newDog insertObject];
//重命名狗，更新对象
newDog.name = @"Pluto";
[newDog updateObject];
CoreData查询
NSManagedObjectContext *context = self.managedObjectContext;
//A fetch request to get all dogs younger than 5 years old, in alphabetical order
NSEntityDescription *entity = [NSEntityDescription
entityForName:@"Dog" inManagedObjectContext:context];
NSPredicate *predicate = [NSPredicate predicateWithFormat:@"age < 5"];
NSSortDescriptor *sortDescriptor = [[NSSortDescriptor alloc] initWithKey:@"name" ascending:YES];
NSFetchRequest *request = [[NSFetchRequest alloc] init];
request.entity = entity;
request.predicate = predicate;
request.sortDescriptors = @[sortDescriptor];
NSError *error;
NSArray *dogs = [moc executeFetchRequest:request error:&error];
Realm查询对象
RLMResults *dogs = [[Dog objectsWhere:@"age < 5"] sortedResultsUsingProperty:@"name" ascending:YES];
FFDB查询对象
NSArray<Dog *> *dogs = [Dog selectFromClassPredicateWithFormat:@"where age < 5 order by name"];
类相当于一张表，对象即数据，这句话贯穿整个设计的思路
- 数据量大，NSUserDefault和plist都不能满足的时候；
- 对基础数据库语句不太懂的同学；
- 不需要对数据库进行很复杂的操作；
- 通过runtime实现，
不需要接触到sqlite语句(还是要懂一点点的)就能满足增删改查；
pod 'FFDB’,’~>3.x’ pod search FFDB如果没有找到，pod setup之后就ok了
如果不使用CocoaPod，请导入FMDB，并且在target的Linked Frameworks and Libraries导入
libsqlite3.0.tbd
同时把目录中的这些文件拉到工程中
建立好要创建的类继承FFDataBaseModel，声明属性即可，
如一个Person表里，有人名，年龄字段。
@interface Person : FFDataBaseModel
/** 人名 **/
@property(nonatomic,copy) NSString *name;
/** 年龄 **/
@property(nonatomic,copy) NSString *age;
插入:
Person *person = [[Person alloc]init];//创建对象
person.name = @"Fidetro";//设置属性
[person insertObject];//插入数据
查询:
[Person selectFromClassAllObject];//等同于查询Person表中所有的对象
[Person selectFromClassPredicateWithFormat:@"where age == '15' and name == 'Fidetro'"]//等同于查询年龄是15和名字叫Fidetro的数据
更新：
NSArray *personArray = [Person selectFromClassPredicateWithFormat:@"where name = 'fidetro' and age = '21'"];//先查询到要更新的数据
Person *person = [personArray lastObject];
person.age = @"24";
[person updateObject];
删除:
NSArray *personArray = [Person selectFromClassPredicateWithFormat:@"where name = 'fidetro' and age = '21'"];//先查询到要更新的数据
Person *person = [personArray lastObject];
[person deleteObject];
这次的改动在接口层没有过多的改动，在实现上，把原来的db操作，移到了FFDBManager,FFDataBaseModel不再直接能获取到db，同时也因为这个原因，之前生成SQL语句的FFDataBaseModel+sqlite,也进行了改动，现在由NSString+FFDBSQLStatement生成SQL语句，FFDataBaseModel+sqlite只负责模型自身属性生成的字符串的部分，这样做之后，会在后面的版本新增联表查询等的一些操作
1. 所有字段都是默认是TEXT，在后面的版本会增加自定义字段类型这个功能;
2. 所有继承FFDataBaseModel的对象，在插入数据库后，都会自带一个primaryID作为唯一标识，同时这是一个自增的字段;
3. 目前FFDB只是提供了简单的增删改查接口，如果要使用目前接口没办法满足的功能，可以通过以下几个方法进行扩充的操作;
通过获取了这两个，可以自己结合FMDB原有的方法进行操作。
获取FMDatabase对象
[FFDBManager database];
获取类在FMDB对应的表名
[Class tableName];
需要自定义表名，需要在子类重写 + (NSString *)tableName;
+ (NSString *)tableName
{
return @"CustomTableName";
}
4. 有不需要创建到表的属性的时候，现在通过在子类重写+ (NSArray *)memoryPropertys 可以达到效果
//例子
@interface TestModel : FFDataBaseModel
@property(nonatomic,copy) NSString *name;
/** 这是不需要加到表中的字段 **/
@property(nonatomic,copy) NSString *memory;
@property(nonatomic,copy) NSString *_id;
@property(nonatomic,assign) double time;
@end
+ (NSArray *)memoryPropertys
{
return @[@"memory"];
}
5. 想修改字段的存储类型可以通过重写 + (NSDictionary *)columnsType 自定义字段的属性，修改字段属性，没有重写的字段都会默认是text类型
+ (NSDictionary *)columnsType
{
return @{@"time":@"double"};
}
6. 自定义字段名可以重写+ (NSDictionary *)customColumns;
这样表的字段是id建的，而不是_id
+ (NSDictionary *)customColumns
{
return @{@"_id":@"id"};
}
7. FFDB支持与swift 3混编。
- 取消了每次db操作都关闭db，由此引起CPU使用率突然增大的问题。
- 修复
BOOL类型在32位上的架构上会因为[__NSCFString charValue]: unrecognized selector sent to instance导致的崩溃
- 修复了更新版本在原来的基础上新增字段属性，依旧默认
TEXT的bug
- 新增
- (BOOL)upsertWithColumns:(NSArray *)columns;判断表中是否有和当前模型columns相等的字段，如果有则更新，没有则插入
- 新增了
- (void)upsert,根据primaryID判断是否存在这个数据，不存在则插入，否则更新
- 修复了类型为
NSUInteger的时候会crash的情况
- README更新
- 增加了两个方法，方便用于复杂的复合查询的时候不需要重新写很多的get、set代码，方法的实现并没有内置任何操作语句，
format参数需要自己写完整的数据库语句
//查询方法
+ (NSArray <__kindof FFDataBaseModel *>*)selectDBToClass:(Class)toClass
SQLStatementWithFormat:(NSString *)format;
//更新方法，PS：插入、删除、更新都属于更新方法
+ (BOOL)updateDBWithSQLStatementWithFormat:(NSString *)format;
- 修复了
FFDBSafeOperation和FFDBTransaction查询时format没用的bug
- 新增自定义字段功能
- 写完了拖了很久没写的单元测试，之前重构完3.0的时候没仔细测试就放到项目中用了，幸好也没出什么bug
- 目前在计划写4.0的swift版本，应该4.0的同时也会发一个兼容perfect服务器使用的ORM数据库
- 新增了联表查询功能
+ (NSArray <__kindof FFDataBaseModel *>*)selectColumns:(NSArray <NSString *>*)columns
fromClasses:(NSArray <Class>*)dbClasses
toClass:(Class)toClass
SQLStatementWithFormat:(NSString *)format;
columns是需要查询返回的字段，dbClasses要传你需要联表查的类，toClass会返回联表查询后成功返回的字段，要注意的是columns要和toClass的property能对应上
- 插入、更新数据库的数据的时候，会将以下部分特殊符号进行替换然后转义
/ -> //
' -> ''
[ -> /[
] -> /]
% -> /%
& -> /&
_ -> /_
( -> /(
) -> /)
