Kotlin將Realm提高到更高層次

 

做者：Víctor Manuel Pineda

時間：Feb 14, 2017

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

 

 

當有人問我，最喜歡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文件中：

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

 

其次，你應該知道這個庫能爲你作什麼：

• 得到默認的Realm實例，在事務完成後關閉它。
• 啓動和提交事務。
• 在其它線程中，爲使Realm對象之間工做，斷開它們的連接。
• 在主線程中執行可觀察的查詢（Realm要求這類查詢）

 

最後，咱們必須作下列工做。看看一些例子：

 

以Java持久化實體

 1 User user = new User("John");
 2 
 3 Realm realm = Realm.getDefaultInstance();
 4 try{
 5    realm.beginTransaction();
 6    realm.copyToRealmOrUpdate(user);  
 7    realm.commitTransaction();
 8 } finally {
 9    realm.close();
10 }

 

等效的Kotlin Realm擴展

1 User("John").save()

 

咱們還能夠有saveAll()方法用於數組和集合。

 

以Java查詢全部給定類型的實體

1 Realm realm = Realm.getDefaultInstance();
2 try {
3     List events = realm.where(Event.class).findAll();
4     events = realm.copyFromRealm(event);
5 } finally {
6     realm.close();
7 }

 

等效的Kotlin Realm擴展

1 val events = Event().allItems

 

咱們也能以簡單的方法執行條件查詢：

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

 

Lambda表達式能夠以參數形式接收RealmQuery實例，這樣咱們就能夠與咱們的條件執行查詢。

 

咱們還能實時觀察和監聽數據變化執行咱們的查詢。這在Realm中多是至關乏味的：

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

 

全部這些被簡化的至關簡單：

val obs = Event().allItemsAsObservable

 

或你要條件約束查詢：

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

 

這是你可達到的高度抽象的小型例子。完整的文檔在GitHub站點上提供。

 

結論

 

如你所見，在某些環境下，擴展用法能最大限度地簡化咱們代碼。

 

隨然，我仍認爲應該謹慎使用擴展，應該避免濫用它們。可是，充分利用好這個特性可以提高咱們代碼的可讀性和可維護性，而且我認爲這個庫是一個好例子。

 

我鼓勵你去試用它，留下你的意見。

 

做者介紹

 

Víctor Manuel Pineda是Kotlin Realm擴展庫的開發者。他是DIGIO Soluciones Digitales 的Android和iOS開發工程師。