作者：Víctor Manuel Pineda 時間：Feb 14, 2017 原文鏈接：https://antonioleiva.com/kotlin-realm-extensions/ 當有人問我，最喜歡Kotlin什麼，我很難找出其突出特性。 數據類型、拉姆達（Lambda）表達式、類型推斷、 ...
作者：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開發工程師。
