簡(jiǎn)介

Demo
所謂的持久化，就是將數(shù)據(jù)保存到硬盤中舞萄，使得在應(yīng)用程序或機(jī)器重啟后可以繼續(xù)訪問(wèn)之前保存的數(shù)據(jù)眨补。在iOS開(kāi)發(fā)中，有很多數(shù)據(jù)持久化的方案倒脓，接下來(lái)介紹以下幾種方案：

• plist文件（屬性列表）
• preference（偏好設(shè)置）
• NSKeyedArchiver（歸檔）
• Keychain (鑰匙串)
• SQLite 3
• FMDB
• WCDB
• CoreData

沙盒

首先需要了解什么是沙盒撑螺！每一個(gè)APP都有一個(gè)存儲(chǔ)空間，就是沙盒崎弃。APP之間不能相互通信甘晤。沙盒根目錄結(jié)構(gòu)：.app含潘、Documents、Library安皱、tmp调鬓。效果如圖：

沙盒目錄.png

訪問(wèn)沙盒目錄常用C函數(shù)介紹

//文件路徑搜索
FOUNDATION_EXPORT NSArray<NSString *> *NSSearchPathForDirectoriesInDomains(NSSearchPathDirectory directory, NSSearchPathDomainMask domainMask, BOOL expandTilde);

該方法返回值為一個(gè)數(shù)組,在iphone中由于只有一個(gè)唯一路徑,所以直接取數(shù)組第一個(gè)元素即可.

參數(shù)1：指定搜索的目錄名稱艇炎，比如這里用NSDocumentDirectory表明我們要搜索的是Documents目錄酌伊。
如果我們將其換成NSCachesDirectory就表示我們搜索的是Library/Caches目錄。

參數(shù)2：搜索主目錄的位置缀踪，NSUserDomainMask表示搜索的范圍限制于當(dāng)前應(yīng)用的沙盒目錄居砖。
還可以寫成NSLocalDomainMask（表示/Library）、NSNetworkDomainMask（表示/Network）等

參數(shù)3：是否獲取完整的路徑驴娃，我們知道在iOS中的全寫形式是/User/userName奏候，該值為YES即表示寫成全寫形式，為NO就表示直接寫成“~”唇敞。
該值為NO:Caches目錄路徑為~/Library/Caches
該值為YES:Caches目錄路徑為
/var/mobile/Containers/Data/Application/E7B438D4-0AB3-49D0-9C2C-B84AF67C752B/Library/Caches

typedef NS_OPTIONS(NSUInteger, NSSearchPathDomainMask) {
    NSUserDomainMask = 1,       // 用戶目錄 - 基本上就用這個(gè)蔗草。 
    NSLocalDomainMask = 2,      // 本地
    NSNetworkDomainMask = 4,    // 網(wǎng)絡(luò) 
    NSSystemDomainMask = 8,     // 系統(tǒng)
    NSAllDomainsMask = 0x0ffff  // 所有 
};

//常用的NSSearchPathDirectory枚舉值
typedef NS_ENUM(NSUInteger, NSSearchPathDirectory) {
    NSApplicationDirectory = 1,             // supported applications (Applications)
    NSDemoApplicationDirectory,             // unsupported applications, demonstration versions (Demos)
    NSAdminApplicationDirectory,            // system and network administration applications (Administration)
    NSLibraryDirectory,                     // various documentation, support, and configuration files, resources (Library)
    NSUserDirectory,                        // user home directories (Users)
    NSDocumentationDirectory,               //  Library 下的(Documentation)模擬器上沒(méi)有創(chuàng)建
    NSDocumentDirectory,                    // documents (Documents)

};

1、Documents 目錄：

您應(yīng)該將所有的應(yīng)用程序數(shù)據(jù)文件寫入到這個(gè)目錄下疆柔。這個(gè)目錄用于存儲(chǔ)用戶數(shù)據(jù)咒精。該路徑可通過(guò)配置實(shí)現(xiàn)iTunes共享文件】醯担可被iTunes備份模叙。
此文件夾是默認(rèn)備份的,備份到iCloud

注:iCloud的備份，會(huì)通過(guò)Wi-Fi每天自動(dòng)備份用戶iOS設(shè)備鞋屈。

// 獲取Documents目錄路徑
NSString *docDir = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) firstObject];

2范咨、AppName.app 目錄：

