前言

​ SDK 需要把事件数据缓冲到本地，待符合一定策略再去同步数据。

一、数据存储策略

​ 在 iOS 应用程序中，从 “数据缓冲在哪里” 这个纬度看，缓冲一般分两种类型。

• 内存缓冲
• 磁盘缓冲

​ 内存缓冲是将数据缓冲在内存中，供应用程序直接读取和使用。优点是读取速度快。缺点是由于内存资源有限，应用程序在系统中申请的内存，会随着应用生命周期结束而被释放，会导致内存中的数据丢失，因此将事件数据缓冲到内存中不是最佳选择。

​ 磁盘缓冲是将数据缓冲到磁盘空间中，其特点正好和磁盘缓冲相反。磁盘缓冲容量打，但是读写速度对于内存缓冲要慢点。不过磁盘缓冲可以持久化存储，不受应用程序生命周期影响。因为，将数据保存在磁盘中，丢失的风险比较低。即使磁盘缓冲数据速度较慢，但综合考虑，磁盘缓冲是缓冲事件数据最优的选择。

1.1 沙盒

​ iOS 系统为了保证系统的安全性，采用了沙盒机制（即每个应用程序都有自己的一个独立存储空间）。其原理就是通过重定向技术，把应用程序生成和修改的文件重定向到自身的文件中。因此，在 iOS 应用程序里，磁盘缓存的数据一般都存储在沙盒中。

​ 我们可以通过下面的方式获取沙盒路径：

// 获取沙盒主目录路径

NSString *homeDir = NSHomeDirectory();

​ 在模拟上，输出沙盒路径示例如下：

/Users/renwei/Library/Developer/CoreSimulator/Devices/B1D7EC3E-BE72-4F8D-A4EF-E3D6316827CF/data/Containers/Data/Application/229B24A6-E13D-4DE6-9B52-363E832F9717

​ 沙盒的根目录下有三个常用的文件夹：

• Document
• Library
• tmp

（1）Document 文件夹

​ 在 Document 文件夹中，保存的一般是应用程序本身产生的数据。

​ 获取 Document 文件夹路径的方法：

NSString *path = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask , YES).lastObject;

/Users/renwei/Library/Developer/CoreSimulator/Devices/B1D7EC3E-BE72-4F8D-A4EF-E3D6316827CF/data/Containers/Data/Application/86212089-1D48-4B92-A919-AB87D3683191/Documents

（2） Library 文件夹

​ 获取 Library 文件夹路径方法：

    NSString *path = NSSearchPathForDirectoriesInDomains(NSLibraryDirectory, NSUserDomainMask , NO).lastObject;

/Users/renwei/Library/Developer/CoreSimulator/Devices/B1D7EC3E-BE72-4F8D-A4EF-E3D6316827CF/data/Containers/Data/Application/4BBA5D3E-0C75-4543-B831-AE3344DCC940/Library

在 Library 文件夹下有两个常用的子文件夹：

• Caches
• Preferences

​ Caches 文件夹主要用来保存应用程序运行时产生的需要持久化的数据，需要应用程序复制删除。

获取 Caches 文件夹路径的方法

    NSString *path = NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask , YES).lastObject;

/Users/renwei/Library/Developer/CoreSimulator/Devices/B1D7EC3E-BE72-4F8D-A4EF-E3D6316827CF/data/Containers/Data/Application/38CEA9CA-4C49-4B94-84F3-16E434ABFE0F/Library/Caches

​ Preferences 文件保存的是应用程序的偏好设置，即 iOS 系统设置应用会从该目录中读取偏好设置信息，因此，该目录一般不用于存储应用程序产生的数据。

（3）tmp 文件夹

​ tmp 文件夹主要用于保存应用程序运行时参数的临时数据，使用后在将相应的文件从该目录中删除，不会对 tmp 文件中的数据进行备份。

​ 获取 tmp 文件路径的方法：

NSString *path = NSTemporaryDirectory();

/Users/renwei/Library/Developer/CoreSimulator/Devices/B1D7EC3E-BE72-4F8D-A4EF-E3D6316827CF/data/Containers/Data/Application/8E8906B8-0CBC-4A83-A220-A09F397304CD/tmp/

通过上面综合对比发现，最适合缓存事件数据的地方，就是 Library 下 Caches 文件夹中。

1.2 数据缓存

​ 在 iOS 应用程序中，一般通过两种方式进行磁盘缓存：

• ​ 文件缓存
• ​ 数据库缓存

​ 这两种方式都是可以实现数据采集 SDK 的缓冲机制。缓冲的策略即当事件发生后，先将事件数据存储在缓存中，待符合一定策略后从缓存中读取事件数据并进行同步，同步成功后，将已同步的事件从缓存中删除。

​ 对于写入的性能，SQLite 数据库优于文件缓存.

​ 对于读取的性能：如果单条数据小于 100KB，则 SQLite 数据库读取的速度更快。如果单条数据大于 100KB，则从文件中读取的速度更快。

​ 因此，数据采集 SDK 一般都是使用 SQLite 数据库来缓存数据，这样可以拥有最佳的读写性能。如果希望采集更完整，更全面的信息，比如采集用户操作时当前截图的信息（一般超过100KB）,文件缓存可能是最优的选择。

