作者:Víctor Manuel Pineda

时间:Feb 14, 2017

原文链接:https://antonioleiva.com/kotlin-realm-extensions/

Kotlin将Realm提升到更高层次-LMLPHP

当有人问我,最喜欢Kotlin什么,我很难找出其突出特性。

数据类型、拉姆达(Lambda)表达式、类型推断、委托… 所有这些都担当起一系列完整的、有意义的提升,使其在这些方面不同于其基础的Java。

探索Kotlin扩展

当然,这些特性其中任何一个都是我使用最多的扩展。在所有我的Android项目中,我都利用Kotlin的扩展

我第一次听到这概念时感到很奇怪。无需继承就可以添加函数进入类,甚至不用访问,似乎对我时无用的和没有必要的。

加入类的任何内容位置点是在我的范围中吗?我的第一印象不是很好。我认为这将导致一些坏习惯,且代码难于理解。

然而,在我开始理解所有这些简单概念背后的强大能力,所有疑问很快就消失了。

用imageView.loadFrom(url)从url加载图像,简单地10.toPx(context)将dp单位转换到px单位,或用view.removeFromParent()方法从父视图中删除一个视图时,是非常有趣的。它们都是我需要的方法。

现在,我已经可以如同它们是Android SDK的一部分使用它们了

Realm遇到Kotlin:能力更强大

所有这些促使我编写小型扩展库简化Realm的用法

如果你已经试用(且忍受)Android的Realm,你就应该知道它包含一些通用操作的模板。另外,它有些限制使其变得复杂,如需要人为打开和关闭Realm实例,且要在同一个线程中执行

另一个限制是,你没有先从Realm解开不同线程之间的链接,那么你就不能在它们之间传递你的查询结果。即使你要执行的是单一操作,你还必须注意事务管理。

有些很烦人的限制例子,你必须意识到它们在未来避免这些问题。

我编写这个库的目的是要将Realm API转换我所喜欢的那样。我要忽略所有Realm的限制,使其工作在更高的抽象层上。

这个库的名称是Kotlin Realm Extensions(Kotlin Realm扩展)你可以在这里找到

它使用起来非常简单。首先,你必须包含以下依赖关系到你的build.gradle文件中:

 compile 'com.github.vicpinm:krealmextensions:1.0.4'

其次,你应该知道这个库能为你做什么:

  • 获得默认的Realm实例,在事务完成后关闭它。
  • 启动和提交事务。
  • 在其它线程中,为使Realm对象之间工作,断开它们的链接。
  • 在主线程中执行可观察的查询(Realm要求这类查询)

最后,我们必须做下列工作。看看一些例子:

以Java持久化实体

 User user = new User("John");

 Realm realm = Realm.getDefaultInstance();
try{
realm.beginTransaction();
realm.copyToRealmOrUpdate(user);
realm.commitTransaction();
} finally {
realm.close();
}

等效的Kotlin Realm扩展

 User("John").save()

我们还可以有saveAll()方法用于数组和集合。

以Java查询所有给定类型的实体

 Realm realm = Realm.getDefaultInstance();
try {
List events = realm.where(Event.class).findAll();
events = realm.copyFromRealm(event);
} finally {
realm.close();
}

等效的Kotlin Realm扩展

 val events = Event().allItems

我们也能以简单的方法执行条件查询:

 val events = Event().query { it.equalTo("id",1) }

Lambda表达式可以以参数形式接收RealmQuery实例,这样我们就可以与我们的条件执行查询。

我们还能实时观察和监听数据变化执行我们的查询。这在Realm中可能是相当乏味的:

 Realm realm = Realm.getDefaultInstance();
Observable<List> obs = realm.where(Event.class).findAllAsync()
.asObservable()
.filter(RealmResults::isLoaded)
.map(realm::copyFromRealm)
.doOnUnsubscribe(() -> realm.close());

所有这些被简化的相当简单:

val obs = Event().allItemsAsObservable

或你要条件约束查询:

 val obs = Event().queryAsObservable { it.equalTo("id",1) }

这是你可达到的高度抽象的小型例子。完整的文档在GitHub站点上提供。

结论

如你所见,在某些环境下,扩展用法能最大限度地简化我们代码

随然,我仍认为应该谨慎使用扩展,应该避免滥用它们。但是,充分利用好这个特性能够提升我们代码的可读性和可维护性,并且我认为这个库是一个好例子。

我鼓励你去试用它,留下你的意见

作者介绍

Víctor Manuel Pineda是Kotlin Realm扩展库的开发者。他是DIGIO Soluciones Digitales 的Android和iOS开发工程师。

05-16 00:24