我已在网上多次看到「Realm」这个词。我甚至曾在十月时有机会参加由 Swift 用户组组织的 Realm 聚会。最终，我有机会用上了 Realm 这个框架。
案例
现在我正在节食。我需要减一些体重因为在加利福尼亚的时候胖了好多 – 好吃的食物实在是太多了:)！我浏览了一下 iTunes Store 中的那些能够追踪喝水记录的应用，但是在我看来这些应用要么看上去很糟糕，要么交互实在是很烂。我想：如果我决定做一个应用，岂不是一箭双雕吗 – 我又能写一个我想要的应用，又能选择使用 Realm 而不是 Core Data。所以我开工了。
你知道当我看完文档、开始使用 Realm 框架的第一感觉是什么吗？哇，这简直真是太棒了！这些开发的家伙做的简直超棒！
免责声明：接下来所写的仅仅只覆盖了 Realm 框架中最基本的一部分。我建议你们接下来可以去阅读官方文档来获取更多的信息。在这儿我并不想向你们展示关于 Realm 框架的全部内容，因为这篇文章不可能像文档一样又臭又长，并且我自己也会避免这样的问题发生。官方的文档非常的棒，你在开工前可以先读一下它。
我的这个案例并不是很复杂而是非常简单的。整个 app 只有两个抽象模型（Model）类： Day 和 DrinkLogEntry 。此外，这个 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。
网友评论