应用场景
iOS10后,发现在大量用户在NSUserDefaults中取值失败,导致一系列的持久化状态丢失。故切换到SQLitie3持久化更适合大型项目的使用。
场景一:在大型项目中,经常需要我们写的代码支持可降级,对一些新功能进行灰度验证。那运营开关是必不可少的。运营开关的配置就需要持久化设置了,即时网络异常,也需要读取上一次的正常记录的。
场景二:在大型项目中,有一些资源是需要动态配置的,那就可以集中放在一个接口里处理。比如大促的动态图、资源背景图、弹窗提示文案等。当接口异常时,需要读取本地数据库里上次存储的
场景三:用户的常规操作设置,也需要持久化记录,比如,新手指引弹框,当用户点了不再提醒,就应该记录到本地,下次不再提醒。还有就是超过多少次,不再提醒等一下用户的设置
场景四:需要全局使用的数据,也可以放到内存中,但不存入数据库,只当是内存的一个单例管理。
具体思路
- 依赖第三方库FMDB,YYModel
- 基于FMDB,按业务建立不同的数据表,将需要持久化的数据,通过key-Value的存储方式,存储到sqlite3数据库中
- 全局状态量均由VSPersistence这个单例来进行管理,拆分为5个模块: defaultPersistence / dynamicPersistence / memoryPersistence / switchPersistence / userPersistence
- APP启动,将sqlite3的数据加载到JSPersistence中
场景及数据表说明
1.defaultPersistence(YSDefaultPersistence)
用于管理需要持久化的普通状态量,可理解为不属于这4个模块(dynamicPersistence / memoryPersistence / switchPersistence / userPersistence)的状态量。
2.dynamicPersistence(YSDynamicPersistence)
动态资源,APP动态配置的资源,APP启动时,请求接口返回
3.memoryPersistence(YSMemoryPersistence)
用于管理不需要持久化的配置项。
4.switchPersistence(YSSwitchPersistence)
运营开关,降级开关,APP启动时请求接口返回
5.userPersistence(YSUserPersistence)
用于管理记录用户行为的配置项,如:记录提示页是否展示过,记录提示页上次展示的时间……
YSPersistence全局单例类
全局单例类,管理上面5个模块场景
@interface YSPersistence : NSObject
/** 用于管理需要持久化的普通状态量,可理解为不属于这4个模块(dynamicPersistence / memoryPersistence / switchPersistence / userPersistence)的状态量 */
+ (YSDefaultPersistence *)defaultPersistence;
/** 动态资源,APP动态配置的资源,APP启动时,请求接口返回 */
+ (YSDynamicPersistence *)dynamicPersistence;
/** 用于管理不需要持久化的配置项,仅存在内存中。比如某个接口数据返回,需要记录某个字段的值 */
+ (YSMemoryPersistence *)memoryPersistence;
/** 运营开关,降级开关,APP启动时请求接口返回 */
+ (YSSwitchPersistence *)switchPersistence;
/** 用于管理记录用户行为的配置项,如:记录提示页是否展示过,记录提示页上次展示的时间 */
+ (YSUserPersistence *)userPersistence;
@end
底层结构
1. YSKeyValueStack
轻量级的用于单例化FMDatabaseQueue的堆栈类,基于Key-Value的存储方式,做了一些定制化的优化配置。
主要方法:
// 给数据表增加一个key-value
void YSKeyValueSetKeyValueToTable(FMDatabase *db, NSString *key, id value, NSString *tableName) {
NSDictionary<NSString *, id> *JSONObject = @{ key: value };
// [JSONObject yy_modelToJSONData]可能是因为多线程修改了内容导致崩溃
NSData *data = [[JSONObject copy] yy_modelToJSONData];
if (!data) {
#if DEBUG
dispatch_async(dispatch_get_main_queue(), ^{
@throw [NSException exceptionWithName:@"Key-Value 不是有效的JSON对象(上报到RTX吧)" reason:@"保持统一性" userInfo:nil];
});
#endif
return;
}
NSString *SQLScript = [NSString stringWithFormat:kSQLFormatterForReplaceValue, tableName, key];
[db executeUpdate:SQLScript, data];
}
// 从数据表里删除key-value
void JSKeyValueRemoveKeyValueToTable(FMDatabase *db, NSString *key, NSString *tableName) {
NSString *SQLScript = [NSString stringWithFormat:kSQLFormatterForDeleteValue, tableName, key];
[db executeUpdate:SQLScript];
}
2. NSObject+YSKeyValueModel
用于基于KeyValueStack的ORM,具体使用方法可参考代码中的例子。
最主要的方法是,需要给每个属性添加KVO监听,当接口数据回来或者属性的值有变化时,就会触发KVO监听方法,从而更新数据库
/**
* 监听值的变化
* 1、将需要变化的keyValue都存储到VSKeyValueStackCachedChangeObjects中
* 2、每隔1秒,将VSKeyValueStackCachedChangeObjects中的keyValue拷贝到局部变量cachedChangeObjects中,并清空VSKeyValueStackCachedChangeObjects里面所有的数据
* 3、将cachedChangeObjects循环存储到sqlite中
*/
- (void)observeValueForKeyPath:(NSString *)keyPath ofObject:(id<VSKeyValueModel>)object change:(NSDictionary<NSString *, id> *)change context:(void *)context {
if (context != VSKeyValueStackObserverContext) {
return;
}
void(^batchHandler)(void) = ^(void) {
UIBackgroundTaskIdentifier __block taskToken = [[UIApplication sharedApplication] beginBackgroundTaskWithExpirationHandler:NULL];
dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(1 * NSEC_PER_SEC)), VSKeyValueStackCachedChangeQueue, ^{
NSArray<__VSKeyValueChange *> *cachedChangeObjects = [VSKeyValueStackCachedChangeObjects copy];
[JSKeyValueStackCachedChangeObjects removeAllObjects];
[self handleTransaction:^(FMDatabase *db) {
for (__VSKeyValueChange *__change in cachedChangeObjects) {
@autoreleasepool {
// 如果值为空,则从数据表中移除;有值则更新
if (IsEmpty(__change.value)) {
VSKeyValueRemoveKeyValueToTable(db, __change.key, __change.tableName);
} else {
VSKeyValueSetKeyValueToTable(db, __change.key, __change.value, __change.tableName);
}
}
}
[[UIApplication sharedApplication] endBackgroundTask:taskToken];
taskToken = UIBackgroundTaskInvalid;
}];
});
};
id value = change[NSKeyValueChangeNewKey];
dispatch_async(JSKeyValueStackCachedChangeQueue, ^{
// batchHandler 限定了每隔1秒,处理一次VSKeyValueStackCachedChangeObjects所有的key,并清空
if (!VSKeyValueStackCachedChangeObjects.count) {
batchHandler();
}
// 将需要变化的keyValue都存储到VSKeyValueStackCachedChangeObjects中
__JSKeyValueChange *__change = [__JSKeyValueChange new];
__change.tableName = [object keyValueTableName];
__change.key = keyPath;
__change.value = value;
[JSKeyValueStackCachedChangeObjects addObject:__change];
});
}
使用方法
1. 新建一个YSDemoPersistence,实现协议YSKeyValueModel
2. 在YSDemoPersistence.h 中添加你需要存入数据库的字段名,当然也可以存入数组和字典
3. 在YSDemoPersistence.m 中,给 -initWithKeyValueStack 初始化方法的所有属性加上KVO监听、dealloc 的时候移除监听、实现协议keyValueTableName返回数据库表名、如果有默认值,在
setUpWithDefaultValue设置。
@implementation YSUserPersistence
- (instancetype)initWithKeyValueStack
{
self = [super initWithKeyValueStack];
if (self) {
[self addKeyPathObserverToKeyValueStack];
}
return self;
}
- (void)dealloc
{
[self removeKeyPathObserverFromKeyValueStack];
}
#pragma mark - <YSKeyValueModel>
- (NSString *)keyValueTableName
{
return @"UserPersistence";
}
// 设置属性默认值
- (void)setUpWithDefaultValue
{
_themeStyle = 0;
_checkoutAgreeProtocolsMap = @{};
}
@end