在Android加入和使用Realm
原文鏈接: Up and Running With Realm for Android
介紹
如果你比較關心android開發的最新動態的話,那么你肯定會聽說過 Realm ,Realm是一個輕量級的數據庫,在Android開發中,它可以替代 SQLite 和 ORM 框架。
和SQLite相比,Realm速度更快并且它有很多先進的特性,例如對JSON的支持,流暢的API,數據變化通知(觀察者),加密支持… 所有的這一切都會讓android開發者日子過得更瀟灑(這里扯淡了,開發者日子怎么可能瀟灑,當然也可能是國內外不同…)。
這篇文章的主題就是Realm for Android, 在這篇文章中,我將使用 Realm v0.84.1 。
將Realm添加到項目
要在Android項目中使用Realm, 你需要在module的build.gradle文件中添加如下代碼:
compile 'io.realm:realm-android:0.84.1'
創建一個Realm
一個Realm和SQLite比較類似。它有一個文件和他作為關聯,這個文件一次創建,就會永久存在Android系統中。
想要創建一個Realm, 你可以在任意一個Activity中調用靜態方法Realm.getInstance。
Realm myRealm = Realm.getInstance(context);
需要注意的是,我們這樣創建,沒有給它指定RealmConfiguration,這時候創建的文件會使用默認的文件名 default.realm 。
如果你需要創建另外一個Realm,那你就必須要給它傳遞RealmConfiguration.Builder了,并且要給它指定一個唯一的名稱。
</div>Realm myOtherRealm = Realm.getInstance( new RealmConfiguration.Builder(context) .name("myOtherRealm.realm") .build() );
創建RealmObject
如果一個javabean繼承了RealmObject,那么它就可以用來存儲Realm,如果你想知道什么是javabean,來看看這里的定義:javabean是可序列化的,有一個默認的構造方法,成員變量都提供getter和setter方法。例如,下面的代碼可以輕松的保存到Realm中,
public class Country extends RealmObject { private String name; private int population; public Country() { } public String getName() { return name; } public void setName(String name) { this.name = name; } public int getPopulation() { return population; } public void setPopulation(int population) { this.population = population; } }
可以使用@PrimaryKey注解來表示這個一個成員變量是Realm的主鍵。例如下面的代碼是將code字段作為主鍵,
@PrimaryKey private String code;public String getCode() { return code; }
public void setCode(String code) { this.code = code; }</pre>
創建事務
你將會在下面的代碼中發現,使用Realm查詢數據非常簡單, 寫入數據稍稍麻煩點。Realm遵循 ACID 以保證操作的原子性和一致性。在Realm中,所有的寫操作都會在一個事務中。
使用beginTransaction方法可以開啟一個事務,使用commitTransaction方法去提交一個事務。下面的代碼表明如何創建并保存一個Country,
myRealm.beginTransaction();// Create an object Country country1 = myRealm.createObject(Country.class);
// Set its fields country1.setName("Norway"); country1.setPopulation(5165800); country1.setCode("NO");
myRealm.commitTransaction();</pre>
你可能已經注意到了,country1對象并不是使用Country的構造方法創建的,想讓RealmObject保存這個實例, 就必須使用createObject方法創建。
如果你必須要使用構造方法的話,別忘了在提交事務之前調用copyToRealm方法將對象關聯到Realm上,例如:
// Create the object Country country2 = new Country(); country2.setName("Russia"); country2.setPopulation(146430430); country2.setCode("RU");myRealm.beginTransaction(); Country copyOfCountry2 = myRealm.copyToRealm(country2); myRealm.commitTransaction();</pre>
查詢
Realm提供了一套非常直觀簡單的API用來查詢操作,調用Realm的where方法,并且將你需要的類的class傳遞進去, 你就完成了一個查詢的創建,之后, 你可以調用findAll方法來遍歷所有的數據,返回的數據保存在RealmResults對象中,下面的例子,我們查詢出來并且打印了所有的Country
RealmResults<Country> results1 = myRealm.where(Country.class).findAll(); for(Country c:results1) { Log.d("results1", c.getName()); } // Prints Norway, RussiaRealmResults<Country> results1 = myRealm.where(Country.class).findAll(); for(Country c:results1) { Log.d("results1", c.getName()); } // Prints Norway, Russia
除此之外, 你還可以使用beginsWith,endsWith,lesserThan和greaterThan方法來過濾結果,下面的例如展示了如何使用greaterThan方法來查詢所有的population大于1億的Country,RealmResults<Country> results2 = myRealm.where(Country.class) .greaterThan("population", 100000000) .findAll();// Gets only Russia</pre>
如果你想讓查詢結果按照某個順序來,你可以使用findAllSorted方法,它有一個String類型的參數和一個boolean類型的參數,其中,String指定用來排序的字段,boolean指定了排序方式,/ Sort by name, 降序排列 RealmResults<Country> results3 = myRealm.where(Country.class) .findAllSorted("name", false);// Gets Russia, Norway</pre>
想要學習更多關于Realm的知識,可以參考 官方文檔