作者:Tomasz Szulc,原文链接,原文日期:2015-11-29
译者:Cee;校对:千叶知风;定稿:千叶知风

我已在网上多次看到「Realm」这个词。我甚至曾在十月时有机会参加由 Swift 用户组组织的 Realm 聚会。最终,我有机会用上了 Realm 这个框架。

案例

现在我正在节食。我需要减一些体重因为在加利福尼亚的时候胖了好多 – 好吃的食物实在是太多了:)!我浏览了一下 iTunes Store 中的那些能够追踪喝水记录的应用,但是在我看来这些应用要么看上去很糟糕,要么交互实在是很烂。我想:如果我决定做一个应用,岂不是一箭双雕吗 – 我又能写一个我想要的应用,又能选择使用 Realm 而不是 Core Data。所以我开工了。

你知道当我看完文档、开始使用 Realm 框架的第一感觉是什么吗?哇,这简直真是太棒了!这些开发的家伙做的简直超棒!

免责声明:接下来所写的仅仅只覆盖了 Realm 框架中最基本的一部分。我建议你们接下来可以去阅读官方文档来获取更多的信息。在这儿我并不想向你们展示关于 Realm 框架的全部内容,因为这篇文章不可能像文档一样又臭又长,并且我自己也会避免这样的问题发生。官方的文档非常的棒,你在开工前可以先读一下它。

我的这个案例并不是很复杂而是非常简单的。整个 app 只有两个抽象模型(Model)类: DayDrinkLogEntry 。此外,这个 app 也需要这些功能:添加、更新、筛选和排序存储的数据。正如我所说这是个简单的 app 。接下来我会呈现 app 中的一些代码片段。

抽象模型(Model)

Realm 中没有像 xcdatamodel-like 这样的文件。抽象模型仅仅是继承自 Object 类的文件。

/**
表示了用户一天的生活。 Day 这个类的信息包含用户所喝的水和他们的每天喝水的目标。
*/

class Day: Object {

dynamic var identifier: String!

/// 表示一天的开始的时间戳(UTC+0 时区)
dynamic var timestamp: NSTimeInterval = 0

/// 用户所喝的水的量(毫升)
dynamic var waterDrank: Float = 0

/// 用户每天喝水的目标(毫升)
dynamic var dailyGoal: Float = 0 // ml

var drinkLogs = List<DrinkLogEntry>()

convenience init(timestamp: NSTimeInterval) {
self.init()
self.timestamp = timestamp
self.identifier = Day.convertTimestampIntoIdentifier(timestamp)
}

override class func primaryKey() -> String? {
return "identifier"
}

override class func indexedProperties() -> [String] {
return ["identifier"]
}

class func convertTimestampIntoIdentifier(timestamp: NSTimeInterval) -> String {
return String(format: "%.0f", arguments: [timestamp])
}
}

所有前有 dynamic 关键字的属性都会被转化成数据抽象层的一部分。Realm 也支持关系型数据。在这个例子中 Day 这个类中存在 drinkLogs 的一对多关系。一对一的关系就仅是类中的特定属性了。

Realm 也支持从 Core Data 中迁移数据。当你需要迁移的时候,可以定义一个闭包并且执行它,然后你就能顺利地执行迁移属性的所有步骤了(译者注:如何从 Core Data 迁移到 Realm)。

索引属性(Indexed properties)和主键(Primary keys)

Realm 框架有很多 Core Data 中没有的新特性(也有可能是我没找到,或者说我就是想提一下这点😊)。第一点就是「索引属性」了。你可以定义需要被索引的属性集合。当属性个数比较小的时候,搜索会变得很快。这有助于性能的提升。

接下来不得不提一下「主键」。你可以定义抽象模型中的一个属性作为它的主键。这能保证更加有效地更新数据以及保证数据的唯一性。

在我使用的这个例子中,主键和索引属性将作为「标识符」,被用于搜索和更新数据。

数据中也可以有被忽略的属性,那些属性将不被持久化保存。

创建、更新并写入数据

你可以使用未被持久化过的抽象模型,而且这些数据可以被持久化时,你可以将它们写入 Realm 中。比起 Core Data,这就是我为什么喜欢 Realm 更多一点 – 因为它能够很好地解决一些临时数据的问题。

let day = Day(timestamp: timestamp)
day.dailyGoal = MenuSettings().dailyGoal

为了能够写入 Realm 或者从 Realm 中读取,你需要创建 Realm 实例:

let realm = try! Realm()

这是如何将数据添加到数据库的方法:

try! realm.write {
realm.add(day)
}

我特别喜欢 Realm 中更新数据的方式。我们假设一下有一部分数据是从网络上下载的,并且他们被映射过而且已经加进了数据库。在数据库中已经存在的数据仅需要更新而不是再次添加。

func fetchAll(completion: [Day] -> Void) {
/**
假设请求返回了 JSON 并且数据已经映射到了抽象数据层的 Day 类型。

创建的数据还没有存入数据库 Realm 中。
数据的标识符是相等的时间戳。
*/

let day1 = Day(timestamp: 0)
let day2 = Day(timestamp: 86400)
let day3 = Day(timestamp: 172800)

completion([day1, day2, day3])
}

func sync() {
fetchAll { (days) -> Void in
let realm = try! Realm()
try! realm.write {
/// 如果有相同的标识符,那么它将会被更新。
realm.add(days, update: true)
}
}
}

这是一种比手动查询带有相同标识符然后更新值域更好的方法。

如果更新的参数被置为 false,那么新的数据将具有和在数据库中存在的数据相同的主键。异常会被抛出。

还有其他一些方法来更新数据,在这篇文章中我就不涉及了。

这是如何得到所有 Day 类型数据的方法:

let days = realm.objects(Day.self)

筛选数据也很简单:

realm.objects(Day.self).filter("identifier == %@", dayIdentifier)

按照时间戳升序排列这些数据:

let days = realm.objects(Day.self).sorted("timestamp", ascending: true)

当你每次执行 object()sorted()filter() 后均会得到一个 Results<T> 类型的数据。这能让你对结果进行额外的筛选排序等操作 - 这功能非常的强大而且非常好使。

小结

在下一个有更加复杂的数据模型的 app 中我还会使用 Realm 吗?答案是肯定的。因为整个框架使用起来非常的简单、集成起来非常的快速,而且 Realm 提供了非常多而且强大的功能特性。

P.S. 这个 app 正在等待过审 :)

2015/12/06更新
这个应用上架了 - Water Intake

本文由 SwiftGG 翻译组翻译,已经获得作者翻译授权,最新文章请访问 http://swift.gg

文章目录
  1. 1. 案例
  2. 2. 抽象模型(Model)
  3. 3. 索引属性(Indexed properties)和主键(Primary keys)
  4. 4. 创建、更新并写入数据
  5. 5. 小结