一、sqlitepersistent 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 “sqlitePersistentObject.h” //Person.m的生成略,大家都应该知道的 @interface Person : sqlitePersistentObject { NSString *iName; int iAge; } @property (nonatomic,retain) NSString * iName; @property (nonatomic) int iAge; @end
[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];
如果要更新,当然这里先要查询出来需要更新的对象,然后修改对象的值并保存就可以了,这里不再详写。
=========================================================
注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”按钮将库添加入项目中。