对FMDB的轻量级封装，帮助快速创建管理移动端数据库。让SQLite使用更加简单,记得给小星星哦。
要实现的目标：
1.自动处理数据库升级，让使用者不用考虑数据库升级带来烦劳。
2.封装简单常用的查询语句，让使用者只用关注特殊的SQL查询，基本查询不用重复写直接使用即可。
已支持 CocoaPods
pod 'JYDataBase'
如图：是Demo中创建本地数据库的一个框图。
BS1: JYDBService类 提供了所有对外的查询方法，数据库的增删查改都通过这个单例调用。
BS2: JYPersonDB 是JYDBService 所包含的其中一个数据库，他管理着 该库所有表的创建和升级。
BS3: JYPersonTable 是JYPersonDB库下的其中一张表，它管理了该表的所有 增删查改 操作。
BS4: JYPersonInfo 是映射JYPersonTable表的列的对象。JYPersonTable表查询出来的数据都会转换成JYPersonInfo对象。
注意：个人建议不要在项目中建多个数据库，建一个数据库，多张表即可。
数据表的建立需要继承 JYContentTable(该类实现了工作中用到的大部分SQL查询)，只要重写以下几个方法就可以快速创建一张数据表。
// 必须实现 contentClass 是该表所对应的模型类，tableName 是表的名字
- (void)configTableName{
self.contentClass = [JYPersonInfo class];
self.tableName = @"JYPersonTable";
}
// 必须实现 contentId 是该表的主键（也是唯一索引）比如用户的userId 必须是 contentClass 的属性
- (NSString *)contentId{
return @"personnumber";
}
// 数据表的其他字段，必须是 contentClass 的属性，如不实现则默认取 contentClass 以“DB”结尾 的属性
- (NSArray<NSString *> *)getContentField{
return @[@"mutableString1",@"integer1",@"uInteger1",@"int1",@"bool1",@"double1"];
}
// 表创建时对应字段的默认长度，如不写，取默认。
- (NSDictionary*)fieldLenght{
return @[@"mutableString1":@"512"];
}
// 查询是否使用NSCache缓存，默认YES。
- (BOOL)enableCache{
return NO;
}
注意：数据表映射的属性支持 NSString NSMutableString NSInteger NSUInteger int BOOL double float NSData NSArray NSMutableArray NSDictionary NSMutableDictionary 的数据类型 其中字典 数组 要能序列化。数组是其它数据库表的模型要进行特殊配置，参考下面多表设置。
关键方法：
// 该方法会根据当前版本判断 是创建数据库表还是 数据表升级
- (void)buildWithPath:(NSString *)aPath mode:(ArtDatabaseMode)aMode;
// 返回当前数据库版本，只要数据表有修改 返回版本号请 ＋1 默认返回 1
- (NSInteger)getCurrentDBVersion{
return 4;
}
// 所有数据表的创建请在该方法实现 调用固定方法 - (void)createTable:(FMDatabase *)aDB;
- (void)createAllTable:(FMDatabase *)aDB{
[self.personTable createTable:aDB];
}
// 所有数据表的升级请在该方法实现 调用固定方法 - (void)insertDefaultData:(FMDatabase *)aDb;
- (void)updateDB:(FMDatabase *)aDB{
[self.personTable updateDB:aDB];
}
这是一个单例，向外提供数据库的一切外部接口，具体实现大家可以看Demo。
对于每一张表，所谓的修改无非是 添加了一个 新的字段 或减少了几个字段（这种情况很少）。
2.2.1 字段的对比
PRAGMA table_info([tableName]) 可以获取一张表的所有字段
再与当前需要的字段做对比即可得到要增加的字段和减少的字段
2.2.2 字段的添加
sqlite有提供对应的SQL语句实现
ALTER TABLE tableName ADD 字段 type(lenght)
2.2.3 减少字段
sqlite并未提供对应的SQL语句实现但可通过以下方法实现
a.根据原表新建一个表
sql = [NSString stringWithFormat:@"create table %@ as select %@%@ from %@", tempTableName,[self contentId],tableField,self.tableName];
b.删除原表
sql = [NSString stringWithFormat:@"drop table if exists %@", self.tableName];
c.将表改名
sql = [NSString stringWithFormat:@"alter table %@ rename to %@",tempTableName ,self.tableName];
d.为新表添加唯一索引
sql = [NSString stringWithFormat:@"create unique index '%@_key' on %@(%@)", self.tableName,self.tableName,[self contentId]];
- (void)inTransaction:(void (^)(FMDatabase *db, BOOL *rollback))block;
- (void)inDatabase:(void (^)(FMDatabase *db))block;
以上 两个方法都是开启了事务操作的
- (BOOL)rollback {
BOOL b = [self executeUpdate:@"rollback transaction"];
if (b) {
_inTransaction = NO;
}
return b;
}
- (BOOL)commit {
BOOL b = [self executeUpdate:@"commit transaction"];
if (b) {
_inTransaction = NO;
}
return b;
}
- (BOOL)beginDeferredTransaction {
BOOL b = [self executeUpdate:@"begin deferred transaction"];
if (b) {
_inTransaction = YES;
}
return b;
}
- (BOOL)beginTransaction {
BOOL b = [self executeUpdate:@"begin exclusive transaction"];
if (b) {
_inTransaction = YES;
}
return b;
}
- (BOOL)inTransaction {
return _inTransaction;
}
在数据库的创建 升级 以及 多数据的插入，我都使用了该方法。
关于复杂查询我提供了一个简单的方法
- (NSArray *)getContentByConditions:(void (^)(JYQueryConditions *make))block;
可以看下它的使用
NSArray*infos = [[JYDBService shared] getPersonInfoByConditions:^(JYQueryConditions *make) {
make.field(@"personnumber").greaterThanOrEqualTo(@"12345620");
make.field(@"bool1").equalTo(@"1");
make.field(@"personnumber").lessTo(@"12345630");
make.asc(@"bool1").desc(@"int1");
}];
其实它不过产生了如下一条查询语句：
SELECT * FROM JYPersonTable WHERE personnumber >= 12345620 AND bool1 = 1 AND personnumber < 12345630 order by bool1 asc , int1 desc
make.field(@"personnumber").greaterThanOrEqualTo(@"12345620"); 就代表了 personnumber >= 12345620
实现实际相当简单，先用 JYQueryConditions 记录下所描描述的参数，最后再拼接出完整的sql语句。
至于通过点语法的链式调用则参考了 Masonry 的声明方式
- (JYQueryConditions * (^)(NSString *compare))equalTo;
- (JYQueryConditions * (^)(NSString *field))field{
return ^id(NSString *field) {
NSMutableDictionary *dicM = [[NSMutableDictionary alloc] init];
dicM[kField] = field;
[self.conditions addObject:dicM];
return self;
};
}
- (void)insertDB:(FMDatabase *)aDB contents:(NSArray *)aContents;
- (void)insertContent:(id)aContent;
- (void)insertContents:(NSArray *)aContents;
- (void)insertIndependentDB:(FMDatabase *)aDB contents:(NSArray *)aContents;
- (void)insertIndependentContent:(id)aContent;
- (void)insertIndependentContents:(NSArray *)aContents;
- (void)insertDB:(FMDatabase *)aDB contents:(NSArray *)aContents;
- (void)insertContent:(id)aContent;
- (void)insertContents:(NSArray *)aContents;
- (NSArray *)getContentDB:(FMDatabase *)aDB byconditions:(void (^)(JYQueryConditions *make))block;
- (NSArray )getDB:(FMDatabase )aDB contentByIDs:(NSArray<NSString>)aIDs;
- (NSArray *)getContentByConditions:(void (^)(JYQueryConditions *make))block;
- (NSArray )getContentByIDs:(NSArray<NSString>*)aIDs;
- (id)getContentByID:(NSString*)aID;
- (NSArray *)getAllContent;
- (void)deleteContentDB:(FMDatabase *)aDB byconditions:(void (^)(JYQueryConditions *make))block;
- (void)deleteDB:(FMDatabase )aDB contentByIDs:(NSArray<NSString>*)aIDs;
- (void)deleteContentByConditions:(void (^)(JYQueryConditions *make))block;
- (void)deleteContentByID:(NSString *)aID;
- (void)deleteContentByIDs:(NSArray<NSString >)aIDs;
- (void)deleteAllContent;
- (void)cleanContentBefore:(NSDate*)date;
- (NSInteger)getCountContentDB:(FMDatabase *)aDB byconditions:(void (^)(JYQueryConditions *make))block;
- (NSInteger)getCountByConditions:(void (^)(JYQueryConditions *make))block;
- (NSInteger)getAllCount;
在移动端使用SqLite，个人建议安装 火狐浏览器 的一个插件 SQLite Manager 多的就不说了。
1.本修改了查询方法的使用，以及数据建立方法更为简便，不用用户写大量无用代码，具体可见Demo 中JYPersonDB。
2.OC属性字段与sqlite属性字段的映射是依赖与 JYDataBaseConfig 里 NSDictionary * jy_correspondingDic()的静态方法，但是在实际使用中可能无法全部覆盖，触发断言，大家遇到后可以自己设置 corresponding 属性添加额外的映射。
3.宗旨就是让数据库的使用变的简单，后期会根据我所遇到的一些业务场景进行持续更新。
移动端缓存有个必须要注意的问题，那就是用户区分，要不把用户A的缓存数据显示到了用户B上
就比较尴尬了。一般来说有两种方法：
1.在每张表添加一个字段 userId 用于用户区分。在查询时要添加userId做为查询条件，插入时也要设置当前的userId。
2.为每个用户创建一个数据库。
综合比较的话：方案一：优点是，可以为数据库的每一张表定义是否区分用户，缺点是，要多维护一个字段得不尝失。故而选择方案二。
方案二的使用：
通过监听userId的改变重新绑定数据库。self.documentDirectory 使用懒加载生成与userId有关的 地址。
- (void)construct{
NSLog(@"%@",self.documentDirectory);
self.userId = [ArtUserConfig shared].userId;
[self buildWithPath:self.documentDirectory mode:ArtDatabaseModeWrite registTable:^{
//注册数据表 建议外引出来，用于其它位置调用封装
self.personTable = (JYPersonTable *)[self registTableClass:[JYPersonTable class]];
self.test1Table = (JYTest1Table *)[self registTableClass:[JYTest1Table class]];
}];
@weakify(self)
[RACObserve([ArtUserConfig shared], userId)subscribeNext:^(NSString *x) {
@strongify(self)
if ([self.userId isEqualToString:x]) {
return;
}
self.documentDirectory = nil;
[self construct];
}];
}
这种使用方式本身是没有问题的，但在实际的业务使用场景可能照成一些问题，比如在使用用户数据存储时，我将用
户数据存入用户数据库，在程序中只传递userId 在需要使用时才从 数据库中读取。这时如果退出登录，此时访问的
数据库就不是插入的数据库，那么就取不到数据。
如何解决上述问题，我的建议是 建立 两种数据库，一种是公用数据库(该库不区分用户)，还有一种是 独立数据库
(每个用户都建一个)。对于社交应用，缓存用户信息的表放倒 公用数据库 即可。
1.增加了多表关联功能，ModelA 包含 ModelB 的存入取出也可用简单的配置解决。
2.删除了UIImage的数据库存储支持。
3.删除了内存缓存支持，这是一个很鸡肋无用的处理。需要可以自行在外部加上自己的缓存机制。
4.DEMO做了大的修改，删除毫无意义的稀烂界面。写了一个测试代码 JYContentTableTest.m
5.对代码生成工具 JYGenerationCode 做了简单修改。
DEMO中写了三模型，JYGradeInfo (年级)，JYClassInfo (班级)，JYPersonInfo（人）
他们之间的关系是，一个年级有多个班级，一个班级 有一个老师 和 多个学生。对此建立了三张
表JYGradeTable（年级表），JYClassTable（班级表），JYPersonTable（人表）。
多表关联采用主外键形式：JYClassTable中的 gradeID 字段就是对应JYGradeTable的外
键.JYPersonTable 中的teacherClassID 对应 JYGradeTable的老师外键studentClassID
对应 JYGradeTable 的学生外键。
1.外键功能的实现:我在直接使用SQL的外键功能时遇到了一些问题(有空会再回头看看)，这理是
使用简单粗暴的形势实现的级联删除。在进行条件删除条件查询时会比较耗时。（也不是很糟糕
哈），有空我会有sql外键形式看看做下对比。
2.关联表设置参考DEMO 按如下设置即可
- (NSDictionary<NSString *, NSDictionary *> *)associativeTableField{
JYPersonTable *table = [JYDBService shared].personDB.personTable;
// tableSortKey 不设置查询时会以主key做升序放入数组
return @{
@"teacher" : @{
tableContentObject : table,
tableViceKey : @"teacherClassID"
},
@"students" : @{
tableContentObject : table,
tableViceKey : @"studentClassID",
tableSortKey : @"studentIdx"
}
};
}
3.为外键字段加上索引提高查询效率
// 为 gradeID 加上索引
- (void)addOtherOperationForTable:(FMDatabase *)aDB{
[self addDB:aDB uniques:@[@"gradeID"]];
}
框架虽然提供了 NSData，NSNumber，NSDictionary，NSMutableDictionary，
NSMutableArray，NSArray 这些对象的存储（其中数组字典要可反序列化），但是它们
在数据库中的存储类型都是 BLOB 类型，这导致sql查询查不出来，所以需要查询的字段请
使用NSString及基本数据类型。
因为业务需求问题，是未考虑主键自增的，主键不可为空，请自行处理随机生成唯一主键。