LKDBHelper-SQLite-ORM 教程

LKDBHelper-SQLite-ORM 教程

LKDBHelper-SQLite-ORM全自动的插入,查询,更新,删除， an automatic database operation thread-safe and not afraid of recursive deadlock项目地址:https://gitcode.com/gh_mirrors/lk/LKDBHelper-SQLite-ORM

1. 项目介绍

LKDBHelper 是一个基于 SQLite 的 ORM（对象关系映射）框架，专为 iOS 开发设计。该框架使得在 iOS 应用中操作数据库变得简单且线程安全，避免了递归锁死的问题。它支持自动化的插入、查询、更新和删除操作，适用于 ARC 模式下的 iOS 4.3 及以上版本。

2. 项目快速启动

依赖安装

如果你使用 CocoaPods，可以在 Podfile 中添加以下代码来安装 LKDBHelper 和加密库（如需使用 SQLCipher 加密）：

pod 'LKDBHelper'
# 如需加密
pod 'FMDB/SQLCipher'

然后运行 pod install。

数据模型创建

创建一个 Objective-C 类作为数据模型，例如 LKTest:

#import "LKDBModel.h"

@interface LKTest : NSObject <LKDBModel>
@property (copy, nonatomic) NSString *name;
@property (nonatomic, assign) NSUInteger age;
@property (nonatomic, assign) BOOL isGirl;
@property (strong, nonatomic) LKTestForeign *address;
//...其他属性
@end

表名及回调方法

在对应的 .m 文件中：

1. 重写 getTableName 方法（可选），指定数据库表名：

+(NSString *)getTableName {
    return @"LKTestTable";
}

2. 实现回调方法（可选），用于监听数据库操作事件：

@interface NSObject (LKDBHelper_Delegate)
//...其他回调
@end

插入数据

初始化模型并插入数据库：

LKTestForeign *foreign = [[LKTestForeign alloc] init];
foreign.address = @":asdasdasdsadasdsdas";
foreign.postcode = 123341;
foreign.addid = 213214;

// 插入数据
[LKDBHelper defaultHelper].isAutoSave = YES;  // 自动保存
[LKDBHelper defaultHelper].encryptionKey = @"your_encryption_key";  // 若使用加密
[lk_testObject saveToDatabase];  // 将LKTest对象插入数据库

3. 应用案例和最佳实践

• 最佳实践：对于复杂的查询需求，可以通过实现自定义 SQL 查询并使用 executeSQL:withResultBlock: 方法。
• 内存管理：确保在不需要对象时调用 removeFromDatabase 来释放数据库中的对应记录。
• 事务处理：批量操作时可以使用 beginTransaction 和 commitTransaction 进行数据库事务。

4. 典型生态项目

• FMDB：LKDBHelper 内部使用 FMDB 作为 SQLite 的基础操作库，提供了对 SQL 的低级别访问。
• SQLCipher：可选集成，提供数据库加密功能。
• CocoaPods：依赖管理工具，方便集成 LKDBHelper 到项目。

---

本教程只是一个简要概述，更详细的信息和示例代码可以参考项目官方仓库 Readme.md 和示例工程。若在实际使用过程中遇到问题，可以查阅官方文档或直接在 GitHub 上提交 issue 获取帮助。

LKDBHelper-SQLite-ORM全自动的插入,查询,更新,删除， an automatic database operation thread-safe and not afraid of recursive deadlock项目地址:https://gitcode.com/gh_mirrors/lk/LKDBHelper-SQLite-ORM