這是應(yīng)用程序的程序包目錄，包含應(yīng)用程序的本身厂庇。由于應(yīng)用程序必須經(jīng)過(guò)簽名渠啊，所以您在運(yùn)行時(shí)不能對(duì)這個(gè)目錄中的內(nèi)容進(jìn)行修改，否則可能會(huì)使應(yīng)用程序無(wú)法啟動(dòng)权旷。

// 獲取沙盒主目錄路徑
NSString *homeDir = NSHomeDirectory();

3昭抒、Library 目錄：這個(gè)目錄下有兩個(gè)子目錄：

image.png

• Preferences 目錄：包含應(yīng)用程序的偏好設(shè)置文件。您不應(yīng)該直接創(chuàng)建偏好設(shè)置文件炼杖，而是應(yīng)該使用NSUserDefaults類來(lái)取得和設(shè)置應(yīng)用程序的偏好.

// 獲取Library的目錄路徑
NSString *libDir = [NSSearchPathForDirectoriesInDomains(NSLibraryDirectory, NSUserDomainMask, YES) lastObject];

• Caches 目錄：用于存放應(yīng)用程序?qū)Ｓ玫闹С治募鸱担４鎽?yīng)用程序再次啟動(dòng)過(guò)程中需要的信息。
  可創(chuàng)建子文件夾坤邪∥鹾可以用來(lái)放置您希望被備份但不希望被用戶看到的數(shù)據(jù)。該路徑下的文件夾艇纺，除Caches以外怎静，都會(huì)被iTunes備份邮弹。

// 獲取Caches目錄路徑
NSString *cachesDir = [NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) firstObject];

1.緩存數(shù)據(jù)應(yīng)該保存在/Library/Caches目錄下.
2.緩存數(shù)據(jù)在設(shè)備低存儲(chǔ)空間時(shí)可能會(huì)被刪除，iTunes或iCloud不會(huì)對(duì)其進(jìn)行備份蚓聘。
3.可以保存重新下載或生成的數(shù)據(jù)腌乡，而且沒(méi)有這些數(shù)據(jù)也不會(huì)妨礙用戶離線使用應(yīng)用的功能。
4.當(dāng)訪問(wèn)網(wǎng)絡(luò)時(shí)系統(tǒng)自動(dòng)會(huì)把訪問(wèn)的url,以數(shù)據(jù)庫(kù)的方式存放在此目錄下面.

image

5.Snapshots系統(tǒng)截圖文件夾

4夜牡、tmp 目錄：

這個(gè)目錄用于存放臨時(shí)文件与纽，保存應(yīng)用程序再次啟動(dòng)過(guò)程中不需要的信息。該路徑下的文件不會(huì)被iTunes備份塘装。

// 獲取tmp目錄路徑
NSString *tmpDir =  NSTemporaryDirectory();

注意：每次編譯代碼會(huì)生成新的沙盒路徑, 注意是編譯不是啟動(dòng),所以模擬器或者真機(jī)運(yùn)行你每次運(yùn)行所得到的沙盒路徑都是不一樣,線上版本app真機(jī)不會(huì)生成新的沙盒路徑

plist文件（屬性列表）

plist文件是將某些特定的類急迂，通過(guò)XML文件的方式保存在目錄中。
可以被序列化的類型只有如下幾種：

NSString;//字符串
NSMutableString;//可變字符串
NSArray;//數(shù)組
NSMutableArray;//可變數(shù)組
NSDictionary;//字典
NSMutableDictionary;//可變字典
NSData;//二進(jìn)制數(shù)據(jù)
NSMutableData;//可變二進(jìn)制數(shù)據(jù)
NSNumber;//基本數(shù)據(jù)
NSDate;//日期

這里我們就用NSDictionary為例,其他的類型和這個(gè)方法類似;

/**
 寫入數(shù)據(jù)
 */
-(void)writeToPlist:(NSDictionary *)dict plistName:(NSString *)plistName{
    //存取路徑
    NSString *path = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES).firstObject;
    //路徑中文件名
    NSString *filePath = [path stringByAppendingPathComponent:plistName];
    //序列化,把數(shù)據(jù)存入指定目錄的plist文件
    [dict writeToFile:filePath atomically:YES];
}
/**
 根據(jù)plist文件名讀取數(shù)據(jù)
 */
