iOS中Realm数据库的基本用法

mac2024-12-03  4

原文   http://git.devzeng.com/blog/simple-usage-of-realm-in-ios.html 主题  Realm iOS开发

Realm是由 Y Combinator 公司孵化的一款支持运行在手机、平板和可穿戴设备上的嵌入式数据库(旨在取代CoreData和Sqlite)。Realm并不是对Core Data的简单封装,相反地,Realm并不是基于Core Data,也不是基于SQLite所构建的。它拥有自己的数据库存储引擎,可以高效且快速地完成数据库的构建操作。 

Realm可以轻松地移植到项目当中,并且绝大部分常用的功能(比如说插入、查询等等)都可以用一行简单的代码轻松完成!目前支持Objective-C、Swift和Java三种语言,也就是说能在iOS、Android和Mac上面跨平台使用。

综上,Realm主要有以下几个优点:

Easy to Use(简单易用):Core Data和SQLite冗余、繁杂的知识和代码足以吓退绝大多数刚入门的开发者,而换用Realm,则可以极大地减少学习代价和学习时间,让应用及早用上数据存储功能。

Cross-Platform(跨平台):现在绝大多数的应用开发并不仅仅只在iOS平台上进行开发,还要兼顾到Android平台的开发。为两个平台设计不同的数据库是愚蠢的,而使用Realm数据库,iOS和Android无需考虑内部数据的架构,调用Realm提供的API就可以完成数据的交换,实现“一个数据库,两个平台无缝衔接”。

Fast(高效):Realm相比使用CoreData和原生的SQLite来说速度更快更加高效,而且代码量更少。

快速集成Realm

1、下载最新的 Realm 更新包,解压zip文件 

2、将 ios/static 目录下面的 Realm.framework 文件拖到项目里面(确保Copy items if needed选中) 

3、在 target -> Build Phases -> Link Binary with Libraries 中添加 libc++.dylib

说明:

(1)对于使用Swift的童鞋,请讲Swift/RLMSupport.swift文件拖到项目中(确保Copy items if needed选中)

(2)推荐使用Cocoapods进行安装,在Podfile中添加 pod 'Realm' 即可 

(3)也可以自行到Github上面下载代码进行编译,此处不作过多的介绍

运行环境:

(1)支持 >= iOS7.0, >= OS X 10.9, 及WatchKit

(2)推荐使用Xcode 5以上的IDE,支持Swift

辅助工具和插件的安装

 

1、Realm Browser

Realm官方非常贴心的向开发者提供了一个用于查看喝编辑Realm数据的工具 Realm Browser . 

在上面下载的更新包的 browser/ 下面有个Realm Browser拖到Application文件夹或者是直接打开都行。另外可以使用菜单的 tool -> generate demo datebase ,生成测试数据用于测试Realm数据库的使用 

2、Xcode Plugin(Xcode8之后好像苹果大大不再支持Xcode插件,如果硬是要使用插件,还是有办法的,请自行谷歌)

在Realm中使用到最多的是Realm Model(继承自RLMObject的类,后面有介绍)。官方提供了一个Xcode的插件让我们在创建模型变得非常轻松

安装使用:

(1)最简单的安装方式是通过Alcatraz,搜索 RealmPlugin 直接安装 

(2)或者是打开zip文件夹下面的 plugin/RealmPlguin.xcodeproj ,build一下就安装好了 

安装完后重启Xcode生效,在创建model的时候选择New File(或⌘N),选择Realm按照要求输入model的名字就OK啦。

Realm的使用

1、构建数据库

Realm提供了三种方式创建数据库,一种是存储在默认路径下的数据库,一种是我们可以自己指定数据库文件的存储路径和只读属性,另外还可以使用内存数据库。

(1)默认Realm数据库

RLMRealm *realm = [RLMRealm defaultRealm];

可以通过: [RLMRealm defaultRealmPath] 查看默认存储的路径。 

(2)自定义Realm数据库

NSString *docPath = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject]; NSString *dbPath = [docPath stringByAppendingPathComponent:@"db/db.realm"]; RLMRealm *realm = [RLMRealm realmWithPath:dbPath];

或者是

NSString *docPath = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject]; NSString *dbPath = [docPath stringByAppendingPathComponent:@"db/db.realm"]; RLMRealm *realm = [RLMRealm realmWithPath:dbPath readOnly:YES error:nil];

其中readOnly表示创建的数据库是只读数据库。

(3)内存数据库

