一般 App 开发，都会在客户端本地存储一些数据。
说白了，就是存储在当前 App 的沙盒硬盘中。
一般本地存储方式有下面几种：
- 个人偏好设置。
- 本地的 File 文件存储。
- 自定义对象的归档和解档
- FMDB 对应的 SQLite 存储
- CoreData
- Realm
个人偏好设置
由于个人偏好设置的本质就是在沙盒目录的 Library/Preferences 下面存储一个 bundleId.plist 的文件。
所以，从文件存储上，可以看出个人偏好设置只能存储 Foundation 框架自带的一些类型。
比如 : NSString、NSDictionary ,NSArray 等。
使用场景：
一般用于存储个人App 配置相关的一些数据。比如：自动登陆、记住密码、App 内选项的状态等。
特点：
在 iPhone 连接 iTunes 的时候，会和 Document 沙盒路径一样，会同步这些数据。
个人偏好设置的使用：
由于个人偏好设置本质上是一个根节点为 NSDictionary 的 plist 文件。
所以，在使用上面，可以非常简单的使用类似于 字典赋值的语法。
个人偏好设置赋值
[[NSUserDefaults standardUserDefaults] setObject:@"湖北省武汉市" forKey:kPreferencesKey];
个人偏好取值
[[NSUserDefaults standardUserDefaults] objectForKey:kPreferencesKey]
补充：
使用个人偏好设置的时候，注意最好同步一下存储。毕竟从内存到沙盒，存在一个 I/O 操作。
[[NSUserDefaults standardUserDefaults] synchronize]; // 同步存储
直接把数据存储成本地的 File 文件。
在某些场景下，比如从服务器下载了一个商品的列表。
服务器一般返回的是 JSON 格式数据。
如果数据量较小，并且基本只需要缓存少数页面的数据的话，可以图个方便，直接把数据存储成本地的 file 文件。
从服务器获取到的商品列表 JSON 数据 并缓存到 cache 沙盒路径。
[[[NSURLSession sharedSession] dataTaskWithURL:[NSURL URLWithString:@"http://127.0.0.1/apps.json"] completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
if (error) {
NSLog(@"%@",error);
return ;
}
NSString *savePath = [NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES).firstObject stringByAppendingPathComponent:@"netDataCache"];
if (![[NSFileManager defaultManager] fileExistsAtPath:savePath]) {
[[NSFileManager defaultManager] createDirectoryAtPath:savePath withIntermediateDirectories:YES attributes:nil error:nil];
}
NSString *filePath = [savePath stringByAppendingPathComponent:kJsonDataFileName];
[data writeToFile:filePath atomically:NO];
// 文件已经写入到沙盒目录了。
NSLog(@"JSON READ THREAD : %@",[NSThread currentThread]);
// JSON READ THREAD : <NSThread: 0x618000068900>{number = 3, name = (null)}
// I/O 操作正好也在子线程执行了。
NSLog(@"%@",filePath);
}] resume];
}
因为 dataTask 是在子线程执行的，所以把 File 的缓存也直接放在里面非常合适。
自定义对象的归档和解档
只要开发 App，就必然就自定义对象的创建。
对于自定义对象的存储，有一种比较合适的方式，那就是归档/解档。
使用归档/解档的好处与代价：
好处是：存储的数据取出来就直接是直接存储进去的对象了，非常方便。
代价是：需要实现<NSCoding>协议，并实现协议的两个方法。
自定义对象归档和解档的基本步骤：
- 首先需要归档解档的对象，必须遵守
<NSCoding>协议 - 归档实现协议里的
- (void)encodeWithCoder:(NSCoder *)aCoder方法。 - 解档实现协议里的
- (instancetype)initWithCoder:(NSCoder *)aDecoder方法。
DEMO如下：
有一个需要归档/解档的 Person 对象。
遵守 <NSCoding> 协议。
@interface RLPerson : NSObject<NSCoding>
接着实现对应归档/解档的两个方法。
// 对象的接档
//- (instancetype)initWithCoder:(NSCoder *)aDecoder {
// if (self = [super init]) {
// self.name = [aDecoder decodeObjectForKey:@"name"];
// self.age = [aDecoder decodeIntegerForKey:@"age"];
// self.hobbies = [aDecoder decodeObjectForKey:@"hobbies"];
// }
//
// return self;
//}
//- (void)encodeWithCoder:(NSCoder *)aCoder {
// [aCoder encodeObject:self.name forKey:@"name"];
// [aCoder encodeInteger:self.age forKey:@"age"];
// [aCoder encodeObject:self.hobbies forKey:@"hobbies"];
//}
然后再调用的方法，这么使用。
归档对象。
RLPerson *p = [RLPerson personWithName:@"李四" age:12 hobbies:@[@"写代码",@"看书",@"看电影",@"开车"]];
NSString *objFileName = [NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES).firstObject stringByAppendingPathComponent:kDIYObjcFileName];
[NSKeyedArchiver archiveRootObject:p toFile:objFileName];
解档对象
NSString *objFileName = [NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES).firstObject stringByAppendingPathComponent:kDIYObjcFileName];
// 优势在于，取出来字节就是对象!
RLPerson *p = [NSKeyedUnarchiver unarchiveObjectWithFile:objFileName];
归档对象的最大优势在于：存储的到 file 的归档数据，取出来直接就是之前存储好的对象！
补充几点：
由于，需要归档和解档的自定义对象，肯定不只有 Person 这一个。
一般的做法是，会定义一个基类。完成归档和解档的操作。
归档和解档的具体操作核心，无非就是需要拿到当前对象的属性列表，以及属性的数据类型。
// 定义一个归档/解档的基类
@interface RLBaseModel : NSObject <NSCoding>
提供两个归档&解档的方法。
/// 归档
- (void)arichiveToFile:(NSString *)filePath;
/// 解档
+ (id)unArichiveWithFile:(NSString *)filePath;
在此基类的内部，有两个关键的步骤：
- 拿到当前类型的属性列表以及属性数据类型。
- 根据拿到的属性列表以及属性类型，进行归档/解档操作。
// 定义一个私有类型，存储当前对象的属性以及属性的数据类型。
@interface RLProSaveModel : NSObject
@property (nonatomic,copy) NSString *proName;
@property (nonatomic,copy) NSString *proType;
@end
@implementation RLProSaveModel
@end
/// 为什么不用分类而是用基类？
/// 用分类的话，那么所有的继承自 NSObject 的对象都可以归档和解档了。
/// 其实也没必要。
/// 用分类和基类都可以，看如何选择了。
/// 我在这里就用基类。
@implementation RLBaseModel
- (instancetype)initWithCoder:(NSCoder *)aDecoder {
if (self = [super init]) {
[[[self class] getProList] enumerateObjectsUsingBlock:^(RLProSaveModel * _Nonnull saveModel, NSUInteger idx, BOOL * _Nonnull stop) {
if ([saveModel.proType hasPrefix:@"TQ"]) {
[self setValue:@([aDecoder decodeIntegerForKey:saveModel.proName]) forKey:saveModel.proName];
} else {
[self setValue:[aDecoder decodeObjectForKey:saveModel.proName] forKey:saveModel.proName];
}
}];
}
return self;
}
- (void)encodeWithCoder:(NSCoder *)aCoder {
[[[self class] getProList] enumerateObjectsUsingBlock:^(RLProSaveModel * _Nonnull saveModel, NSUInteger idx, BOOL * _Nonnull stop) {
if ([saveModel.proType hasPrefix:@"TQ"]) {
[aCoder encodeInteger:[[self valueForKey:saveModel.proName] integerValue] forKey:saveModel.proName];
} else {
[aCoder encodeObject:[self valueForKey:saveModel.proName] forKey:saveModel.proName];
}
}];
}
/// 使用关联对象，设置当前类型的属性类表属性。
/// 这个属性类表属性是绑定在当前类上，而不是实例上。
+ (NSArray<RLProSaveModel *> *)getProList {
NSArray *proList = objc_getAssociatedObject([self class], _cmd);
if (proList) {
return proList;
}
unsigned int count;
objc_property_t *ps = class_copyPropertyList([self class], &count);
NSMutableArray *arrM = [NSMutableArray arrayWithCapacity:count];
for (NSInteger i = 0; i < count; i++) {
NSString *proName = [NSString stringWithUTF8String:property_getName(ps[i])];
NSString *proType = [NSString stringWithUTF8String:property_getAttributes(ps[i])];
RLProSaveModel *saveModel = [RLProSaveModel new];
saveModel.proName = proName;
saveModel.proType = proType; // int 数据类型的 Property_Type = TQ,N,V_age
[arrM addObject:saveModel];
}
proList = arrM.copy;
objc_setAssociatedObject([self class], _cmd, proList, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
return proList;
}
/// 归档
- (void)arichiveToFile:(NSString *)filePath {
[NSKeyedArchiver archiveRootObject:self toFile:filePath];
}
+ (id)unArichiveWithFile:(NSString *)filePath {
return [NSKeyedUnarchiver unarchiveObjectWithFile:filePath];
}
使用
- 让需要归档、解档的
Person继承此类 。RLPerson : RLBaseModel。 - 在调用的地方，直接使用基类提供的归档&解档的方法即可。
归档
RLPerson *p = [RLPerson personWithName:@"李四" age:12 hobbies:@[@"写代码",@"看书",@"看电影",@"开车"]];
NSString *objFileName = [NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES).firstObject stringByAppendingPathComponent:kDIYObjcFileName];
// arichiveToFile 来自基类
[p arichiveToFile:objFileName];
解档
/// unArichiveWitFile 来自基类
RLPerson *p = [RLPerson unArichiveWithFile:objFileName];
补充：
把自定义对象放入 NSArray & NSDictionary中也是支持归档&解档的。
只不过，直接拿出来的是 NSArray | NSDictionary 了，需要自己遍历一下。
FMDB & SQLITE
FMDB 是 iOS 平台的 SQLite 数据操作的 OC 面向对象的封装。（对 SQLite 操作以前是用一套 C 语言的函数）
FMDB 相对于 SQLITE 原生的使用方式好处有：
- 使用起来更加面向对象。
- 提供了线程安全操作的类型
FMDataBaseQueue。
有些时候，App 内存会存储一些带有列表方面的数据，比如用户的个人收藏、用户的原始消息记录等。
这个时候，光存储数据不够了，数据还需要有一定的逻辑在里面。
这个时候，可以选择使用 SQLite 来存储。
FMDB 的基本使用
因为本质上 FMDB 就是一个 Sqlite 数据库操作的 OC 封装。对于存储本身来说，一定是有一个文件存储在沙盒中的。
(个人偏好设置有一个 bundleId.plist 文件、文件 File 有本地文件、自定义对象的归档&解档也有文件。)
这个文件就是 sqlite 数据文件。
所以，使用 FMDB 第一步也是给定个路径，创建本地的 sqlite 数据库文件。
NSString *queueSqlitePath = [NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES).firstObject stringByAppendingPathComponent:@"queueDemo.sqlite"];
// 线程安全的数据库
instance->_queueDataBase = [FMDatabaseQueue databaseQueueWithPath:queueSqlitePath];
数据库创建完毕之后，根据业务需要，则要开始创建表格了。
[_queueDataBase inDatabase:^(FMDatabase * _Nonnull db) {
[db executeUpdate:@"CREATE TABLE IF NOT EXISTS t_person (id integer PRIMARY KEY AUTOINCREMENT,name TEXT,age integer default 1);"];
}];
表格创建完毕之后，可以根据自身需要，对表格进行 CURD 的操作了。
// INSERT
[_queueDataBase inDatabase:^(FMDatabase * _Nonnull db) {
result = [db executeUpdate:@"INSERT INTO t_person (name,age) VALUES (?,?);",person.name,@(person.age)];
NSLog(@"INSERT THREAD %@",[NSThread currentThread]);
}];
// DELETE
__block BOOL result = NO;
[_queueDataBase inDatabase:^(FMDatabase * _Nonnull db) {
result = [db executeUpdate:@"DELETE FROM t_person WHERE ID = ?;",@(personID)];
}];
return result;
// UPDATE
__block BOOL result = NO;
[_queueDataBase inDatabase:^(FMDatabase * _Nonnull db) {
result = [db executeUpdate:@"UPDATE T_PERSON SET NAME = ? ,AGE = ? WHERE ID = ?;",person.name,@(person.age),@(person.pid)];
}];
return result;
// SELECT
NSMutableArray *arrM = [NSMutableArray array];
[_queueDataBase inDatabase:^(FMDatabase * _Nonnull db) {
FMResultSet *resultSet = [db executeQuery:@"SELECT ID,NAME,AGE FROM T_PERSON WHERE ID LIMIT ?,?;",@(pageIndex),@(pageCount)];
while ([resultSet next]) {
RLPersonDataBase *p = [RLPersonDataBase new];
p.name = [resultSet stringForColumn:@"name"];
p.age = [resultSet intForColumn:@"age"];
p.pid = [resultSet intForColumn:@"id"];
[arrM addObject:p];
}
}];
return arrM.copy;
补充
使用 FMDB 有个前提是需要熟悉 SQL 语句的编写。
使用 FMDB 在执行 SQL 语句传递参数的时候用 ? 占位。
并且占位的 ? 的传值，一定是一个 OC 的对象类型。即使是一个 int 类型的 5 。 在传递给 ? 的时候，也一定要包装成 @5。
FMDatabaseQueue 也支持事物操作：
[_queueDataBase inTransaction:^(FMDatabase * _Nonnull db, BOOL * _Nonnull rollback) {
// 写一些数据操作。
// 如果出现了问题回滚
if (error) {
*rollback = YES;
}
}];
CoreData & Realm 会在下篇文章中，进行说明。
