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

CTPersistance CRUD操作指南：创建、读取、更新与删除完整教程

news 2026/7/10 21:10:46

CTPersistance CRUD操作指南：创建、读取、更新与删除完整教程

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

CTPersistance是iOS平台上基于SQLite的数据库持久化层框架，为开发者提供了简单高效的CRUD（创建、读取、更新、删除）操作接口。本教程将详细介绍如何使用CTPersistance框架实现数据的增删改查，帮助新手快速掌握iOS数据库操作的核心技能。

🌟 框架核心组件与CRUD模块

CTPersistance的CRUD操作主要通过CTPersistanceTable类的分类方法实现，框架将不同操作封装在独立的头文件中，便于模块化管理和使用：

创建（Insert）：CTPersistanceTable+Insert.h
读取（Find）：CTPersistanceTable+Find.h
更新（Update）：CTPersistanceTable+Update.h
删除（Delete）：CTPersistanceTable+Delete.h

这些分类方法提供了面向对象的数据库操作方式，无需编写原始SQL语句，即可完成常见的数据操作。

📝 创建数据（Insert）：添加记录到数据库

创建操作是将新数据存储到数据库的过程，CTPersistance提供了多种插入数据的方法，满足不同场景需求。

单条记录插入

最基础的插入方法是通过insertRecord:error:插入单个记录对象：

// 创建遵循CTPersistanceRecordProtocol的记录对象 TestRecord *record = [[TestRecord alloc] init]; record.name = @"测试数据"; record.timestamp = [NSDate date]; // 获取对应的表实例 CTPersistanceTable *table = [CTPersistanceTable tableWithName:@"TestTable" database:database]; // 插入记录 NSError *error; BOOL success = [table insertRecord:record error:&error]; if (success) { NSLog(@"记录插入成功"); } else { NSLog(@"插入失败: %@", error.localizedDescription); }

批量记录插入

当需要插入多条记录时，使用insertRecordList:error:方法可以提高效率：

NSMutableArray *recordList = [NSMutableArray array]; for (int i = 0; i < 10; i++) { TestRecord *record = [[TestRecord alloc] init]; record.name = [NSString stringWithFormat:@"测试数据%d", i]; record.timestamp = [NSDate date]; [recordList addObject:record]; } // 批量插入 BOOL success = [table insertRecordList:recordList error:&error];

键值对直接插入

对于简单数据，还可以直接通过键值对方式插入：

NSNumber *rowID = [table insertValue:@"直接插入的数据" forKey:@"name" error:&error]; if (rowID) { NSLog(@"插入成功，新记录ID: %@", rowID); }

🔍 读取数据（Find）：从数据库查询信息

读取操作是从数据库中检索数据的过程，CTPersistance提供了灵活的查询接口，可以满足各种查询需求。

基本查询方法

框架提供了多种查询方法，如按主键查询、条件查询、分页查询等。例如，查询所有记录：

// 查询表中所有记录 NSArray *allRecords = [table findAllRecords:&error]; for (TestRecord *record in allRecords) { NSLog(@"ID: %@, 名称: %@", record.ID, record.name); }

条件查询

通过where子句实现条件过滤：

// 查询名称包含"测试"的记录 NSString *where = [NSString stringWithFormat:@"name LIKE '%%%@%%'", @"测试"]; NSArray *filteredRecords = [table findRecordsWhere:where error:&error];

排序与分页

结合排序和分页功能，可以实现更复杂的查询需求：

// 按时间戳降序排列，取前10条记录 NSArray *sortedRecords = [table findRecordsWhere:nil orderBy:@"timestamp DESC" limit:10 offset:0 error:&error];

✏️ 更新数据（Update）：修改数据库记录

更新操作用于修改数据库中已存在的记录，CTPersistance提供了直观的更新接口。

更新单个记录

通过updateRecord:error:方法更新单个记录：

// 获取要更新的记录 TestRecord *record = [table findFirstRecord:&error]; if (record) { // 修改记录属性 record.name = @"更新后的名称"; // 保存更新 BOOL success = [table updateRecord:record error:&error]; if (success) { NSLog(@"记录更新成功"); } }

条件更新多条记录

使用updateRecordsWhere:withValue:forKey:error:方法可以批量更新符合条件的记录：

// 将所有名称为"测试数据"的记录更新为"示例数据" NSString *where = @"name = '测试数据'"; BOOL success = [table updateRecordsWhere:where withValue:@"示例数据" forKey:@"name" error:&error];

🗑️ 删除数据（Delete）：移除数据库记录

删除操作用于从数据库中移除不需要的数据，框架提供了多种删除方式。

删除单个记录

通过deleteRecord:error:方法删除指定记录：

// 删除指定记录 TestRecord *record = [table findFirstRecord:&error]; if (record) { BOOL success = [table deleteRecord:record error:&error]; if (success) { NSLog(@"记录删除成功"); } }

条件删除多条记录

使用deleteRecordsWhere:error:方法可以删除符合条件的所有记录：

// 删除所有过期记录（假设timestamp字段为过期时间） NSString *where = [NSString stringWithFormat:@"timestamp < %@", @([[NSDate date] timeIntervalSince1970])]; BOOL success = [table deleteRecordsWhere:where error:&error];

清空表数据

如果需要删除表中所有数据，可以使用deleteAllRecords:error:方法：

// 清空表数据 BOOL success = [table deleteAllRecords:&error];

🚀 完整CRUD流程示例

下面是一个包含完整CRUD操作的示例，展示了如何结合使用各种方法：

// 1. 创建表实例 CTPersistanceDatabase *database = [CTPersistanceDatabase databaseWithPath:databasePath]; CTPersistanceTable *table = [CTPersistanceTable tableWithName:@"TestTable" database:database]; // 2. 插入记录 TestRecord *newRecord = [[TestRecord alloc] init]; newRecord.name = @"CRUD测试"; newRecord.timestamp = [NSDate date]; [table insertRecord:newRecord error:nil]; // 3. 查询记录 TestRecord *foundRecord = [table findFirstRecord:nil]; // 4. 更新记录 if (foundRecord) { foundRecord.name = @"CRUD测试-已更新"; [table updateRecord:foundRecord error:nil]; } // 5. 删除记录 if (foundRecord) { [table deleteRecord:foundRecord error:nil]; }

📚 进阶功能与最佳实践

事务支持

对于需要保证数据一致性的操作，CTPersistance提供了事务支持：

CTPersistanceTransaction *transaction = [database transaction]; [transaction beginTransaction]; // 执行一系列操作... BOOL success = [transaction commitTransaction]; if (!success) { [transaction rollbackTransaction]; }