SQLite3中針對Objective-C的持久層框架
SQLitepersistentobjects這個框架利用反射機制與value objects的***結(jié)合,對sqlite3進行了非常輕量級的對象封裝(這點有點像我2007年時寫的一個java持久層框架,過些時候我整理一下,開源出來),使用者在編程過程中,基本不用再寫sql語句,也不需要再手工生成sqlite3數(shù)據(jù)庫文件。你所關心的,就是值對象繼承一個核心類,然后添加值對像的屬性,實際他就是一款Objective-C實現(xiàn)的ActiveRecord–Rails社區(qū)紅透半邊天的ORM模式。
一、sqlite persistent objects的下載與安裝
sqlitepersistentobjects是google code上的一個開源項目,大家可以出下載它,本項目地址是:http://code.google.com/p/sqlitepersistentobjects/
下載后,得到的源碼包src內(nèi)的源文件,copy到自己的項目中,建議***新建一個分類(new group)見注1,與其它源碼分離開來,便于管理.然后再工程中添加”libsqlite3.dylib”庫。見注2
二、sqlite persistent objects的使用
在使用前,我們先了解一下他是怎么工作的,首先要創(chuàng)建一個Objective-C類,這個類只需要繼承自“SQLitePersistentObject”,然后,添加您想要持久化的Objective-C 2.0屬性。當這個類被實例化后,調(diào)用”save”方法,會自動保存到數(shù)據(jù)庫中。每一個“SQLitePersistentObject”的子類都會擁有數(shù)據(jù)庫中對應的一張表。每一個屬性(不包括集合類型,像,NSDictionary,NSArray,NSSet或這些類的可變類型)都會持久化到表中相應字段中。屬性中如果含有指針對象是”SQLitePersistentObject”實例,也將會在關聯(lián)表里新添條記錄。注意,這里的屬性必須是實現(xiàn)“NSCoding”的對象,如NSDate,NSString,NSData,NSMutableData,NSNumber與NSObject,而c-string,void pointer, strutct 或 union它們不是對象,將不會支持。但所有的數(shù)字(int,float等)都會保存在應的字段上。
我們簡單要來做一個例子,定義一個類Person,繼承SQLitePersistentObject,把這個類的屬性保存到數(shù)據(jù)庫中,代碼如下:
- #import
- #import “SQLitePersistentObject.h”
- //Person.m的生成略,大家都應該知道的
- @interface Person : SQLitePersistentObject {
- NSString *iName;
- int iAge;
- }
- @property (nonatomic, retain) NSString * iName;
- @property (nonatomic) int iAge;
- @end
生成類文件后,在其它使用的類中創(chuàng)建實例:
- Person *person = [[Person alloc] init];
- person.iName = @”leeguoli”;
- person.iAge = 20;
調(diào)用”save”方法,保存到數(shù)據(jù)庫中:
- [person save];
加載表中的數(shù)據(jù)也相當?shù)暮唵?。任何一個”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];
注意大寫字母區(qū)分的情況用下劃線代替(ActiveRecord的慣例)。”findByCriteria:”返回一個NSArray數(shù)組,”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”文件并雙擊。一個彈出窗口將出現(xiàn),點擊其中“Add”按鈕將庫添加入項目中。