正常的Realm数据库是存储在硬盘上的, 但你也可以通过使用 + (instancetype)inMemoryRealmWithIdentifier:(NSString *)identifier; 来创建一个内存数据库。 

RLMRealm *realm = [RLMRealm inMemoryRealmWithIdentifier:@"test"];

注意:内存数据库在每次程序退出时不会保存数据。如果某个内存Realm实例没有被引用,所有的数据在实例对象释放的适合也会被释放。建议你在app中用强引用来钳制所有新建的内存Realm数据库实例。

2、数据模型

Realm的数据模型是用传统的Objective-C接口(interface)和属性(@property)定义的。 只要定义 RLMObject 的一个子类或者一个现成的模型类,你就能轻松创建一个Realm的数据模型对象。Realm模型对象和其他的Objective-c的功能很相似–你可以给它们添加你自己的方法和protocol然后和其他的对象一样使用。 唯一的限制就是从它们被创建开始,只能在一个进程中被使用。 

如果已经安装了Realm Xcode插件,在 New File 对话框中会有一个很漂亮的样板,你可以用它来创建interface和implementation文件。 

用一个对象来表示一篇文章(Articl),创建的数据模型如下:

Article.h @interface Article : RLMObject @property NSString *num;//序号 @property NSString *title;//标题 @property NSString *link;//链接地址 @property NSString *author;//作者 @property NSString *tag;//标签分类 @property NSInteger weight;//权重 @end RLM_ARRAY_TYPE(Article) Article.m @implementation Article //主键 + (NSString *)primaryKey { return @"num"; } //需要添加索引的属性 + (NSArray *)indexedProperties { return @[@"title"]; } //默认属性值 + (NSDictionary *)defaultPropertyValues { return @{@"author":@"zengjing"}; } //忽略的字段 + (NSArray *)ignoredProperties { return @[@"weight"]; } @end

说明:

(1)Realm支持以下的属性(property)种类:BOOL, bool, int, NSInteger, long, float, double, CGFloat, NSString, NSDate 和 NSData。

(2)你可以使用 RLMArray<Object> 和 RLMObject 来模拟对一或对多的关系(Realm也支持RLMObject继承) 

(3)Realm忽略了Objective-C的property attributes(如nonatomic, atomic, strong, copy, weak 等等)。 所以,推荐在创建模型的时候不要使用任何的property attributes。但是,假如你设置了,这些attributes会一直生效直到RLMObject被写入realm数据库。

(4)定义了 RLM_ARRAY_TYPE(Article) 这个宏表示支持 RLMArray<Article> 该属性 

(5)另外Realm提供了以下几个方法供对属性进行自定义:

1) + (NSArray *)indexedProperties; : 可以被重写来来提供特定属性(property)的属性值(attrbutes)例如某个属性值要添加索引。 

2) + (NSDictionary *)defaultPropertyValues; : 为新建的对象属性提供默认值。 

3) + (NSString *)primaryKey; : 可以被重写来设置模型的主键。定义主键可以提高效率并且确保唯一性。 

4) + (NSArray *)ignoredProperties; :可以被重写来防止Realm存储模型属性。 

3、数据增删改查

(1)存储数据

创建数据模型对象:

Article *article = [[Article alloc] init]; article.num = @"1"; article.title = @"iOS开发中集成Reveal"; article.link = @"http://blog.devzeng.com/blog/ios-reveal-integrating.html"; article.tag = @"iOS";

存储数据:

RLMRealm *realm = [RLMRealm defaultRealm]; [realm beginWriteTransaction]; [realm addObject:article]; [realm commitWriteTransaction];

(2)删除数据

1)删除指定的数据:

- (void)deleteObject:(RLMObject *)object;

2)删除一组数据:

- (void)deleteObjects:(id)array;

3)删除全部的数据:

- (void)deleteAllObjects;

(3)修改数据

修改数据如果该条数据不存在则会新建一条数据。

1)针对单个数据进行的修改或新增:

- (void)addOrUpdateObject:(RLMObject *)object;

2)针对一组数据的修改或新增:

- (void)addOrUpdateObjectsFromArray:(id)array;

说明:对于增加、删除、修改必须要在事务中进行操作。

(5)查询数据

1)查询全部数据

RLMResults *results = [Article allObjects];

或指定Realm数据库:

NSString *path = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject]; NSString *realmPath = [path stringByAppendingPathComponent:@"devzeng.realm"]; RLMRealm *realm = [RLMRealm realmWithPath:realmPath]; RLMResults *results = [Article allObjectsInRealm:realm];

2)条件查询