-(NSDictionary *)readFromPlistWithPlistName:(NSString *)plistName{
    //存取路徑
    NSString *path = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES).firstObject;
    //路徑中文件名
    NSString *filePath = [path stringByAppendingPathComponent:plistName];
    NSDictionary *resultDict = [NSDictionary dictionaryWithContentsOfFile:filePath];
    return resultDict;
}

preference（偏好設(shè)置）

很多iOS應(yīng)用都支持偏好設(shè)置蹦肴，比如保存用戶名僚碎、密碼、字體等設(shè)置阴幌。
每個(gè)應(yīng)用都有NSUserDefaults實(shí)例勺阐，通過(guò)它來(lái)讀取偏好設(shè)置。
一般不要在偏好設(shè)置中保存其他數(shù)據(jù)矛双。
偏好設(shè)置是key-value的方式存取和讀取的渊抽。

NSUserDefaults就是默認(rèn)存放在此文件夾下面,iTunes或iCloud會(huì)備份該目錄。

//獲取Preferences目錄路徑
NSString *preferencesPath=[[NSSearchPathForDirectoriesInDomains(NSLibraryDirectory, NSUserDomainMask, YES) firstObject] stringByAppendingString:@"/Preferences"];

打印結(jié)果：

image

/**
 保存數(shù)據(jù)
 */
- (IBAction)saveDate:(UIButton *)sender {
    //獲得NSUserDefaults文件
    NSUserDefaults *userDefaultes = [NSUserDefaults standardUserDefaults];
    //向偏好設(shè)置中寫入內(nèi)容
    [userDefaultes setObject:@"lcf" forKey:@"name"];
    [userDefaultes setInteger:26 forKey:@"age"];
    [userDefaultes setObject:@"boy" forKey:@"sex"];
    //立即同步設(shè)置
    [userDefaultes synchronize];
}
/**
 讀取數(shù)據(jù)
 */
- (IBAction)readDate:(UIButton *)sender {
    //獲得NSUserDefaults文件
    NSUserDefaults *userDefaultes = [NSUserDefaults standardUserDefaults];
    //讀取偏好設(shè)置
    NSString *name = [userDefaultes objectForKey:@"name"];
    NSInteger age = [userDefaultes integerForKey:@"age"];
    NSString *sexStr = [userDefaultes objectForKey:@"sex"];
    NSLog(@"\n%@\n%ld\n%@",name,age,sexStr);
}

注意事項(xiàng)：

• 如果沒(méi)有調(diào)用synchronize方法背零，系統(tǒng)會(huì)根據(jù)I/O情況不定時(shí)刻地保存到文件中腰吟。所以如果需要立即寫入，就必須調(diào)用synchronize方法徙瓶。
• 偏好設(shè)置會(huì)將所有數(shù)據(jù)保存到同一個(gè)文件夾毛雇，使用同一個(gè)key，會(huì)把之前存儲(chǔ)的數(shù)據(jù)覆蓋侦镇。

NSKeyedArchiver（歸檔）

歸檔在iOS中是另一種形式的序列化灵疮，只要遵循了NSCoding協(xié)議的對(duì)象都可以通過(guò)它來(lái)實(shí)現(xiàn)序列化。由于大多是類都遵循了NSCoding協(xié)議壳繁，因此震捣，對(duì)于大多數(shù)類來(lái)說(shuō)，歸檔是比較容易實(shí)現(xiàn)的闹炉。

遵循NSCoding協(xié)議,其中有2個(gè)方法是必須實(shí)現(xiàn)的：

• initWithCoder
• encodeWithCoder

//遵循NSCoding協(xié)議
@interface DWSave : NSObject<NSCoding>
/**name*/
@property(nonatomic ,copy)NSString *name;
/**age*/
@property(nonatomic ,assign)NSInteger age;
/**sex*/
@property(nonatomic ,assign)BOOL sex;
@end
//以上內(nèi)容要寫在.h文件中

@implementation DWSave
//歸檔
-(void)encodeWithCoder:(NSCoder *)aCoder{
    [aCoder encodeObject:self.name forKey:@"name"];
    [aCoder encodeInteger:self.age forKey:@"age"];
    [aCoder encodeBool:self.sex forKey:@"sex"];
}
//解檔
-(instancetype)initWithCoder:(NSCoder *)aDecoder;{
    if (self = [super init]) {
        self.name = [aDecoder decodeObjectForKey:@"name"];
        self.age = [aDecoder decodeIntegerForKey:@"age"];
        self.sex = [aDecoder decodeBoolForKey:@"sex"];
    }
    return self;
}
@end