二、文件缓存

​ 可以使用 NSKeyedArchiver 类将字典对象进行归档并写入文件，也可以使用 NSJSONSerialization 类把字典对象转成 JSON 格式字符串写入文件。

2.1 实现步骤

第一步：新建处理文件的工具类 SensorsAnalyticsFileStore ，在工具类中新增一个属性 filePath 用于保存存储文件的路径。在 SensorsAnalyticsFileStore 文件的 -init 方法中初始化 filePath 属性，我们默认在 Caches 目录下 SensorsAnalytics.plist 文件来缓存数据。

@interface SensorsAnalyticsFileStore : NSObject

/// 保存存储文件的路径

@property (nonatomic, copy) NSString *filePath;

@end

static NSString * const SensorsAnalyticsDefaultFileName = @"SensorsAnalytics.plist";

@implementation SensorsAnalyticsFileStore

- (instancetype)init {

    self = [super init];

    if (self) {

        // 初始化默认的事件数据存储地址

        _filePath = [NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES).lastObject stringByAppendingPathComponent:SensorsAnalyticsDefaultFileName];

    }

    return self;

}

@end

第二步：我们使用 NSJSONSerialization 类将字典对象转换成 JSON 格式并写入文件。新增 - saveEvent: 方法用于事件数据写入文件，同时，新增 NSMutableArray<NSDictionary *> *events；并在 - init 方法中进行初始化

- (instancetype)init {

    self = [super init];

    if (self) {

        // 初始化默认的事件数据存储地址

        _filePath = [NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES).lastObject stringByAppendingPathComponent:SensorsAnalyticsDefaultFileName];

        // 初始化事件数据，从文件路径中读取数据

       [self readAllEventsFromFilePath:_filePath];

    }

    return self;

}

- (void)saveEvent:(NSDictionary *)event {

    // 在数组中直接添加事件数据

    [self.events addObject:event];

    // 将事件数据保存在文件中

    [self writeEventsToFile];

}

- (void)writeEventsToFile {

    NSError *error = nil;

    // 将字典数据解析成 JSON 数据

    NSData *data = [NSJSONSerialization dataWithJSONObject:self.events options:NSJSONWritingPrettyPrinted error:&error];

    if (error) {

        return NSLog(@"The JSON object`s serialization error: %@", error);

    }

    // 将数据写入到文件

    [data writeToFile:self.filePath atomically:YES];

}

第三步：在 SensorsAnalyticsSDK.m 文件中新增一个 SensorsAnalyticsFileStore 类型属性 fileStroe，并在 - init 方法中进行初始化

#import "SensorsAnalyticsFileStore.h"

/// 文件缓存事件数据对象

@property (nonatomic, strong) SensorsAnalyticsFileStore *fileStroe;

- (instancetype)init {

    self = [super init];

    if (self) {

        _automaticProperties = [self collectAutomaticProperties];

        // 设置是否需是被动启动标记

        _launchedPassively = UIApplication.sharedApplication.backgroundTimeRemaining != UIApplicationBackgroundFetchIntervalNever;

        _loginId = [[NSUserDefaults standardUserDefaults] objectForKey:SensorsAnalyticsLoginId];

        _trackTimer = [NSMutableDictionary dictionary];

        _enterBackgroundTrackTimerEvents = [NSMutableArray array];

        _fileStroe = [[SensorsAnalyticsFileStore alloc] init];

        // 添加应用程序状态监听

        [self setupListeners];

    }

    return self;

}

第四步：修改 SensorsAnalyticsSDK 的类别 Track 中的 - track: properties: 方法。

- (void)track:(NSString *)eventName properties:(nullable NSDictionary<NSString *, id> *)properties {

    NSMutableDictionary *event = [NSMutableDictionary dictionary];

    // 设置事件 distinct_id 字段，用于唯一标识一个用户

    event[@"distinct_id"] = self.loginId ?: self.anonymousId;

    // 设置事件名称

    event[@"event"] = eventName;

    // 事件发生的时间戳，单位毫秒

    event[@"time"] = [NSNumber numberWithLong:NSDate.date.timeIntervalSince1970 *1000];

    NSMutableDictionary *eventProperties = [NSMutableDictionary dictionary];

    // 添加预置属性

    [eventProperties addEntriesFromDictionary:self.automaticProperties];

    // 添加自定义属性

    [eventProperties addEntriesFromDictionary:properties];

    // 判断是否是被动启动状态

    if (self.isLaunchedPassively) {

        eventProperties[@"$app_state"] = @"background";

    }

    // 设置事件属性

    event[@"propeerties"] = eventProperties;

    // 打印

    [self printEvent:event];

    [self.fileStroe saveEvent:event];

}

第五步：测试验证

第六步：在文件中读取和删除事件数据

@interface SensorsAnalyticsFileStore : NSObject

/// 保存存储文件的路径

@property (nonatomic, copy) NSString *filePath;

/// 获取本地缓存的所有事件数据

@property (nonatomic, copy, readonly) NSArray<NSDictionary *> *allEvents;

/// 将事件保存到文件中

/// @param event 事件数据

