曾静的博客

但行好事,莫问前程.

嗨,我是曾静 (@devzeng),目前暂居深圳。


这是我用来记录平日学习笔记的地方,欢迎您的访问.

iOS中Realm数据库的基本用法

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

hello_realm.png

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.png

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

####2、Xcode Plugin

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

plugin.png

安装使用:

(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数据库基础教程》

最近的文章

使用SQLCipher加密SQLite数据库

在iOS应用程序开发中经常需要使用SQLite来存储数据,很多时候需要加密保存一部分的数据。常见的做法是将要存储的内容先加密然后存到数据库中,使用的时候将数据进行解密,这样就会有大量的性能消耗在数据的加解密上(性能主要取决于加解密的算法和CPU的能力)。 SQLCipher is an open source extension to SQLite that provides transparent 256-bit AES encryption of database files.SQL...…

iOS继续阅读
更早的文章

GitLab的简单使用

GitLab是一个利用Ruby on Rails开发的开源应用程序,实现一个自托管的Git项目仓库,可通过Web界面进行访问公开的或者私人项目。它拥有与Github类似的功能,能够浏览源代码,管理缺陷和注释。可以管理团队对仓库的访问,它非常易于浏览提交过的版本并提供一个文件历史库。团队成员可以利用内置的简单聊天程序(Wall)进行交流。它还提供一个代码片段收集功能可以轻松实现代码复用,便于日后有需要的时候进行查找。开源中国代码托管平台git.oschina.net就是基于GitLab项目搭...…

Note继续阅读