因?yàn)闇?zhǔn)備暫時(shí)的拋棄Sqlite而轉(zhuǎn)成Realm。所以在Realm官網(wǎng)上看相關(guān)的教程。看見(jiàn)官網(wǎng)有相應(yīng)的Java-Realm方面的使用教程，于是準(zhǔn)備寫Realm相關(guān)的知識(shí)。但是是全英文的，所以按照官網(wǎng)的教程的步驟，準(zhǔn)備分篇來(lái)進(jìn)行翻譯。當(dāng)然希望大家如果發(fā)現(xiàn)哪里有問(wèn)題，可以提出來(lái)，（不要打我臉）。
按照下面的圖片所示來(lái)分篇翻譯：
然后這篇文章的知識(shí)點(diǎn)是如下圖所示：
Realm Java 能讓你安全、持續(xù)、快速的方式來(lái)寫你的App中的model層。
//定義你的model類，并且繼承自RealmObject
public class Dog extends RealmObject {
private String name;
private int age;
//...生成相應(yīng)屬性的getters 和 setters方法...
}
public class Person extends RealmObject {
@PrimaryKey
private long id;
private String name;
private RealmList<Dog> dogs; // 聲明一對(duì)多的關(guān)系
//...生成相應(yīng)屬性的getters 和 setters方法...
}
//像使用標(biāo)準(zhǔn)的java對(duì)象一樣使用它們
Dog dog = new Dog();
dog.setName("Rex");
dog.setAge(1);
//初始化 Realm
Realm.init(context);
//在該線程中獲取一個(gè)Realm實(shí)例
Realm realm = Realm.getDefaultInstance();
//在Realm中查詢所有的大于2歲的狗
final RealmResults<Dog> puppies = realm.where(Dog.class).lessThan("age", 2).findAll();
puppies.size(); //小狗數(shù)量結(jié)果為0，因?yàn)楝F(xiàn)在Realm中還沒(méi)有添加狗
// 在事務(wù)中存留你的數(shù)據(jù)
realm.beginTransaction();
final Dog managedDog = realm.copyToRealm(dog); // Persist unmanaged objects
Person person = realm.createObject(Person.class); // Create managed objects directly
person.getDogs().add(managedDog);
realm.commitTransaction();
//當(dāng)數(shù)據(jù)改變的時(shí)候，Listener將會(huì)被調(diào)用
puppies.addChangeListener(new RealmChangeListener<RealmResults<Dog>>() {
@Override
public void onChange(RealmResults<Dog> results) {
//查詢到的小狗的數(shù)量結(jié)果也會(huì)在同一時(shí)間被更新掉
puppies.size(); // 小狗數(shù)量為1
}
});
//在后臺(tái)進(jìn)程中異步更新對(duì)象
realm.executeTransactionAsync(new Realm.Transaction() {
@Override
public void execute(Realm bgRealm) {
Dog dog = bgRealm.where(Dog.class).equalTo("age", 1).findFirst();
dog.setAge(3);
}
}, new Realm.Transaction.OnSuccess() {
@Override
public void onSuccess() {
//原始查詢和Realm對(duì)象會(huì)被自動(dòng)更新
puppies.size(); // 小狗的數(shù)量為0，因?yàn)闆](méi)有比2歲更年輕的小狗了
managedDog.getAge(); // 小狗的年齡已經(jīng)被更新為3了
}
});
開始
下載Android使用的 Realm 或者查看reaml-java 的源碼 realm-java on GitHub.
首先要準(zhǔn)備的
我們當(dāng)前只支持在安卓中使用的Java版本Realm。
Android Studio 版本大于等于 1.5.1
最新版本的Android SDK
JDK 版本要大于等于 7
我們支持所有API為9及以上的安卓版本(Android 2.3及2.3以上版本)
安裝
Realm是作為一個(gè)Gradle插件來(lái)進(jìn)行安裝的。
安裝分為二步：
第一步: 在project目錄下的build.gradle中添加下面所示的class路徑
buildscript {
repositories {
jcenter()
}
dependencies {
classpath "io.realm:realm-gradle-plugin:2.2.1"
}
}
project目錄下的 build.gradle 文件如下圖所示位置:
第二步: 在應(yīng)用目錄下的build.gradle文件的內(nèi)容上方處的使用realm-android插件。
apply plugin: 'realm-android'
應(yīng)用目錄下的build.gradle的位置如下所示：
一旦這二步你都已經(jīng)寫好了。就可以簡(jiǎn)單的刷新下你的gradle依賴。如果你通過(guò)v0.88以前的版本來(lái)更新，你需要去清理下你的gradle項(xiàng)目(./gradlew clean) 來(lái)移除之前存在的安裝。
關(guān)于二個(gè)所要修改的build.gradle文件的例子里面如下面顯示查看：
Project level build.gradle
Application level build.gradle
其他的編譯系統(tǒng)
Maven 和 Ant 編譯系統(tǒng)并不支持。如果你希望能看到支持這些編譯系統(tǒng)，請(qǐng)表達(dá)你對(duì)下面問(wèn)題的興趣，然后我們也可以評(píng)估。
Maven support
Ant support
你們的意見(jiàn)將讓我們做決定是否及何時(shí)來(lái)實(shí)現(xiàn)Ant 和 Maven插件。
從 v1.0.0開始，Eclipse將不再支持。我們建議轉(zhuǎn)移到 Android Studio.
ProGuard
ProGuard配置已經(jīng)被Realm library所提供，這意味著你并不需要在你的ProGuard配置去添加其他的Realm的特殊的規(guī)則。
Realm Browser
我們提供了獨(dú)立的名叫Realm Browser Mac app 去讀取和編輯.realm的數(shù)據(jù)庫(kù)
API Reference
你可以查看我們的全部API文檔 ，包括所有的classes, methods 及更多。
例子
看下我們的examples，來(lái)看Realm是如何在app中被使用的。
看這里 來(lái)知道關(guān)于怎么運(yùn)行這些例子的更多詳情。
introExample：包括了簡(jiǎn)單的例子，讓你知道怎么去使用當(dāng)前的API.
gridViewExample ：一個(gè)簡(jiǎn)單的app，來(lái)展示怎么通過(guò)Realm來(lái)支持GridView的存儲(chǔ)。同時(shí)它還呈現(xiàn)了如何構(gòu)建一個(gè)JSON(使用GSON)的數(shù)據(jù)庫(kù)，及如何使用ABI splits來(lái)減少最終的APK的大小。
threadExample ：一個(gè)簡(jiǎn)單的應(yīng)用來(lái)知道如何在多線程環(huán)境中使用Realm。
adapterExample :如何通過(guò)使用RealmBaseAdapter和RealmRecyclerViewAdapter來(lái)使Realm以優(yōu)雅的方式來(lái)作用于 Android ListView and RecyclerView
jsonExample ：呈現(xiàn)如何使用一種新的Realm JSON 工具
encryptionExample ：如何使用加密Realms
rxJavaExamples ：如何搭配RxJava來(lái)使用Realm
unitTestExample :教你在使用Realm的時(shí)候如何編寫單元測(cè)試