- (void)saveEvent:(NSDictionary *)event;

/// 根据数量删除本地保存的事件数据

/// @param count 需要删除的事件数量

- (void)deleteEventsForCount:(NSInteger)count;

@end

- (void)readAllEventsFromFilePath:(NSString *)filePath {

    NSData *data = [NSData dataWithContentsOfFile:filePath];

    if (data) {

        // 解析在文件中读取 JSON 数据

        NSMutableArray *allEvents = [NSJSONSerialization JSONObjectWithData:data options:NSJSONReadingMutableContainers error:nil];

        // 将文件中的数据读取到内存中

        self.events = allEvents ?: [NSMutableArray array];

    } else {

        self.events = [NSMutableArray array];

    }

}

- (NSArray<NSDictionary *> *)allEvents {

    return [self.events copy];

}

- (void)deleteEventsForCount:(NSInteger)count {

    // 删除前 count 条事件数据

    [self.events removeObjectsInRange:NSMakeRange(0, count)];

    // 将删除后剩余的事件数据保存到文件中

    [self writeEventsToFile];

}

2.2 优化

​ 通过上面实现文件缓存存在两个非常明细的问题。

（1）如果在主线程中触发事件，那么读取事件、保存事件及删除事件都在主线程中运行，会出现所谓的 “卡主线程”问题。

（2）在无网环境下，如果在文件中缓存了大量的事件数据，会导致内存占用过大，影响应用程序性能。

2.2.1 多线程优化

​ 解决 “卡主线程” 问题的方法主要是把处理文件的逻辑都放到多线程中运行。

第一步：在 SensorsAnalyticsFileStore.m 文件中新增一个 dispatch_queue_t 类型的属性 queue， 并在 -init 方法中进行初始化

@interface SensorsAnalyticsFileStore()

/// 事件数据

@property (nonatomic, strong) NSMutableArray<NSDictionary *> *events;

/// 串行队列

@property (nonatomic, strong) dispatch_queue_t queue;

@end

@implementation SensorsAnalyticsFileStore

- (instancetype)init {

    self = [super init];

    if (self) {

        // 初始化默认的事件数据存储地址

        _filePath = [NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES).lastObject stringByAppendingPathComponent:SensorsAnalyticsDefaultFileName];

        // 初始化队列的唯一标识

        NSString *label = [NSString stringWithFormat:@"cn.sensorsdata.serialQueue.%p", self];

        // 创建一个 serial 类型的 queue，即 FIFO

        _queue = dispatch_queue_create([label UTF8String], DISPATCH_QUEUE_SERIAL);

        _maxLocalEventCount = 1000;

        // 初始化事件数据，从文件路径中读取数据

       [self readAllEventsFromFilePath:_filePath];

    }

    return self;

}

@end

第二步：使用 dispatch_async 函数优化 - saveEvent: 、- readAllEventsFromFilePath: 及 - deleteEventsForCount: 方法，使用 dispatch_sync 函数优化 - allEvents 方法

//

//  SensorsAnalyticsFileStore.m

//  SensorsSDK

//

//  Created by 任伟 on 2022/4/12.

//

#import "SensorsAnalyticsFileStore.h"

static NSString * const SensorsAnalyticsDefaultFileName = @"SensorsAnalytics.plist";

@interface SensorsAnalyticsFileStore()

/// 事件数据

@property (nonatomic, strong) NSMutableArray<NSDictionary *> *events;

/// 串行队列

@property (nonatomic, strong) dispatch_queue_t queue;

@end

@implementation SensorsAnalyticsFileStore

- (instancetype)init {

    self = [super init];

    if (self) {

        // 初始化默认的事件数据存储地址

        _filePath = [NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES).lastObject stringByAppendingPathComponent:SensorsAnalyticsDefaultFileName];

        // 初始化队列的唯一标识

        NSString *label = [NSString stringWithFormat:@"cn.sensorsdata.serialQueue.%p", self];

        // 创建一个 serial 类型的 queue，即 FIFO

        _queue = dispatch_queue_create([label UTF8String], DISPATCH_QUEUE_SERIAL);

        _maxLocalEventCount = 1000;

        // 初始化事件数据，从文件路径中读取数据

       [self readAllEventsFromFilePath:_filePath];

    }

    return self;

}

- (void)saveEvent:(NSDictionary *)event {

    dispatch_async(self.queue, ^{

        if (self.events.count >= _maxLocalEventCount) {

            [self.events removeObjectAtIndex:0];

        }

        // 在数组中直接添加事件数据

        [self.events addObject:event];

        // 将事件数据保存在文件中

        [self writeEventsToFile];

    });

}

- (void)writeEventsToFile {

    NSError *error = nil;

    // 将字典数据解析成 JSON 数据

    NSData *data = [NSJSONSerialization dataWithJSONObject:self.events options:NSJSONWritingPrettyPrinted error:&error];

    if (error) {

        return NSLog(@"The JSON object`s serialization error: %@", error);

    }

    // 将数据写入到文件

    [data writeToFile:self.filePath atomically:YES];

}

