juwenz

2个库

DPDBFramework

项目简介

框架主要解决在苹果开发过程中,数据本地持久化问题。开发初期,选择了 sqlite,就一直用到至今,不喜欢使用 coredata,或许它更不错,但人总有那么点执着,或者说固执,不是吗?不多废话,直接介绍。

方法概览

- save:                    //保存或更新对象
- deleteMe;                //删除自身对象
- pk;                      //得到对象主键,默认为-1
+ queryByPk:               //根据主键查询对象
+ saveObjects:;            //批量保存对象
+ deleteAll;               //级连删除对象
+ deleteByPks:;            //批量删除对象,参数是主键数组
+ allObjects;              //查询所有对象
+ (NSArray *)objectsWithPage:(NSInteger)page pageLimit:(NSInteger)pageLimit;    //分页查询
+ (NSArray *)findByCriteria:(NSString *)criteriaString
                   page:(NSInteger)page
              pageLimit:(NSInteger)pageLimit;  //分页条件查询
#待添加
+ 保存文件(包括图片,视频等)

方法使用说明

这部分不会逐个讲解每个方法,而是根据实际项目中对象持久过程中经常遇到的两类情况分别说明:无关联对象和有关联对象。

无关联对象

直接通过代码讲解,简单明了。

<!-- NoRelationshipObject.h -->
#import "DPDBObject.h"
@interface NoRelationshipObject : DPDBObject
@property (nonatomic,strong)        NSString *desc;
@property (nonatomic,assign)        NSInteger    aNumber;
@property (nonatomic,assign)        int          aInt;
@property (nonatomic,assign)        float        aFloat;
@property (nonatomic,assign)        double       aDouble;
@end

上面声明了一个无关联对象,如何保存,请看下面。

<!-- lang: cpp -->
NoRelationshipObject *nrObject = [[NoRelationshipObject alloc] init];
nrObject.desc = @"这是在测试无关联对象";
noObject.aInt = 2012;
// 此处略去其它属性的赋值
//保存到数据库
[noObject save];

如何验证数据库是否成功保存,打开数据库,查看数据库中是否存在这条记录。

一对一关联对象

新建一个类 OneToOneObject

<!-- OneToOneObject.h -->
#import "DPDBObject.h"
@interface OneToOneObject : DPDBObject
@property (nonatomic,strong)        NSString *desc;
@property (nonatomic,strong)        NoRelationshipObject *nrObject;
@end

按照上面方法,创建一个 NoRelationshipObject 对象 nrObject,然后实例化一个 OneToOneObject 对象 otoObject

OneToOneObject *otoObject = [[OneToOneObject alloc] init];
otoObject.desc = @"这是在测试一对一关联对象";
otoObject.nrObject = nrObject;
[otoObject save];

一切如你所料,没有任何意外,如何验证保存成功呢,当然可以在数据库中查找对应的记录是否产生,也可以通过程序检测。

//接上
NSInteger pk = [otoObject pk];
OneToOneObject *object = [OneToOneObject queryByPk:pk];
if(object){
    //可以打断点验证,也可以写代码验证
}else{
    NSLog(@"验证失败,没有保存成功");
}

毫无悬念地结束了,接下来介绍一对多关系的保存;

一对多关联对象的保存

前两种情况都比较简单,第三种情况比较复杂,想了很多方法,包括动态判断类型、配置文件管理、命名判别等,最后因为各种原因放弃了(如果有兴趣可以留言继续讨论这个问题)。现在直接看代码,新建一个类 OneToManyObject

<!-- OneToManyObject.h -->
#import "DPDBObject.h"
@interface OneToManyObject : DPDBObject
@property (nonatomic,strong)        NSString *desc;
@property (nonatomic,strong)        NSArray  *nrArrs;
@end

类中有一个集合类型的属性,由于无法像 Java 一样显式指定里面的类型,所以在第一次查询的时候不知道如何“包装”得到的数据,所以需要在 OneToManyObject.m 方法中添加一个类方法 + (NSDictionary *)collectionTypeInfo;

#import "OneToManyObject.h"
@implementation OneToManyObject
+ (NSDictionary *)collectionTypeInfo
{
    return
    @{
         @"nrArrs":NSStringFromClass([NoRelationshipObject class])
    };
}

相信看到代码已经明白了是什么意思,指定集合类型的元素类型,这下我就明白了,原来里面装的是 NoRelationshipObject 对象,那么我就按照 NoRelationshipObject 的方法进行包装。代码使用如下

OneToManyObject *otmObject = [[OneToManyObject alloc] init];
NSMutableArray *objects = [NSMutableArray array];
for (NSInteger i = 0 ; i < 10 ; i++){
    NoRelationshipObject *nrObject = [[NoRelationshipObject alloc] init];
    nrObject.desc = [NSString stringWithFormat:@"这是在测试无关联对象-%ld",(long)i];
    [objects addObject:nrObject];
}
otmObject.nrArrs = objects;
[otmObject save];

全部搞定,接下来就是验证了,可以参考上面的验证方式进行验证!

适用情况

这个框架并不完整,有几方面的功能没有实现。

  • 事务支持,整个框架没有涉及到事务处理,如果有这方面的业务需求,要让你们失望了。
  • 属性类型修改,对于同一个属性名,如果有修改属性类型的,暂时没有实现,这个功能后期可能会加入。如果对上面两个需求不是特别强烈,可以尝试一下,有问题欢迎一起讨论!!

参考 & 致谢

这个十分重要,喝水不忘挖井人,框架的灵感来自 sqliteobjectpersistence,从一行一行读里面代码中学到了很多东西,它里面的某些功能至今也没有实现,但对于其中频繁计算的部分做了优化,使用了缓存取CPU计算的代价,带来了时间上的优势,再次感谢 sqliteobjectpersistence 作者。

许可: MIT

  • Objective C

JBASIHTTPRequest

自己项目中维护的 ASI,这个版本是直接从 ASIHttpRequest 分支出来的

许可: MIT

  • Objective C