假设要查询所有分组是iOS和作者是zengjing的文章:

RLMResults *results = [Article objectsWhere:@"tag = 'iOS' AND author = 'zengjing'"];

也可以使用谓词查询:

NSPredicate *pred = [NSPredicate predicateWithFormat:@"tag = '%@' AND author = '%@'", @"iOS", @"zengjing"]; RLMResults *results = [Article objectsWithPredicate:pred];

3)条件排序

假设要查询所有分组是iOS和作者是zengjing的文章,然后筛选出来的结果按照num字段进行递增排序:

RLMResults *results = [[Article objectsWhere:@"tag = 'iOS' AND author = 'zengjing'"] sortedResultsUsingProperty:@"num" ascending:YES];

4)链式查询(结果过滤)

假设要查询所有所属分组是iOS的文章,然后从中筛选出作者是zengjing的数据:

RLMResults *results1 = [Article objectsWhere:@"tag = 'iOS'"]; RLMResults *results2 = [results1 objectsWhere:@"author = 'zengjing'"];

4、通知

每当一次写事务完成Realm实例都会向其他线程上的实例发出通知,可以通过注册一个block来响应通知:

self.token = [realm addNotificationBlock:^(NSString *note, RLMRealm * realm) { [_listTableView reloadData]; }];

只要有任何的引用指向这个返回的notification token,它就会保持激活状态。在这个注册更新的类里,你需要有一个强引用来钳制这个token, 因为一旦notification token被释放,通知也会自动解除注册。

@property (nonatomic, strong) RLMNotificationToken *token;

另外可以使用下面的方式解除通知:

[realm removeNotification:self.token];

5、数据库版本迁移

当你和数据库打交道的时候,时不时的你需要改变数据模型(model),但因为Realm中得数据模型被定义为标准的Objective-C interfaces,要改变模型,就像改变其他Objective-C interface一样轻而易举。举个例子,假设有个数据模型 Person : 

在v1.0中数据模型如下:

// v1.0 @interface Person : RLMObject @property NSString *firstName; @property NSString *lastName; @property int age; @end

升级到v2.0之后将firstName和lastName字段合并为一个字段fullName

// v2.0 @interface Person : RLMObject @property NSString *fullName; // new property @property int age; @end

迁移的逻辑可以为:

[RLMRealm setSchemaVersion:2.0 forRealmAtPath:[RLMRealm defaultRealmPath] withMigrationBlock:^(RLMMigration *migration, NSUInteger oldSchemaVersion) { [migration enumerateObjects:Person.className block:^(RLMObject *oldObject, RLMObject *newObject) { if (oldSchemaVersion < 2.0) { newObject[@"fullName"] = [NSString stringWithFormat:@"%@ %@", oldObject[@"firstName"], oldObject[@"lastName"]]; } }]; }];

当版本升级到3.0时,添加新的属性email

// v3.0 @interface Person : RLMObject @property NSString *fullName; @property NSString *email; // new property @property int age; @end

迁移的逻辑可以为:

[RLMRealm setSchemaVersion:2.0 forRealmAtPath:[RLMRealm defaultRealmPath] withMigrationBlock:^(RLMMigration *migration, NSUInteger oldSchemaVersion) { [migration enumerateObjects:Person.className block:^(RLMObject *oldObject, RLMObject *newObject) { //处理v2.0的更新 if (oldSchemaVersion < 2.0) { newObject[@"fullName"] = [NSString stringWithFormat:@"%@ %@", oldObject[@"firstName"], oldObject[@"lastName"]]; } //处理v3.0的更新 if(oldSchemaVersion < 3.0) { newObject[@"email"] = @""; } }]; }];

说明(摘自官方的FAQ)

1、realm的支持库有多大?

一旦你的app编译完成,realm的支持库应该只有1MB左右。我们发布的那个可能有点大(iOS ~37MB, OSX ~2.4MB), 那是因为它们还包含了对其他构架的支持(ARM,ARM64,模拟器的是X86)和一些编译符号。 这些都会在你编译app的时候被Xcode自动清理掉。

2、我应该在正式产品中使用realm吗?

自2012年起,realm就已经开始被用于正式的商业产品中了。正如你预期,我们的objective-c & Swift API 会随着社区的反馈不断的完善和进化。 所以,你也应该期待realm带给你更多的新特性和版本修复。

3、我要付realm的使用费用吗?

不要, Realm的彻底免费的, 哪怕你用于商业软件。

参考资料

1、 《Realm Document》

2、 《Realm数据库基础教程》

最新回复(0)