SQLitepersistentobjects这个框架利用反射机制与value objects的***结合,对sqlite3进行了非常轻量级的对象封装(这点有点像我2007年时写的一个java持久层框架,过些时候我整理一下,开源出来),使用者在编程过程中,基本不用再写sql语句,也不需要再手工生成sqlite3数据库文件。你所关心的,就是值对象继承一个核心类,然后添加值对像的属性,实际他就是一款Objective-C实现的ActiveRecord–Rails社区红透半边天的ORM模式。
一、sqlite persistent objects的下载与安装
sqlitepersistentobjects是google code上的一个开源项目,大家可以出下载它,本项目地址是:http://code.google.com/p/sqlitepersistentobjects/
下载后,得到的源码包src内的源文件,copy到自己的项目中,建议***新建一个分类(new group)见注1,与其它源码分离开来,便于管理.然后再工程中添加”libsqlite3.dylib”库。见注2
二、sqlite persistent objects的使用
在使用前,我们先了解一下他是怎么工作的,首先要创建一个Objective-C类,这个类只需要继承自“SQLitePersistentObject”,然后,添加您想要持久化的Objective-C 2.0属性。当这个类被实例化后,调用”save”方法,会自动保存到数据库中。每一个“SQLitePersistentObject”的子类都会拥有数据库中对应的一张表。每一个属性(不包括集合类型,像,NSDictionary,NSArray,NSSet或这些类的可变类型)都会持久化到表中相应字段中。属性中如果含有指针对象是”SQLitePersistentObject”实例,也将会在关联表里新添条记录。注意,这里的属性必须是实现“NSCoding”的对象,如NSDate,NSString,NSData,NSMutableData,NSNumber与NSObject,而c-string,void pointer, strutct 或 union它们不是对象,将不会支持。但所有的数字(int,float等)都会保存在应的字段上。
我们简单要来做一个例子,定义一个类Person,继承SQLitePersistentObject,把这个类的属性保存到数据库中,代码如下:
- #import
- #import “SQLitePersistentObject.h”
- //Person.m的生成略,大家都应该知道的
- @interface Person : SQLitePersistentObject {
- NSString *iName;
- int iAge;
- }
- @property (nonatomic, retain) NSString * iName;
- @property (nonatomic) int iAge;
- @end
生成类文件后,在其它使用的类中创建实例:
- Person *person = [[Person alloc] init];
- person.iName = @”leeguoli”;
- person.iAge = 20;
调用”save”方法,保存到数据库中:
- [person save];
加载表中的数据也相当的简单。任何一个”Person”类都有多个提供查询的类方法。例如,你可以查询所有姓“lee”的人:
- NSArray *people = [Person findByIName:@"'lee%'"];//这里实际有点像like语句,where iName like 'lee%'
或者更灵活的使用SQL查询条件:
- Person *leeguoli = [Person findFirstByCriteria:@"WHERE i_name = 'leeguoli' AND i_age = 20];
注意大写字母区分的情况用下划线代替(ActiveRecord的惯例)。”findByCriteria:”返回一个NSArray数组,”findFirstByCriteria:”返回一个对象。
如果要更新,当然这里先要查询出来需要更新的对象,然后修改对象的值并保存就可以了,这里不再详写。
=========================================================
注1、Xcode界面中,右键点击Classes目录,选择“Add > New Group”,命名为SQLitePersistentObject。右键点击新建的 “SQLitePersistentObject”目录,选择“Add > Existing Files”,将解压缩出来的src目录下所有文件导入。
注2、请右键点击左部菜单中的”Frameworks”目录,选择 “Add > Existing Frameworks…”,然后在本地目录中选择“/Developer/Platforms/iPhoneOS.platform/Developer /SDKs/iPhoneOS3.1.2.sdk/usr/lib/”,找到“libsqlite3.0.dylib”文件并双击。一个弹出窗口将出现,点击其中“Add”按钮将库添加入项目中。