美文网首页iOS 学习历程
iOS本地存储的几种方案简单介绍

iOS本地存储的几种方案简单介绍

作者: 人话博客 | 来源:发表于2018-03-23 16:14 被阅读13次

    一般 App 开发,都会在客户端本地存储一些数据。
    说白了,就是存储在当前 App 的沙盒硬盘中。

    一般本地存储方式有下面几种:

    1. 个人偏好设置。
    2. 本地的 File 文件存储。
    3. 自定义对象的归档和解档
    4. FMDB 对应的 SQLite 存储
    5. CoreData
    6. 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> 协议,并实现协议的两个方法。

    自定义对象归档和解档的基本步骤:

    1. 首先需要归档解档的对象,必须遵守 <NSCoding> 协议
    2. 归档实现协议里的 - (void)encodeWithCoder:(NSCoder *)aCoder 方法。
    3. 解档实现协议里的 - (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;
    

    在此基类的内部,有两个关键的步骤:

    1. 拿到当前类型的属性列表以及属性数据类型。
    2. 根据拿到的属性列表以及属性类型,进行归档/解档操作。
    // 定义一个私有类型,存储当前对象的属性以及属性的数据类型。
    @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];
    }
    

    使用

    1. 让需要归档、解档的 Person 继承此类 。RLPerson : RLBaseModel
    2. 在调用的地方,直接使用基类提供的归档&解档的方法即可。

    归档

     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 原生的使用方式好处有:

    1. 使用起来更加面向对象。
    2. 提供了线程安全操作的类型 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 会在下篇文章中,进行说明。

    相关文章

      网友评论

        本文标题:iOS本地存储的几种方案简单介绍

        本文链接:https://www.haomeiwen.com/subject/ewexcftx.html