NSKeyedArchiver歸檔

//保存地址
    NSString *path = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES).firstObject;
    //文件名
    NSString *filePath = [path stringByAppendingPathComponent:@"wyp.data"];
    DWSave *save = [[DWSave alloc] init];
    //設(shè)置數(shù)據(jù)
    save.name = @"lcf";
    save.age = 26;
    save.sex = 1;
    [NSKeyedArchiver archiveRootObject:save toFile:filePath];

NSKeyedUnarchiver解檔

NSString *path = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES).firstObject;
    NSString *filePath = [path stringByAppendingPathComponent:@"wyp.data"];
    DWSave *save = [NSKeyedUnarchiver unarchiveObjectWithFile:filePath];
    if (save) {
        NSLog(@"\n%@\n%ld\n%d",save.name,save.age,save.sex);    
    }

必須要遵循NSCoding協(xié)議
保存文件的擴(kuò)展名可以自定義
如果需要?dú)w檔的類是某個(gè)自定義類的子類時(shí)蒿赢，就需要在歸檔和解檔之前實(shí)現(xiàn)父類的歸檔和解檔方法。
[super encodeWithCoder:aCoder]和[super initWithCoder:aDecoder]方法渣触。

Keychain (鑰匙串)

通常情況下羡棵，我們使用NSUserDefaults存儲(chǔ)數(shù)據(jù)信息，但是對(duì)于一些私密信息嗅钻，但是對(duì)于一下比較私密的信息皂冰，如帳號(hào)店展、密碼等等，我們就需要使用更為安全的keychain了秃流。keychain保存的信息是保存在沙盒之外的赂蕴，不會(huì)因App的刪除而丟失，在用戶重新安裝了App后依然存在舶胀。其實(shí)可以把keychain理解成一個(gè)Dictionary概说，所有數(shù)據(jù)都以key-value的形式存儲(chǔ)，可以對(duì)這個(gè)Dictionary進(jìn)行add峻贮、update席怪、get应闯、delete這四個(gè)操作纤控。對(duì)一個(gè)應(yīng)用來(lái)說(shuō)，keychain都有兩個(gè)訪問(wèn)區(qū)碉纺，私有和公共船万。

1. Target - Capabilities - Keychain Sharing - ON

   
   
   image.png

   左側(cè)的目錄會(huì)自動(dòng)生成Entitlements文件，不需要自己創(chuàng)建了骨田。

2. 引入Security.framework

3. 詳細(xì)介紹請(qǐng)查看iOS的密碼管理系統(tǒng) Keychain的介紹和使用
   

SQLite 3

表面上SQLite將數(shù)據(jù)分為以下幾種類型：

• integer : 整數(shù)
• real : 實(shí)數(shù)（浮點(diǎn)數(shù)）
• text : 文本字符串
• blob : 二進(jìn)制數(shù)據(jù)耿导，比如文件，圖片之類的

一般用來(lái)存儲(chǔ)大量的內(nèi)容并可單一的修改更新某一條緩存信息等态贤。實(shí)際上SQLite是無(wú)類型的舱呻。即不管你在創(chuàng)表時(shí)指定的字段類型是什么，存儲(chǔ)是依然可以存儲(chǔ)任意類型的數(shù)據(jù)悠汽。而且在創(chuàng)表時(shí)也可以不指定字段類型箱吕。

// 創(chuàng)建數(shù)據(jù)庫(kù)
- (void)openDatabase
{
    NSString *filepath = [[VGFileManagerCommon getDocumentPath] stringByAppendingString:@"cache.db"];
    FMDatabase *db = [FMDatabase databaseWithPath:filepath];
    if ([db open])
    {
        self.db = db;
        NSString *sql = @"CREATE TABLE IF NOT EXISTS CACHE \
        (uid INTEGER PRIMARY KEY, \
        url TEXT, \
        title TEXT)";
        if (![self.db executeUpdate:sql])
        {
            NSLog(@"execute sql %@ error %@",sql,self.db.lastError);
        }
    }
    else
    {
        NSLog(@"open database failed %@",filepath);
    }
}

#pragma mark - public