- (void)readAllEventsFromFilePath:(NSString *)filePath {

    dispatch_async(self.queue, ^{

        NSData *data = [NSData dataWithContentsOfFile:filePath];

        if (data) {

            // 解析在文件中读取 JSON 数据

            NSMutableArray *allEvents = [NSJSONSerialization JSONObjectWithData:data options:NSJSONReadingMutableContainers error:nil];

            // 将文件中的数据读取到内存中

            self.events = allEvents ?: [NSMutableArray array];

        } else {

            self.events = [NSMutableArray array];

        }

    });

}

- (NSArray<NSDictionary *> *)allEvents {

    __block NSArray<NSDictionary *> *allEvents = nil;

    dispatch_sync(self.queue, ^{

        allEvents = [self.events copy];

    })

    return allEvents;

}

- (void)deleteEventsForCount:(NSInteger)count {

    dispatch_async(self.queue, ^{

        // 删除前 count 条事件数据

        [self.events removeObjectsInRange:NSMakeRange(0, count)];

        // 将删除后剩余的事件数据保存到文件中

        [self writeEventsToFile];

    });

}

@end

2.2.2 内存优化

​ 设置一个本地可缓存的最大事件条数，当本地已经缓存到事件条数超过本地可缓存最大事件条数时，删除最旧的事件数据。以保证最新的事件数据可以被缓存。

第一步：在 SensorsAnalyticsFileStore.h 文件中新增 maxLocalEventCount 属性, 并在 - init 方法中进行初始化，默认设置 1000 条数。

/// 本地可最大缓存事件条数

@property (nonatomic) NSUInteger maxLocalEventCount;

- (instancetype)init {

    self = [super init];

    if (self) {

        // 初始化默认的事件数据存储地址

        _filePath = [NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES).lastObject stringByAppendingPathComponent:SensorsAnalyticsDefaultFileName];

        // 初始化队列的唯一标识

        NSString *label = [NSString stringWithFormat:@"cn.sensorsdata.serialQueue.%p", self];

        // 创建一个 serial 类型的 queue，即 FIFO

        _queue = dispatch_queue_create([label UTF8String], DISPATCH_QUEUE_SERIAL);

        _maxLocalEventCount = 1000;

        // 初始化事件数据，从文件路径中读取数据

       [self readAllEventsFromFilePath:_filePath];

    }

    return self;

}

第二步：在 - saveEvent: 方法插入数据之前，先判断已缓存的事件条数是否超过了本地可缓存的事件条数，如果已经超过，则删除最旧的事件

- (void)saveEvent:(NSDictionary *)event {

    dispatch_async(self.queue, ^{

        if (self.events.count >= _maxLocalEventCount) {

            [self.events removeObjectAtIndex:0];

        }

        // 在数组中直接添加事件数据

        [self.events addObject:event];

        // 将事件数据保存在文件中

        [self writeEventsToFile];

    });

}

2.3 总结

​ 我们可以使用文件缓存实现事件数据的持久化操作。

首先，主要实现了一下三个功能：

• 保存事件
• 获取本地缓存的所有事件
• 删除事件

然后有进行了两项优化

• 多线程优化
• 内存优化

​ 文件缓存相对来说还是比较简单，主要操作就是写文件和读取文件。每次写入的 数据量越大，文件缓存的性能越好。

​ 当然，文件缓存是不够灵活的，我们很难使用更细的颗粒去操作数据。比如很难对某一条数据进行读写操作。

三、数据库缓存

​ 在 iOS 应用程序中，使用的数据库一般是 SQLite 数据库，SQLite 是轻量级数据库，数据存储简单高效，使用也非常简单，只是需要在项目中添加 libssqlite3.0 依赖，并在使用的时候引入 sqlite3.h 头文件即可。

3.1 实现步骤

第一步：创建 SensorsAnalyticsDatabase 工具类

//

//  SensorsAnalyticsDatabase.h

//  SensorsSDK

//

//  Created by 任伟 on 2022/4/13.

//

#import <Foundation/Foundation.h>

NS_ASSUME_NONNULL_BEGIN

@interface SensorsAnalyticsDatabase : NSObject

/// 数据库文件的路径

@property (nonatomic, copy, readonly) NSString *filePath;

//+ (instancetype)new NS_UNAVAILABLE;

//- (instancetype)init NS_UNAVAILABLE;

/// 初始化方法

/// @param filePath 数据库路径，如果是nil, 使用默认路径

- (instancetype)initWithFilePath:(nullable NSString *)filePath NS_DESIGNATED_INITIALIZER;

/// 同步向数据库插入事件数据

/// @param event 事件

- (void)insertEvent: (NSDictionary *) event;

/// 从数据库中获取事件数据

/// @param count 获取事件数据条数

- (NSArray<NSString *> *)selectEventsForCount:(NSInteger)count;

/// 从数据库中删除一定数量的事件数据

/// @param count 需要删除的事件条数

- (BOOL)deleteEventsForCount:(NSInteger)count;

@end

NS_ASSUME_NONNULL_END

//

//  SensorsAnalyticsDatabase.m

//  SensorsSDK

//

//  Created by 任伟 on 2022/4/13.

//

#import "SensorsAnalyticsDatabase.h"

#import <sqlite3.h>

