sqlitepersistentobjects 基于sqllite 持久化库

Cocoa与Cocoa Touch(主要是指iphone,ipad,ipod等等)都对sqlite3提供了良好的支持,但objective-c语言中的sqlite3持久 层框架确没有java中那样丰富与强大、灵活,直到我发现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,把这个类的属性保存到数据库中,代码如下:

1 2 3 4 5 6 7 8 9 10 
#import #import “SQLitePersistentObject.h” //Person.m的生成略,大家都应该知道的 @interface Person : SQLitePersistentObject { NSString *iName; int iAge; } @property (nonatomic, retain) NSString * iName; @property (nonatomic) int iAge; @end

生成类文件后,在其它使用的类中创建实例:

1 2 3 
Person *person = [[Person alloc] init]; person.iName = @”leeguoli”; person.iAge = 20;

调用”save”方法,保存到数据库中:

1 
[person save];

加载表中的数据也相当的简单。任何一个”Person”类都有多个提供查询的类方法。例如,你可以查询所有姓“lee”的人:

1 
NSArray *people = [Person findByIName:@"'lee%'"];//这里实际有点像like语句,where iName like 'lee%'

或者更灵活的使用SQL查询条件:

1 
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”按钮将库添加入项目中。

0

这篇文章还没有评论

发表评论