- (NSArray <VGCacheModel *>*)fetchCacheModelWithLimit:(NSInteger)limit{
    __block NSArray *result = nil;
    NSString *sql = nil;
    if (limit) {
        sql = @"SELECT *FROM CACHE ORDER BY uid DESC LIMIT ?";
    }
    db_sync_safe(^{
        NSMutableArray <VGCacheModel *>*array = [NSMutableArray array];
        FMResultSet *rs = [self.db executeQuery:sql, @(limit)];
        while ([rs next]) {
            VGCacheModel *model = loadToDatabase(rs);
            [array addObject:model];
        }
        [rs close];
        result = array;
    });
    return result;
}


- (void)saveModels:(NSArray <VGCacheModel *>*)models{
    db_sync_safe(^{
        if ([models count]) {
            [self.db beginTransaction];
            for (VGCacheModel*model in models) {
                saveToDatabase(self.db, model);
            }
            [self.db commit];
        }
    });
}

- (void)updateModel:(VGCacheModel *)model{
    NSString *sql = @"UPDATE CACHE SET TITLE = ? WHRER uid = ?";
    db_async(^{
        if (![self.db executeUpdate:sql, model.title, model.uid]) {
            NSLog(@"update failed sql %@",sql);
        }
    });
}

#pragma mark - save & load
static inline VGCacheModel * loadToDatabase(FMResultSet *resultSet)
{
    NSInteger uid = [resultSet longLongIntForColumn:@"uid"];
    NSString *URL = [resultSet stringForColumn:@"url"];
    NSString *title = [resultSet stringForColumn:@"title"];
    
    VGCacheModel *model = [[VGCacheModel alloc] init];
    model.uid = uid;
    model.imageURL = URL;
    model.title = title;
    
    return model;
}

static inline void saveToDatabase(FMDatabase *db, VGCacheModel *model)
{
    NSString *sql = @"INSERT OR REPLACE INTO CACHE(uid, url, title) VALUES(?,?,?)";
    if(![db executeUpdate:sql,
        @(model.uid),
        model.imageURL,
        model.title]){
        NSLog(@"update failed sql %@",sql);
    }
}


#pragma mark - Queue
dispatch_queue_t cacheDatabaseQueue()
{
    static dispatch_queue_t queue;
    static dispatch_once_t onceToken;
    dispatch_once(&onceToken, ^{
        queue = dispatch_queue_create(databaseQueue, 0);
        dispatch_queue_set_specific(queue, kDatabaseQueueSpecificKey, (void *)kDatabaseQueueSpecificKey, NULL);
    });
    return queue;
}

typedef void(^dispatch_block)(void);
void db_sync_safe(dispatch_block block)
{
    if (dispatch_get_specific(kDatabaseQueueSpecificKey))
    {
        block();
    }
    else
    {
        dispatch_sync(cacheDatabaseQueue(), ^() {
            block();
        });
    }
}

void db_async(dispatch_block block){
    dispatch_async(cacheDatabaseQueue(), ^() {
        block();
    });
}

FMDB

FMDB詳解
FMDB的gitHub地址
FMDB-Demo

1.簡(jiǎn)介

FMDB是iOS平臺(tái)的SQLite數(shù)據(jù)庫(kù)框架，它是以O(shè)C的方式封裝了SQLite的C語(yǔ)言API柿冲，它相對(duì)于cocoa自帶的C語(yǔ)言框架有如下的優(yōu)點(diǎn):

• 使用起來(lái)更加面向?qū)ο蟛绺撸∪チ撕芏嗦闊⑷哂嗟腃語(yǔ)言代碼
• 對(duì)比蘋果自帶的Core Data框架假抄，更加輕量級(jí)和靈活
• 提供了多線程安全的數(shù)據(jù)庫(kù)操作方法怎栽，有效地防止數(shù)據(jù)混亂

2.核心類

FMDB有三個(gè)主要的類：

• FMDatabase
  一個(gè)FMDatabase對(duì)象就代表一個(gè)單獨(dú)的SQLite數(shù)據(jù)庫(kù)，用來(lái)執(zhí)行SQL語(yǔ)句

• FMResultSet
  使用FMDatabase執(zhí)行查詢后的結(jié)果集

• FMDatabaseQueue
  用于在多線程中執(zhí)行多個(gè)查詢或更新宿饱，它是線程安全的

WCDB

推薦使用WCDB!!
WCDB簡(jiǎn)介
從FMDB遷移到WCDB
iOS 官方使用教程

CoreData

CoreData的簡(jiǎn)單使用

推薦工具 woodpecker

參考文章：
iOS沙盒詳細(xì)介紹
iOS中幾種數(shù)據(jù)持久化方案