static NSString * const SensorsAnalyticsDefaultDatabaseName = @"SensorsAnalyticsDatabase.sqlite";

@interface SensorsAnalyticsDatabase()

/// 数据库文件的路径

@property (nonatomic, copy) NSString *filePath;

/// 数据库私有属性

@property (nonatomic) sqlite3 *database;

/// 串行队列

@property (nonatomic, strong) dispatch_queue_t queue;

@end

@implementation SensorsAnalyticsDatabase {

    sqlite3 *_database;

}

- (instancetype)init {

    return [self initWithFilePath:nil];

}

- (instancetype)initWithFilePath:(NSString *)filePath {

    self = [super init];

    if (self) {

        _filePath = filePath ?: [NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES).lastObject stringByAppendingPathComponent:SensorsAnalyticsDefaultDatabaseName];

        // 初始化队列的唯一标识

        NSString *label = [NSString stringWithFormat:@"cn.sensorsdata.serialQueue.%p", self];

        // 创建一个 serial 类型的 queue，即 FIFO

        _queue = dispatch_queue_create([label UTF8String], DISPATCH_QUEUE_SERIAL);

        // 打开数据库

        [self open];

    }

    return self;

}

- (void)open {

    dispatch_async(self.queue, ^{

        // 初始化 SQLite 库

        if (sqlite3_initialize() != SQLITE_OK) {

            return;

        }

        // 打开数据库，获取数据库指针

        if (sqlite3_open_v2([self.filePath UTF8String], &(self->_database), SQLITE_OPEN_READWRITE | SQLITE_OPEN_CREATE, NULL) != SQLITE_OK) {

            return NSLog(@"SQLite stmt  prepare error: %s", sqlite3_errmsg(self.database));

        }

        char *error;

        // 创建数据库表的 SQL 语句

//        NSString *sql = @"CREATE TABLE IF NOT EXISTS events（id integer PRIMARY KEY AUTOINCREMENT, name text NOT NULL UNIQUE）;";

      NSString *sql = @"CREATE TABLE IF NOT EXISTS events (id integer PRIMARY KEY AUTOINCREMENT, event BLOB);";

        // 运行创建表格的 SQL 语句

        if (sqlite3_exec(self.database, [sql UTF8String], NULL, NULL, &error) != SQLITE_OK) {

            return NSLog(@"Create events failure %s", error);

        }

    });

}

- (void)insertEvent:(NSDictionary *)event {

    dispatch_async(self.queue, ^{

        // 自定义 SQLite Statement

        sqlite3_stmt *stmt;

        // 插入语句

        NSString *sql = @"INSERT INTO events (event) values (?)";

        // 准备执行 SQL 语句，获取 sqlite3_stmt

        if (sqlite3_prepare_v2(self.database, sql.UTF8String, -1, &stmt, NULL) != SQLITE_OK) {

            // 准备执行 SQL 语句失败，打印 log 返回失败 NO

            return NSLog(@"SQLite stmt prepare error: %s", sqlite3_errmsg(self.database));

        }

        NSError *error;

        // 将 event 转换成 JSON 数据

        NSData *data = [NSJSONSerialization dataWithJSONObject:event options:NSJSONWritingPrettyPrinted error:&error];

        if (error) {

            return NSLog(@"The JSON object`s serialization error: %@", error);

        }

        // 将JSON数据与 stmt 绑定

        sqlite3_bind_blob(stmt, 1, data.bytes, (int)data.length, SQLITE_TRANSIENT);

        // 执行 stmt

        if (sqlite3_step(stmt) != SQLITE_DONE) {

            // 执行失败，打印log，返回失败（NO）

            return NSLog(@"Insert event into events error");

        }

    });

}

- (NSArray<NSString *> *)selectEventsForCount:(NSInteger)count {

    // 初始化数组，用于存储查询到的事件数据

    NSMutableArray<NSString *> *events = [NSMutableArray arrayWithCapacity:count];

    dispatch_sync(self.queue, ^{

        // 自定义 SQLite Statement

        sqlite3_stmt *stmt;

        // 查询语句

        NSString *sql = [NSString stringWithFormat:@"SELECT id, event FROM events ORDER BY id ASC LIMIT %lu", (unsigned long)count];

        // 准备执行 SQL 语句，获取sqlite3——stmt

        if (sqlite3_prepare_v2(self.database, sql.UTF8String, -1, &stmt, NULL) != SQLITE_OK) {

            // 准备执行 SQL 语句失败，打印log返回失败(no)

            return NSLog(@"SQLite stmt prepare error： %s,", sqlite3_errmsg(self.database));

        }

        // 执行 SQL 语句

        while (sqlite3_step(stmt) == SQLITE_ROW) {

            // 将当前查询的这条数据转换成 NSData 对象

            NSData *data = [[NSData alloc] initWithBytes:sqlite3_column_blob(stmt, 1) length:sqlite3_column_bytes(stmt, 1)];

            // 将查询到的时间数据转换成JSON字符串

            NSString *jsonString = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];

#ifdef DUBUG

            NSLog(@"%@", jsonString);

#endif

            // 将JSON字符串添加到数组中

            [events addObject:jsonString];

        }

    });

    return events;

}

