使用 CocoaPods 可以很方便地引入 AYRecord。在 Podfile 中添加 AYRecord 的依赖。
pod "AYRecord"之前写过一段时间服务器端，使用了 JFinal 作为服务器开发框架，开发速度大大地加快。在开发的过程中，ActiveRecord 的数据库访问操作也让我眼前一亮。由于我在 iOS 开发中也常使用到数据库，因此结合 Objective-C 的特性将 ActiveRecord 移植改造到 iOS 端，命名为 AYRecord。
AYRecord 使用起来极为简单，支持自动建表，自动升级表结构。同时，AYRecord 支持多数据源，并发访问控制等。
使用文档。
首先，先演示一下，AYRecord 的一些常规使用方法，再详细讲一下其它细节用法。
声明一个实体 Student
@class Student;
//默认有一个名为ID的主键属性
@interface Student : AYDbModel<Student *>
@property (nonatomic, copy) NSString *name;/**< 姓名 */
@property (nonatomic, assign) int age;/**< 年龄 */
@property (nonatomic, retain) NSDate *born;/**< 出生年月 */
@end
@implementation Student
@dynamic name;
@dynamic age;
@dynamic born;
@end以上代码已经完成了 AYRecord 初始化的 80% 的工作了，接下来演示如何进行查询。
AYDbModel 的子类默认有一个单例静态方法 dao，用于各类数据库操作。
//查询出生日期在2002年5月9日之后的学生
NSDate *date = [@"2002-05-09" ay_dateValue:@"yyyy-MM-dd"];
NSArray<Student *> *results = [[Student dao] findByCondition:@"born > ?", date];
//查询年龄在15岁以下的学生
NSArray<Student *> *results = [[Student dao] findByCondition:@"age > ?", @15];//仅接受OC类型
//查询出生日期在2002年5月9日之后的学生数量
NSUInteger count = [[Student dao] countByCondition:@"born > ?", date];
//分页查询
AYDbPage<Student *> *stus = [[Student dao] paginate:1 size:10 withSelect:@"select * " where:@"from student where name like '张%%'"];插入
//单条插入
Student *stu = [Student new];
stu.name = @"张三";
stu.age = 20;
stu.born = [NSDate new];
[stu save];
//从Json到数据库
NSString *jsonStr = @"{'name': '张三', 'age': 14, 'born': 1020873600}";
NSDictionary *jsonDic = [jsonStr ay_jsonDictionary];
Student *stu = [[Student alloc] initWithAttributes:jsonDic];
[stu save];删除
//单条删除
Student *stu = [[Student dao] findById:15];
[stu delete];
//按ID删除
[[Student dao] deleteById:20];
//按条件删除
[[Student dao] deleteByCondition:@"name = ?", @"张三"];更新
stu.name = @"李四";
[stu update];好了，如果你看到了这里，说明你已经觉得这个 ORM 框架还不错，可以继续深入了解。那么，接下来，我们再来完成一次完整初始化框架的工作。
再声明一个实体 Teacher
AYDbModel 是数据表实体类的基类，是 AYRecord 的重要组成部分。数据库实体类要求继承于 AYDbModel 类，并且要求将数据库列属性声明为 @dynamic。
没有声明 @dynamic 将不会保存到数据库中。
@class Teacher;
@interface Teacher : AYDbModel<Teacher *>
@property (nonatomic, copy) NSString *name;
@property (nonatomic, assign) int age;
@end
@implementation Teacher
@dynamic name;
@dynamic age;
@end声明 AYDbContext，将实体类注册到上下文。
//在Documents/db/database.db中建立数据库
AYDbContext *context = [[AYDbContext alloc] initWithDatasource:[[[AYFile documents] child:@"db"] child:@"database.db"]];
//是否输出SQL到控制台
context.showSql = YES;
[context registerModel:[Student class]];
[context registerModel:[Teacher class]];
[context initialize];关于 AYFile 的相关操作，请参考 AYFile。
- registerModel:(Class)model 方法建立了数据库表与 Model 的映射关系。
以上便是建立数据库的全部过程了。
AYRecord 可在 MIT 许可证下使用。有关更多信息，请参阅 LICENSE 文件。