当前位置：首页 > news >正文

CTPersistance完全指南：iOS SQLite持久化层的终极解决方案

news 2026/7/10 20:54:08

CTPersistance完全指南：iOS SQLite持久化层的终极解决方案

【免费下载链接】CTPersistanceiOS Database Persistence Layer with SQLite, your next Persistence Layer!项目地址: https://gitcode.com/gh_mirrors/ct/CTPersistance

CTPersistance是iOS平台上基于SQLite的持久化层框架，为开发者提供了简洁高效的数据库操作方案。无论是新手还是有经验的开发者，都能通过本指南快速掌握这个强大工具的使用方法，轻松实现iOS应用中的数据持久化需求。

什么是CTPersistance？

CTPersistance是一个轻量级的SQLite封装库，它简化了iOS应用中的数据库操作流程。通过提供直观的API和强大的功能，CTPersistance让开发者能够专注于业务逻辑，而不必深入SQLite的底层细节。

该框架的核心优势在于：

简化的数据模型定义
强大的CRUD操作支持
异步操作处理能力
数据库迁移功能
加密支持

快速开始：安装与配置

安装CTPersistance

使用CocoaPods安装CTPersistance非常简单，只需在Podfile中添加以下代码：

pod "CTPersistance"

然后运行pod install命令即可完成安装。

基本配置

CTPersistance使用CTMediator来处理数据库迁移、加密密钥和数据库文件位置等配置。你需要创建一个target，并确保它符合CTPersistanceConfigurationTarget协议。

数据库文件名称与target名称的对应规则如下：

数据库文件aaa.sqlite对应targetTarget_aaa
数据库文件aaa_bbb.sqlite对应targetTarget_aaa
数据库文件aaa.abc.sqlite对应targetTarget_aaa

核心概念：Record与Table

Record协议

CTPersistance的核心是CTPersistanceRecordProtocol协议。任何遵循该协议的对象都可以被CTPersistance处理，这意味着你甚至可以将UIView或UIViewController等对象存入数据库。

框架提供了默认实现CTPersistanceRecord类，如果你不想自己实现协议，可以直接使用这个类：

#import "CTPersistanceRecord.h" @interface MyRecord : CTPersistanceRecord <CTPersistanceRecordProtocol> // 定义你的属性 @end

Table类

CTPersistanceTable类是数据库表的抽象，它提供了丰富的数据库操作方法。你需要为每个数据库表创建一个对应的CTPersistanceTable子类，并实现必要的方法。

数据库操作指南

插入数据

使用insertRecord:方法可以轻松插入数据：

TestRecord *record = [[TestRecord alloc] init]; record.name = @"example"; [testTable insertRecord:record error:&error];

批量插入可以使用insertRecordList:方法：

NSArray *records = @[record1, record2, record3]; [testTable insertRecordList:records error:&error];

查询数据

CTPersistance提供了多种查询方法，满足不同场景需求：

查询所有记录：

NSArray *allRecords = [testTable findAllWithError:&error];

根据主键查询：

TestRecord *record = [testTable findWithPrimaryKey:@(1) error:&error];

使用SQL语句查询：

NSArray *records = [testTable findAllWithSQL:@"SELECT * FROM test WHERE name = ?" params:@{@"name":@"example"} error:&error];

更新数据

更新单个记录：

record.name = @"updated name"; [testTable updateRecord:record error:&error];

批量更新：

[testTable updateRecordList:records error:&error];

删除数据

删除单个记录：

[testTable deleteRecord:record error:&error];

批量删除：

[testTable deleteRecordList:records error:&error];

Upsert操作

Upsert（更新或插入）操作可以在记录存在时更新，不存在时插入：

[testTable upsertRecord:record uniqKeyName:@"id" shouldUpdateNilValueToDatabase:YES error:&error];

高级功能

异步操作

CTPersistance提供了CTPersistanceAsyncExecutor来处理异步操作，避免阻塞主线程。重要提示：不要直接使用GCD！

异步读取：

[[CTPersistanceAsyncExecutor sharedInstance] read:^{ TestRecord *record = [self.testTable findWithPrimaryKey:@(1) error:NULL]; // 处理数据 }];

异步写入：

[[CTPersistanceAsyncExecutor sharedInstance] write:^{ NSNumber *primaryKey = [self.testTable insertValue:@"example" forKey:@"name" error:NULL]; // 处理结果 }];

更多异步操作示例可以参考AsyncTestViewController。

数据库加密

CTPersistance支持数据库加密功能，通过实现target的Action_secretKey:方法提供加密密钥：

- (NSArray *)Action_secretKey:(NSDictionary *)params { return @[@"oldkey", @"newkey"]; }

当需要更改加密密钥时，只需将旧密钥和新密钥一起返回即可。详细示例可以参考Target_TestDatabase.m。

数据库迁移

数据库迁移功能允许你平滑地更新数据库结构。实现target的Action_fetchMigrator:方法来提供迁移管理器：

- (CTPersistanceMigrator *)Action_fetchMigrator:(NSDictionary *)params { return [[TestMiagratorVersion_1_to_2 alloc] init]; }

迁移示例可以参考Target_MigrationTestDatabase.m和CTPersistanceTestMigration.m。

事务处理

使用事务可以确保一系列操作的原子性：

[testDatabase transaction:^{ // 执行多个数据库操作 [testTable insertRecord:record1 error:NULL]; [testTable updateRecord:record2 error:NULL]; [testTable deleteRecord:record3 error:NULL]; } error:&error];

详细的事务使用示例可以参考CTPersistanceTestTransaction.m。