- (BOOL)deleteEventsForCount:(NSInteger)count {

    __block BOOL success = YES;

    dispatch_sync(self.queue, ^{

        // 删除语句

        NSString *sql = [NSString stringWithFormat:@"DELETE FROM events WHERE id IN (SELECT id FROM events ORDER BY id ASC LIMIT %lu);", (unsigned long)count];

        char *errmsg;

        //执行删除语句

        if (sqlite3_exec(self.database, sql.UTF8String, NULL, NULL, &errmsg) != SQLITE_OK) {

            success = NO;

            return NSLog(@"Failed to delete record msg=%s", errmsg);

        }

    });

    return success;

}

@end

第二步：在 SensorsAnalyticsSDK.m 文件中新增 SensorsAnalyticsDatabase 类型私有属性 database，并在 -init 方法中进行初始化

- (instancetype)init {

    self = [super init];

    if (self) {

        _automaticProperties = [self collectAutomaticProperties];

        // 设置是否需是被动启动标记

        _launchedPassively = UIApplication.sharedApplication.backgroundTimeRemaining != UIApplicationBackgroundFetchIntervalNever;

        _loginId = [[NSUserDefaults standardUserDefaults] objectForKey:SensorsAnalyticsLoginId];

        _trackTimer = [NSMutableDictionary dictionary];

        _enterBackgroundTrackTimerEvents = [NSMutableArray array];

        _fileStroe = [[SensorsAnalyticsFileStore alloc] init];

        _database = [[SensorsAnalyticsDatabase alloc] init];

        // 添加应用程序状态监听

        [self setupListeners];

    }

    return self;

}

第三步：修改 -track: properties: 的数据存储方式

- (void)track:(NSString *)eventName properties:(nullable NSDictionary<NSString *, id> *)properties {

    NSMutableDictionary *event = [NSMutableDictionary dictionary];

    // 设置事件 distinct_id 字段，用于唯一标识一个用户

    event[@"distinct_id"] = self.loginId ?: self.anonymousId;

    // 设置事件名称

    event[@"event"] = eventName;

    // 事件发生的时间戳，单位毫秒

    event[@"time"] = [NSNumber numberWithLong:NSDate.date.timeIntervalSince1970 *1000];

    NSMutableDictionary *eventProperties = [NSMutableDictionary dictionary];

    // 添加预置属性

    [eventProperties addEntriesFromDictionary:self.automaticProperties];

    // 添加自定义属性

    [eventProperties addEntriesFromDictionary:properties];

    // 判断是否是被动启动状态

    if (self.isLaunchedPassively) {

        eventProperties[@"$app_state"] = @"background";

    }

    // 设置事件属性

    event[@"propeerties"] = eventProperties;

    // 打印

    [self printEvent:event];

//    [self.fileStroe saveEvent:event];

    [self.database insertEvent:event];

}

第四步：测试验证（和文件存储验证方式一样）

3.2 优化

​ 需要优化的内容：

在每次插入和查询数据的时候，都会执行 “准备执行SQL的语句”的操作，比较浪费资源

在查询和删除操作时，如果数据表中没有存储任何的数据，其实无须执行 SQL 语句

（1）缓存 sqlite3_stmt

static sqlite3_stmt *insertStmt = NULL;

- (void)insertEvent:(NSDictionary *)event {

    dispatch_async(self.queue, ^{

        if (insertStmt) {

            // 重置插入语句，重置之后可重新绑定数据

            sqlite3_reset(insertStmt);

        } else {

            // 插入语句

            NSString *sql = @"INSERT INTO events (event) values (?)";

            // 准备执行 SQL 语句，获取 sqlite3_stmt

            if (sqlite3_prepare_v2(self.database, sql.UTF8String, -1, &insertStmt, NULL) != SQLITE_OK) {

                // 准备执行 SQL 语句失败，打印 log 返回失败 NO

                return NSLog(@"SQLite stmt prepare error: %s", sqlite3_errmsg(self.database));

            }

        }

        NSError *error;

        // 将 event 转换成 JSON 数据

        NSData *data = [NSJSONSerialization dataWithJSONObject:event options:NSJSONWritingPrettyPrinted error:&error];

        if (error) {

            return NSLog(@"The JSON object`s serialization error: %@", error);

        }

        // 将JSON数据与 insertStmt 绑定

        sqlite3_bind_blob(insertStmt, 1, data.bytes, (int)data.length, SQLITE_TRANSIENT);

        // 执行 stmt

        if (sqlite3_step(insertStmt) != SQLITE_DONE) {

            // 执行失败，打印log，返回失败（NO）

            return NSLog(@"Insert event into events error");

        }

    });

}

// 最后一次查询下的事件数量

static NSUInteger lastSelectEventCount = 50;

static sqlite3_stmt *selectStmt = NULL;

- (NSArray<NSString *> *)selectEventsForCount:(NSInteger)count {

    // 初始化数组，用于存储查询到的事件数据

    NSMutableArray<NSString *> *events = [NSMutableArray arrayWithCapacity:count];

    dispatch_sync(self.queue, ^{

        if (count != lastSelectEventCount) {

            lastSelectEventCount = count;

            selectStmt = NULL;

        }

        if (selectStmt) {

            // 重置插入语句，重置之后可重新查询数据

            sqlite3_reset(selectStmt);

        } else {

            // 查询语句

            NSString *sql = [NSString stringWithFormat:@"SELECT id, event FROM events ORDER BY id ASC LIMIT %lu", (unsigned long)count];

            // 准备执行 SQL 语句，获取sqlite3——stmt

            if (sqlite3_prepare_v2(self.database, sql.UTF8String, -1, &selectStmt, NULL) != SQLITE_OK) {

                // 准备执行 SQL 语句失败，打印log返回失败(no)

                return NSLog(@"SQLite stmt prepare error： %s,", sqlite3_errmsg(self.database));

            }

        }

        // 执行 SQL 语句

        while (sqlite3_step(selectStmt) == SQLITE_ROW) {

            // 将当前查询的这条数据转换成 NSData 对象

            NSData *data = [[NSData alloc] initWithBytes:sqlite3_column_blob(selectStmt, 1) length:sqlite3_column_bytes(stmt, 1)];

            // 将查询到的时间数据转换成JSON字符串

            NSString *jsonString = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];

#ifdef DUBUG

            NSLog(@"%@", jsonString);

#endif

            // 将JSON字符串添加到数组中

            [events addObject:jsonString];

        }

    });

    return events;

}

（2）缓存事件总条数

​ 添加一个方法用于查询数据库已经存储事件条数，新增一个 eventCount 属性，初始化时，他的数值就是当前数据库已经存储事件条数，每次成功插入一条数据的时候值对应的加1，在删除数据的时候减去相应删除的数据条数，这样就保证 eventCount 和本地数据存储的事件条数一致，减少查询次数。

第一步：在 SensorsAnalyticsDatabase.h 中新增 eventCount 属性

/// 本地事件存储总量

@property (nonatomic) NSUInteger eventCount;

第二步：在 SensorsAnalyticsDatabase.m 文件中新增私有方法 - queryLocalDatabaseEventCount，查询数据库中已经缓存事件数。

// 查询数据库中已经缓存事件的条数

- (void)queryLocalDatabaseEventCount {

    dispatch_async(self.queue, ^{

       // 查询语句

        NSString *sql = @"SELECT count(*) FORM events";

        sqlite3_stmt *stmt = NULL;

        // 准备执行SQL语句，获取 sqlite3_stmt

        if (sqlite3_prepare_v2(self.database, sql.UTF8String, -1, &stmt, NULL) != SQLITE_OK) {

            // 准备执行SQL语句失败，打印log返回失败 NO

            return NSLog(@"SQLite stmt prepare error: %s", sqlite3_errmsg(self.database));

        }

        while (sqlite3_step(stmt) == SQLITE_ROW) {

            self.eventCount = sqlite3_column_int(stmt, 0);

        }

    });

}

第三步 ：在 - initWithFilePath: 初始化方法中调用 - queryLocalDatabaseEventCount，初始化 eventCount

- (instancetype)initWithFilePath:(NSString *)filePath {

    self = [super init];

    if (self) {

        _filePath = filePath ?: [NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES).lastObject stringByAppendingPathComponent:SensorsAnalyticsDefaultDatabaseName];

        // 初始化队列的唯一标识

        NSString *label = [NSString stringWithFormat:@"cn.sensorsdata.serialQueue.%p", self];

        // 创建一个 serial 类型的 queue，即 FIFO

        _queue = dispatch_queue_create([label UTF8String], DISPATCH_QUEUE_SERIAL);

        // 打开数据库

        [self open];

        [self queryLocalDatabaseEventCount];

    }

    return self;

}

第四步：优化 - insertEvent: 方法，事件插入成功，事件数量 eventCount 加 1

static sqlite3_stmt *insertStmt = NULL;

- (void)insertEvent:(NSDictionary *)event {

    dispatch_async(self.queue, ^{

        if (insertStmt) {

            // 重置插入语句，重置之后可重新绑定数据

            sqlite3_reset(insertStmt);

        } else {

            // 插入语句

            NSString *sql = @"INSERT INTO events (event) values (?)";

            // 准备执行 SQL 语句，获取 sqlite3_stmt

            if (sqlite3_prepare_v2(self.database, sql.UTF8String, -1, &insertStmt, NULL) != SQLITE_OK) {

                // 准备执行 SQL 语句失败，打印 log 返回失败 NO

                return NSLog(@"SQLite stmt prepare error: %s", sqlite3_errmsg(self.database));

            }

        }

        NSError *error;

        // 将 event 转换成 JSON 数据

        NSData *data = [NSJSONSerialization dataWithJSONObject:event options:NSJSONWritingPrettyPrinted error:&error];

        if (error) {

            return NSLog(@"The JSON object`s serialization error: %@", error);

        }

        // 将JSON数据与 insertStmt 绑定

        sqlite3_bind_blob(insertStmt, 1, data.bytes, (int)data.length, SQLITE_TRANSIENT);

        // 执行 stmt

        if (sqlite3_step(insertStmt) != SQLITE_DONE) {

            // 执行失败，打印log，返回失败（NO）

            return NSLog(@"Insert event into events error");

        }

        // 数据插入成功 事件数量加1

        self.eventCount ++;

    });

}

第五步：优化 - deleteEventsForCount: 方法，当 eventCount 为 0 时，直接返回；当数据删除成功时，事件数量减去相应的删除条数

- (BOOL)deleteEventsForCount:(NSInteger)count {

    __block BOOL success = YES;

    dispatch_sync(self.queue, ^{

        // 当本地事件数量为 0 时，直接返回

        if (self.eventCount == 0) {

            return;

        }

        // 删除语句

        NSString *sql = [NSString stringWithFormat:@"DELETE FROM events WHERE id IN (SELECT id FROM events ORDER BY id ASC LIMIT %lu);", (unsigned long)count];

        char *errmsg;

        //执行删除语句

        if (sqlite3_exec(self.database, sql.UTF8String, NULL, NULL, &errmsg) != SQLITE_OK) {

            success = NO;

            return NSLog(@"Failed to delete record msg=%s", errmsg);

        }

        self.eventCount = self.eventCount < count ? 0 : self.eventCount - count;

    });

    return success;

}

第六步：优化 - selectEventsForCount: 方法，当 eventCount 为 0 时，直接返回

// 最后一次查询下的事件数量

static NSUInteger lastSelectEventCount = 50;

static sqlite3_stmt *selectStmt = NULL;

- (NSArray<NSString *> *)selectEventsForCount:(NSInteger)count {

    // 初始化数组，用于存储查询到的事件数据

    NSMutableArray<NSString *> *events = [NSMutableArray arrayWithCapacity:count];

    dispatch_sync(self.queue, ^{

        // 当本地事件数量为 0 ，直接返回

        if (self.eventCount == 0) {

            return;

        }

        if (count != lastSelectEventCount) {

            lastSelectEventCount = count;

            selectStmt = NULL;

        }

        if (selectStmt) {

            // 重置插入语句，重置之后可重新查询数据

            sqlite3_reset(selectStmt);

        } else {

            // 查询语句

            NSString *sql = [NSString stringWithFormat:@"SELECT id, event FROM events ORDER BY id ASC LIMIT %lu", (unsigned long)count];

            // 准备执行 SQL 语句，获取sqlite3——stmt

            if (sqlite3_prepare_v2(self.database, sql.UTF8String, -1, &selectStmt, NULL) != SQLITE_OK) {

                // 准备执行 SQL 语句失败，打印log返回失败(no)

                return NSLog(@"SQLite stmt prepare error： %s,", sqlite3_errmsg(self.database));

            }

        }

        // 执行 SQL 语句

        while (sqlite3_step(selectStmt) == SQLITE_ROW) {

            // 将当前查询的这条数据转换成 NSData 对象

            NSData *data = [[NSData alloc] initWithBytes:sqlite3_column_blob(selectStmt, 1) length:sqlite3_column_bytes(stmt, 1)];

            // 将查询到的时间数据转换成JSON字符串

            NSString *jsonString = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];

#ifdef DUBUG

            NSLog(@"%@", jsonString);

#endif

            // 将JSON字符串添加到数组中

            [events addObject:jsonString];

        }

    });

    return events;

}

3.3 总结

​ 通过上面我们实现了数据库缓存事件数据，并实现了如下功能

• 插入数据
• 查询数据
• 删除数据

​ 然后对数据缓存性能进行了优化。对于文件缓存来说，数据库缓存更加灵活，可以实现对单条数据的查询、插入和删除操作，同时调试也更容易。SQLite 数据库也有极高的性能，特别是对单条数据的操作，性能明显由于文件缓存。

最新文章

1. Appium环境搭建+cordova
2. BZOJ 3275: Number
3. 第3月第15天 afconvert lame
4. Android广播
5. [ActionScript 3.0] 图片左右循环移动
6. hihocoder-1389&amp;&amp;2016北京网赛07 Sewage Treatment(二分+网络流)
7. 浮点数转换为人名币读法字符串（JAVA）
8. 第二个Sprint冲刺第三天
9. Form_Form Builder本地部署运行的实现（案例）
10. virtual private catalog
11. C# Best Practices - Handling Strings
12. Pythonic论坛怪怪的’居民’显示[已解决]
13. Spring-Mybatis配置多数据源
14. 用R语言对一个信用卡数据实现logit,GBM,knn,xgboost
15. http 状态
16. web框架之Flask
17. Prometheus监控数据格式学习
18. 关于*[pylint]E1101:Module &#39;xxx&#39; has no &#39;xxx&#39; member* 简单而有效的解决办法
19. golang使用graphviz
20. 天天沉迷于皇上本宫的都是sb

热门文章

1. 实现自定义的小程序底部tabbar
2. onActivityResult执行两次问题
3. java中对象属性可以是另外一个对象或对象的参考
4. Java中读取 .properties 和 .xml 文件
5. 将本地代码上传到gitLab
6. NLP---word2vec的python实现
7. 动态代理-JDK
8. centos7 安装樱桃树cherrytree
9. Model, HttpServletRequest, ModelMap区别
10. Codeforces Round #704 (Div. 2), problem: (C) Maximum width还是要多学习