【Android】Realm詳解

介紹

Realm 是一個 MVCC （多版本并發(fā)控制）數(shù)據(jù)庫歌豺，由Y Combinator公司在2014年7月發(fā)布一款支持運行在手機印叁、平板和可穿戴設(shè)備上的嵌入式數(shù)據(jù)庫，目標是取代SQLite呆贿。
Realm 本質(zhì)上是一個嵌入式數(shù)據(jù)庫酿箭，他并不是基于SQLite所構(gòu)建的。它擁有自己的數(shù)據(jù)庫存儲引擎垃你，可以高效且快速地完成數(shù)據(jù)庫的構(gòu)建操作椅文。和SQLite不同，它允許你在持久層直接和數(shù)據(jù)對象工作惜颇。在它之上是一個函數(shù)式風(fēng)格的查詢api皆刺，眾多的努力讓它比傳統(tǒng)的SQLite 操作更快 。
詳細介紹（如果進不去官还，看這個也行）

優(yōu)勢

如果在在使用它時候芹橡，連它的優(yōu)勢在哪都不知道的話就有點說不過去了。

  • 易用
    Ream 不是在SQLite基礎(chǔ)上的ORM望伦，它有自己的數(shù)據(jù)查詢引擎林说。并且十分容易使用煎殷。
  • 快速
    由于它是完全重新開始開發(fā)的數(shù)據(jù)庫實現(xiàn)，所以它比任何的ORM速度都快很多腿箩，甚至比SLite速度都要快豪直。
  • 跨平臺
    Realm 支持 iOS & OS X (Objective?C & Swift) & Android。我們可以在這些平臺上共享Realm數(shù)據(jù)庫文件珠移，并且上層邏輯可以不用任何改動的情況下實現(xiàn)移植弓乙。
  • 高級
    Ream支持加密，格式化查詢钧惧，易于移植暇韧，支持JSON，流式api浓瞪，數(shù)據(jù)變更通知等高級特性
  • 可視化
    Realm 還提供了一個輕量級的數(shù)據(jù)庫查看工具懈玻，在Mac Appstore 可以下載“Realm Browser”這個工具，開發(fā)者可以查看數(shù)據(jù)庫當中的內(nèi)容乾颁，執(zhí)行簡單的插入和刪除數(shù)據(jù)的操作涂乌。（windows上還不清楚）

條件

  • 目前不支持Android以外的Java
  • Android Studio >= 1.5.1
  • 較新的Android SDK版本
  • JDK version >=7.
  • 支持API 9(Android 2.3)以及之后的版本

使用

不介紹了，看代碼了英岭。

  • 加入依賴
    在project的build中加入依賴
buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath "io.realm:realm-gradle-plugin:2.2.1"
    }
}

project/build

在module中加入

apply plugin: 'realm-android'
module/build

Realm從v1.0.0后湾盒，不支持Ecilpse，我們推薦使用Android Studio

創(chuàng)建model

創(chuàng)建一個User類诅妹，需要繼承RealmObject罚勾。支持public, protected和 private的類以及方法

public class User extends RealmObject {
    private String name;
    private int age;

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
    }
}

除了直接繼承于RealmObject來聲明 Realm 數(shù)據(jù)模型之外，還可以通過實現(xiàn) RealmModel接口并添加 @RealmClass修飾符來聲明吭狡。

@RealmClass
public class User implements RealmModel {
    ...
}
  • 支持的屬性
    boolean, byte, short,int,long,float, double,String, Date 和荧库，byte[], RealmObject, RealmList<? extends RealmObject>
    還支持Boolean, Byte, Short, Integer, Long, Float 和 Double
    Tip：整數(shù)類型 short、int 和 long 都被映射到 Realm 內(nèi)的相同類型（實際上為 long ）
  • @PrimaryKey——表示該字段是主鍵
    使用過數(shù)據(jù)庫的同學(xué)應(yīng)該看出來了赵刑，PrimaryKey就是主鍵分衫。使用@PrimaryKey來標注，字段類型必須是字符串（String）或整數(shù)（byte般此，short蚪战，int或long）以及它們的包裝類型（Byte,Short, Integer, 或 Long）。不可以存在多個主鍵铐懊，使用字符串字段作為主鍵意味著字段被索引（注釋@PrimaryKey隱式地設(shè)置注釋@Index）邀桑。
@PrimaryKey
private String id;
  • @Required——表示該字段非空
    在某些情況下，有一些屬性是不能為null的科乎。使用@Required可用于用于強行要求其屬性不能為空壁畸，只能用于Boolean, Byte, Short, Integer, Long, Float, Double, String, byte[] 和 Date。在其它類型屬性上使用 @Required修飾會導(dǎo)致編譯失敗。
    Tip：基本數(shù)據(jù)類型不需要使用注解 @Required捏萍，因為他們本身就不可為空太抓。
@Required
private String name;
  • @Ignore——表示忽略該字段
    被添加@Ignore標簽后，存儲數(shù)據(jù)時會忽略該字段令杈。
@Ignore
private String name;
  • @Index——添加搜索索引
    為字段添加搜索索引走敌，這樣會使得插入的速度變慢，數(shù)據(jù)量也變得更大逗噩。不過在查詢速度將變得更快掉丽，建議只在優(yōu)化讀取性能的特定情況時添加索引。支持索引：String异雁，byte捶障，short，int纲刀，long残邀，boolean和Date字段。


 > **注意**：如果你創(chuàng)建Model并運行過柑蛇，然后修改了Model。那么就需要升級數(shù)據(jù)庫驱闷，否則會拋異常耻台。升級方式后面會提到

### **初始化**
使用默認配置
```java
        Realm.init(this);
        Realm mRealm = Realm.getDefaultInstance();

這時候會創(chuàng)建一個叫做 default.realm的Realm文件，一般來說空另，這個文件位于/data/data/包名/files/盆耽。通過realm.getPath()來獲得該Realm的絕對路徑。

注意：模擬器上運行時扼菠，Realm.getDefaultInstance()拋出異常摄杂，真機上沒問題（不止何故）

當然，我們還可以使用RealmConfiguration來配置Realm

RealmConfiguration config = new RealmConfiguration.Builder() 
            .name("myrealm.realm") //文件名
            .schemaVersion(0) //版本號
            .build();
Realm realm = Realm.getInstance(config);

創(chuàng)建非持久化的Realm循榆，也就是保持在內(nèi)存中析恢，應(yīng)用關(guān)閉后就清除了。

RealmConfiguration myConfig = new RealmConfiguration.Builder(context) 
            .name("myrealm.realm")//保存在內(nèi)存中
            .inMemory() .build();

RealmConfiguration支持的方法：

  • Builder.name : 指定數(shù)據(jù)庫的名稱秧饮。如不指定默認名為default映挂。
  • Builder.schemaVersion : 指定數(shù)據(jù)庫的版本號。
  • Builder.encryptionKey : 指定數(shù)據(jù)庫的密鑰盗尸。
  • Builder.migration : 指定遷移操作的遷移類柑船。
  • Builder.deleteRealmIfMigrationNeeded : 聲明版本沖突時自動刪除原數(shù)據(jù)庫。
  • Builder.inMemory : 聲明數(shù)據(jù)庫只在內(nèi)存中持久化泼各。
  • build : 完成配置構(gòu)建鞍时。

關(guān)閉Realm

記得使用完后，在onDestroy中關(guān)閉Realm

@Override 
protected void onDestroy() { 
    super.onDestroy();
    // Close the Realm instance. 
    realm.close(); 
}

增

寫入操作需要在事務(wù)中進行，可以使用executeTransaction方法來開啟事務(wù)逆巍。

  • 使用executeTransaction方法插入數(shù)據(jù)
        mRealm.executeTransaction(new Realm.Transaction() {
            @Override
            public void execute(Realm realm) {
                User user = realm.createObject(User.class);
                user.setName("Gavin");
                user.setAge(23);
            }
        });

在execute方法中執(zhí)行插入操作

注意：如果在UI線程中插入過多的數(shù)據(jù)及塘，可能會導(dǎo)致主線程擁塞。

  • 使用copyToRealmOrUpdate或copyToRealm方法插入數(shù)據(jù)
    當Model中存在主鍵的時候蒸苇，推薦使用copyToRealmOrUpdate方法插入數(shù)據(jù)磷蛹。如果對象存在，就更新該對象溪烤；反之味咳，它會創(chuàng)建一個新的對象。若該Model沒有主鍵檬嘀，使用copyToRealm方法槽驶，否則將拋出異常。
        final User user = new User();
        user.setName("Jack");
        user.setId("2");
        mRealm.executeTransaction(new Realm.Transaction() {
            @Override
            public void execute(Realm realm) {
                realm.copyToRealmOrUpdate(user);
            }
        });
  • 如果你用的是這樣的modle 
public class User2 extends RealmObject {
      public String name;
      public int age;
}

就這樣寫

        mRealm.executeTransaction(new Realm.Transaction() {
            @Override
            public void execute(Realm realm) {
                User2 user = realm.createObject(User2.class);
                user.name = "Micheal";
                user.age = 30;
            }
        });
  • 如果User還有其他屬性是鸳兽，比如養(yǎng)了只Dog：
public class Dog extends RealmObject {
      private String name;
      private int age;
      //getters and setters
}

對應(yīng)的User屬性中加入Dog類

public class User extends RealmObject {
      private String name;
      private int age;
      private Dog dog;
      //getters and setters
}

如果你養(yǎng)了不止一只掂铐，你養(yǎng)了二哈、阿拉撕家...那你就要用到RealmList了揍异。在User中加入該屬性

private RealmList<Dog> dogs;

插入數(shù)據(jù)

    @Override
    public void execute(Realm realm) {
        User user = realm.createObject(User.class);
        user.setName("Gain");
        user.setAge(23);

        Dog dog1 = realm.createObject(Dog.class);
        dog1.setAge(1);
        dog1.setName("二哈");
        user.getDogs().add(dog1);

        Dog dog2 = realm.createObject(Dog.class);
        dog2.setAge(2);
        dog2.setName("阿拉撕家");
        user.getDogs().add(dog2);
      }
});
  • 上面都是用可executeTransaction方法插入數(shù)據(jù)全陨，還有另一種方法可以用于插入數(shù)據(jù)——beginTransaction和commitTransaction 
mRealm.beginTransaction();//開啟事務(wù)
User user = mRealm.createObject(User.class);
user.setName("Gavin");
user.setId("3");
mRealm.commitTransaction();//提交事務(wù)

在插入前，先調(diào)用beginTransaction()衷掷，完成后調(diào)用commitTransaction()即可辱姨。

注意：在UI和后臺線程同時開啟創(chuàng)建write的事務(wù)，可能會導(dǎo)致ANR錯誤戚嗅。為了避免該問題雨涛，可以使用executeTransactionAsync來實現(xiàn)。

  • 使用executeTransactionAsync
    該方法會開啟一個子線程來執(zhí)行事務(wù)懦胞，并且在執(zhí)行完成后進行結(jié)果通知替久。
RealmAsyncTask transaction = mRealm.executeTransactionAsync(new Realm.Transaction() {
    @Override
    public void execute(Realm realm) {
        User user = realm.createObject(User.class);
        user.setName("Eric");
        user.setId("4");
      }
});

還可以加入監(jiān)聽

RealmAsyncTask transaction =  mRealm.executeTransactionAsync(new Realm.Transaction() {
    @Override
    public void execute(Realm realm) {
        User user = realm.createObject(User.class);
        user.setName("Eric");
        user.setId("4");
      }
}, new Realm.Transaction.OnSuccess() {
    @Override
    public void onSuccess() {
        //成功回調(diào)
      }
}, new Realm.Transaction.OnError() {
    @Override
    public void onError(Throwable error) {
        //失敗回調(diào)
      }
});

注意：如果當Acitivity或Fragment被銷毀時，在OnSuccess或OnError中執(zhí)行UI操作躏尉，將導(dǎo)致程序奔潰 蚯根。用RealmAsyncTask .cancel();可以取消事務(wù)
在onStop中調(diào)用，避免crash

public void onStop () {
    if (transaction != null && !transaction.isCancelled()) {
        transaction.cancel();
      }
}
  • JSON
    Realm還是個很nice的功能就是將Json字符串轉(zhuǎn)化為對象胀糜，厲害了我的Realm
    （直接借用官方的例子）
// 一個city model
public class City extends RealmObject {
    private String city;
    private int id;
    // getters and setters left out ...
}
// 使用Json字符串插入數(shù)據(jù)
realm.executeTransaction(new Realm.Transaction() {
    @Override
    public void execute(Realm realm) {
        realm.createObjectFromJson(City.class, "{ city: \"Copenhagen\", id: 1 }");
    }
});
// 使用InputStream插入數(shù)據(jù)
realm.executeTransaction(new Realm.Transaction() {
    @Override
    public void execute(Realm realm) {
        try {
            InputStream is = new FileInputStream(new File("path_to_file"));
            realm.createAllFromJson(City.class, is);
        } catch (IOException e) {
            throw new RuntimeException();
        }
    }
});

Realm 解析 JSON 時遵循如下規(guī)則：

  • 使用包含空值（null）的 JSON 創(chuàng)建對象：
  • 對于非必須（可為空值的屬性）稼锅，設(shè)置其值為 null；
  • 對于必須（不可為空值的屬性）僚纷，拋出異常矩距；
  • 使用包含空值（null）的 JSON 更新對象：
  • 對于非必須（可為空值的屬性），設(shè)置其值為 null怖竭；
  • 對于必須（不可為空值的屬性）锥债，拋出異常；
  • 使用不包含對應(yīng)屬性的 JSON： * 該屬性保持不變

查

查找操作就比插入方便多了，并不需在事務(wù)中操作哮肚，直接查詢即可登夫。

  • findAll ——查詢
    例：查詢所有的User 
RealmResults<User> userList = mRealm.where(User.class).findAll();

這里使用RealmResults來接受查詢到的結(jié)果，突然出現(xiàn)的RealmResults可能會讓人懵逼允趟∧詹撸看看他的源碼，發(fā)現(xiàn)RealmResults繼承了AbstractList潮剪，而AbstractList又實現(xiàn)了List接口涣楷。好吧，原來實現(xiàn)了我們熟悉的List接口抗碰。

public final class RealmResults<E extends RealmModel> extends AbstractList<E>

public abstract class AbstractList<E> extends AbstractCollection<E> implements List<E>
RealmResults源碼

注意：RealmResults雖然實現(xiàn)了List接口狮斗，不過有很多方法是不能用的。比如add弧蝇、addAll碳褒、remove、clear等看疗，調(diào)用后會直接拋異常沙峻。不過也不用當心誤用這些方法，因為它們都被標記為@Deprecated了两芳。

  • findAllAsync——異步查詢
    當數(shù)據(jù)量較大摔寨，可能會引起ANR的時候，就可以使用findAllAsync 
        RealmResults<User> userList = mRealm.where(User.class)
                .equalTo("name", "Gavin")
                .findAllAsync();

值得注意的是盗扇，這里并不會馬上查到數(shù)據(jù)，是有一定延時的沉填。也就是說疗隶，你馬上使用userList的時候，里面是沒有數(shù)據(jù)的翼闹“弑牵可以注冊RealmChangeListener監(jiān)聽器，或者使用isLoaded()方法猎荠，判斷是否查詢完成

if (result.isLoaded()) {
     // 完成查詢
}
  • findFirst ——查詢第一條數(shù)據(jù)
    例：查詢User表中的第一條數(shù)據(jù)
User user2 = mRealm.where(User.class).findFirst();
  • equalTo ——根據(jù)條件查詢
    例：得到name為Gavin的用戶列表坚弱。
RealmResults<User> userList = mRealm.where(User.class)
            .equalTo("name", "Gavin").findAll();

如果User中還有Dog屬性，希望根據(jù)Dog的條件來獲取用戶：
例：查詢dogs.name為二哈的User

RealmResults<User> userList = mRealm.where(User.class)
             .equalTo("dogs.name", "二哈").findAll();

得到有養(yǎng)有dogs.name為"二哈"的用戶列表（這里的dogs是User表中的屬性名）

  • equalTo ——多條件查詢
    當然关摇，我們還經(jīng)常要用到多條件的查詢的功能荒叶。
    例：找到用戶名為“Gavin”，且dogs.name為“二哈”的User 
RealmResults<User> userList = mRealm.where(User.class)
            .equalTo("name", "Gavin").findAll();
RealmResults<User> userList = user5.where()
            .equalTo("dogs.name", "二哈").findAll();

上面先找到name為“Gavin”的User列表输虱，然后再得到的結(jié)果中查詢dogs.name為“二哈”
覺得這樣寫太麻煩些楣？我也是這樣想的，所以還可以這樣寫

RealmResults<User> userList = mRealm.where(User.class)
            .equalTo("name", "Gavin")
            .equalTo("dogs.name", "二哈")
            .findAll();

是不是很清爽~~~

  • 更多查詢條件
    上面就展示了equalTo的用法。當然愁茁，查詢還有更多的用法蚕钦，我就不一一示例了。已知的方法如下：
    sum()：對指定字段求和鹅很。
    average()：對指定字段求平均值嘶居。
    min(): 對指定字段求最小值。
    max() : 對指定字段求最大值促煮。count : 求結(jié)果集的記錄數(shù)量邮屁。
    findAll(): 返回結(jié)果集所有字段，返回值為RealmResults隊列
    findAllSorted() : 排序返回結(jié)果集所有字段污茵，返回值為RealmResults隊列
    between(), greaterThan(),lessThan(), greaterThanOrEqualTo() & lessThanOrEqualTo()
    equalTo() & notEqualTo()
    contains(), beginsWith() & endsWith()
    isNull() & isNotNull()
    isEmpty()& isNotEmpty()

  • RealmQuery以及or的使用
    在使用where()方法時樱报，能得到一個RealmQuery對象，使用方法如下：
    例：查詢name為“Gavin”和“Eric”的用戶

RealmQuery<User> query = mRealm.where(User.class);
query.equalTo("name", "Gavin");
query.or().equalTo("name", "Eric");
RealmResults<User> userList = query.findAll();

這種情況下就要用到or()方法
這么一大串泞当，你又覺得麻煩了迹蛤？沒事，繼續(xù)簡化襟士。

RealmResults<User> userList = mRealm.where(User.class)
            .equalTo("name", "Gavin")
            .or().equalTo("name", "Eric")
            .findAll();

Tip：查詢的時候你不用當心得到的RealmResults為null盗飒。如果查詢的結(jié)果為空，那么RealmResults的size為0

  • 排序
    查詢結(jié)束后陋桂，還可以進行排序逆趣，就像這樣：
RealmResults<User> userList = mRealm.where(User.class) .findAll();
userList = result.sort("age"); //根據(jù)age，正序排列
userList = result.sort("age", Sort.DESCENDING);//逆序排列
  • 聚合
    RealmResult自帶一些聚合方法：
RealmResults<User> results = realm.where(User.class).findAll();
long   sum     = results.sum("age").longValue();
long   min     = results.min("age").longValue();
long   max     = results.max("age").longValue();
double average = results.average("age");
long   matches = results.size();

改

mRealm.executeTransaction(new Realm.Transaction() {
    @Override
    public void execute(Realm realm) {
        //先查找后得到User對象
        User user = mRealm.where(User.class).findFirst();
        user.setAge(26);
    }
});

修改也是需要在事務(wù)中操作嗜历。
使用查詢語句得到數(shù)據(jù)宣渗，然后將內(nèi)容改了即可。

刪

  • 使用deleteFromRealm() 
//先查找到數(shù)據(jù)
final RealmResults<User> userList = mRealm.where(User.class).findAll();
mRealm.executeTransaction(new Realm.Transaction() {
    @Override
    public void execute(Realm realm) {
        userList.get(0).deleteFromRealm();
    }
});
  • 使用deleteFromRealm(int index) 
mRealm.executeTransaction(new Realm.Transaction() {
    @Override
    public void execute(Realm realm) {
        userList.deleteFromRealm(0);
    }
});
  • 更多方法：
userList.deleteFirstFromRealm(); //刪除user表的第一條數(shù)據(jù)
userList.deleteLastFromRealm();//刪除user表的最后一條數(shù)據(jù)
results.deleteAllFromRealm();//刪除user表的全部數(shù)據(jù)

版本升級

當數(shù)據(jù)結(jié)構(gòu)發(fā)生變化是梨州，需要升級數(shù)據(jù)庫痕囱。對于Realm來說，數(shù)據(jù)庫升級就是遷移操作暴匠，把原來的數(shù)據(jù)庫遷移到新結(jié)構(gòu)的數(shù)據(jù)庫鞍恢。（體驗：略麻煩）

  • 例1：User類發(fā)生變化，移除age每窖，新增個@Required的id字段帮掉。
    User版本：version 0
String name;
int    age;

User版本：version 1

@Required
String    id;
String name;

創(chuàng)建遷移類CustomMigration，需要實現(xiàn)RealmMigration接口窒典。執(zhí)行版本升級時的處理：

    /**
     * 升級數(shù)據(jù)庫
     */
    class CustomMigration implements RealmMigration {
        @Override
        public void migrate(DynamicRealm realm, long oldVersion, long newVersion) {
            RealmSchema schema = realm.getSchema();
            if (oldVersion == 0 && newVersion == 1) {
                RealmObjectSchema personSchema = schema.get("User");
                //新增@Required的id
                personSchema
                        .addField("id", String.class, FieldAttribute.REQUIRED)
                        .transform(new RealmObjectSchema.Function() {
                            @Override
                            public void apply(DynamicReal
mObject obj) {
                                obj.set("id", "1");//為id設(shè)置值
                            }
                        })
                        .removeField("age");//移除age屬性
                oldVersion++;
            }
        }
    }

使用Builder.migration升級數(shù)據(jù)庫蟆炊，將版本號改為1（原版本號：0）。當Realm發(fā)現(xiàn)新舊版本號不一致時瀑志，會自動使用該遷移類完成遷移操作盅称。

RealmConfiguration config = new RealmConfiguration.Builder() 
            .name("myrealm.realm") //文件名
            .schemaVersion(1) 
            .migration(new CustomMigration())//升級數(shù)據(jù)庫
            .build();
  • 例2：加入Dog類肩祥，User中加入Dog集合。
    User版本：version 1
@Required
String    id;
String name;

User版本：version 2

@Required
private String id;
private String name;
private RealmList<Dog> dogs;

Dog類

public class Dog extends RealmObject {
        private String name;
        private int age;
}

在遷移類CustomMigration中缩膝，繼續(xù)添加處理方法混狠。

            if (oldVersion == 1 && newVersion == 2) {
                //創(chuàng)建Dog表
                RealmObjectSchema dogSchema = schema.create("Dog");
                dogSchema.addField("name", String.class);
                dogSchema.addField("age", int.class);

                //User中添加dogs屬性
                schema.get("User")
                        .addRealmListField("dogs", dogSchema)
                        .transform(new RealmObjectSchema.Function() {
                            @Override
                            public void apply(DynamicRealmObject obj) {
                                //為已存在的數(shù)據(jù)設(shè)置dogs數(shù)據(jù)
                                DynamicRealmObject dog = realm.createObject("Dog");
                                dog.set("name", "二哈");
                                dog.set("age", 2);
                                obj.getList("dogs").add(dog);
                            }
                        });
                oldVersion++;
            }
  • 更多用法——RealmObjectSchema
    例：取消id必填：
personSchema.setNullable("id", true):

例：移除id字段

personSchema.removeField("id");

例：重命名

personSchema..renameField("id", "userId");
  • 更多用法——DynamicRealmObject
    例：獲取id
String id = obj.getString("id");

例：為字段設(shè)置值

obj.setString("name", "Gavin");
obj.setInt("id", 1);
obj.setLong("id", 1);

疑問：我在debug時發(fā)現(xiàn)這樣的數(shù)據(jù)，如圖：

userList

什么疾层，dogs将饺、id、name的值怎么都是null痛黎？這~~
開始我還以為升級時數(shù)據(jù)丟失予弧，不過在圖中userList第0條數(shù)據(jù)的右邊看到了我的數(shù)據(jù)，于是我展開了里面的內(nèi)容湖饱，如圖：
展開后的userListg

好吧掖蛤，他并不是我想象中的那種存法，我已經(jīng)不知道他內(nèi)部是怎么實現(xiàn)的了井厌。（還望大神賜教）

加密

（官方原文）
Realm 文件可以通過傳遞一個512位（64字節(jié)）的密鑰參數(shù)給 Realm.getInstance().encryptionKey() 來加密存儲在磁盤上蚓庭。

byte[] key = new byte[64];
new SecureRandom().nextBytes(key);
RealmConfiguration config = new RealmConfiguration.Builder()
  .encryptionKey(key)
  .build();
Realm realm = Realm.getInstance(config);

保證了所有永久性存儲在磁盤上的數(shù)據(jù)都是通過標準 AES-256 加密的。每次創(chuàng)建新的 Realm 實例的時候仅仆，都需要提供相同的密鑰器赞。
參考 examples/encryptionExample。這個例子演示了如何通過 Android KeyStore 來安全地存儲密鑰墓拜。

適配器（Adapter）

（官方原文）
Realm提供了一些抽象的工具類來方便地將 OrderedRealmCollection
（RealmResults和 RealmList 都實現(xiàn)了這個借口）展示到UI控件上港柜。

  • RealmBaseAdapter 可以與ListView配合使用。參見示例.
  • RealmRecyclerViewAdapter可以與 RecyclerView配合使用咳榜。參見示例.

你需要在 app 的 build.gradle中添加額外的依賴以使用這些適配器夏醉。

dependencies {
    compile 'io.realm:android-adapters:1.4.0'
}

Intents

（官方原文）
你不可以直接通過 intent傳遞 RealmObject，建議你只傳遞RealmObject的標識符涌韩。舉個常用例子畔柔，假如你的對象擁有一個主鍵，請通過intent 的 bundle 來傳遞這個主鍵的值贸辈。

// Assuming we had a person class with a @PrimaryKey on the 'id' field ...
Intent intent = new Intent(getActivity(), ReceivingService.class);
intent.putExtra("person_id", person.getId());
getActivity().startService(intent);

在接受方（Activity释树、Service肠槽、IntentService擎淤、BroadcastReceiver及其它）從 bundle中解析出這個主鍵然后打開Realm 查詢得到這個 RealmObject。

// in onCreate(), onHandleIntent(), etc.
String personId = intent.getStringExtra("person_id");
Realm realm = Realm.getDefaultInstance();
Person person = realm.where(Person.class).equalTo("id", personId).findFirst();// do something with the person ...
realm.close();

可以參考 threading example 中的 Object Passing部分秸仙。該示例展示了在安卓開發(fā)中常用的如何傳遞 id 并且得到對應(yīng)的 RealmObject嘴拢。

RxJava

對于這么火的RxJava，Realm又怎么會放過他寂纪。
Realm 包含了對 RxJava 的原生支持席吴。如下類可以被暴露為一個 Observable：Realm, RealmResults, RealmObject, DynamicRealm 和 DynamicRealmObject赌结。
（直接用一個官方的例子）

Realm realm = Realm.getDefaultInstance();
GitHubService api = retrofit.create(GitHubService.class);
realm.where(Person.class).isNotNull("username").findAllAsync().asObservable()
    .filter(persons.isLoaded)
    .flatMap(persons -> Observable.from(persons))
    .flatMap(person -> api.user(person.getGithubUserName())
    .observeOn(AndroidSchedulers.mainThread())
    .subscribe(user -> showUser(user));

這里使用asObservable輕松轉(zhuǎn)換成RxJava中的Observable，使用.filter(persons.isLoaded)來判斷是否已查詢完成孝冒。到這里柬姚，熟悉RxJava的同學(xué)應(yīng)該已經(jīng)看明白了~~∽校可能還有人會一臉懵逼量承，->? 這是什么鬼？哈哈穴店，這叫Lambda撕捍，有時間可以去看看。

也許還有很多同學(xué)不了解RxJava泣洞，這里極力推薦給 Android 開發(fā)者的 RxJava 詳解忧风。

終于寫完了~~~說好易用的，沒想到內(nèi)容居然這么多球凰。

源碼地址

GitHub

參考資料

官方文檔
GitHub
Realm for Android快速入門教程
Android開發(fā)筆記（八十五）手機數(shù)據(jù)庫Realm
在Android加入和使用Realm
Android 進階之第三方庫的介紹 Realm [一] 基礎(chǔ)用法

以上有錯誤之處狮腿，感謝指出

最后編輯于 ：
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 人面猴
    序言：七十年代末，一起剝皮案震驚了整個濱河市弟蚀，隨后出現(xiàn)的幾起案子蚤霞，更是在濱河造成了極大的恐慌，老刑警劉巖义钉，帶你破解...
    沈念sama閱讀 206,968評論 6贊 482
  • 死咒
    序言：濱河連續(xù)發(fā)生了三起死亡事件昧绣，死亡現(xiàn)場離奇詭異，居然都是意外死亡捶闸，警方通過查閱死者的電腦和手機夜畴，發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,601評論 2贊 382
  • 救了他兩次的神仙讓他今天三更去死
    文/潘曉璐 我一進店門，熙熙樓的掌柜王于貴愁眉苦臉地迎上來删壮，“玉大人贪绘，你說我怎么就攤上這事⊙氲” “怎么了税灌？”我有些...
    開封第一講書人閱讀 153,220評論 0贊 344
  • 道士緝兇錄：失蹤的賣姜人
    文/不壞的土叔 我叫張陵，是天一觀的道長亿虽。 經(jīng)常有香客問我菱涤，道長，這世上最難降的妖魔是什么洛勉？ 我笑而不...
    開封第一講書人閱讀 55,416評論 1贊 279
  • ?港島之戀（遺憾婚禮）
    正文 為了忘掉前任粘秆，我火速辦了婚禮，結(jié)果婚禮上收毫，老公的妹妹穿的比我還像新娘攻走。我一直安慰自己殷勘，他們只是感情好，可當我...
    茶點故事閱讀 64,425評論 5贊 374
  • 惡毒庶女頂嫁案：這布局不是一般人想出來的
    文/花漫 我一把揭開白布昔搂。 她就那樣靜靜地躺著玲销，像睡著了一般。 火紅的嫁衣襯著肌膚如雪摘符。 梳的紋絲不亂的頭發(fā)上痒玩，一...
    開封第一講書人閱讀 49,144評論 1贊 285
  • 城市分裂傳說
    那天，我揣著相機與錄音议慰，去河邊找鬼蠢古。 笑死，一個胖子當著我的面吹牛别凹，可吹牛的內(nèi)容都是我干的草讶。 我是一名探鬼主播，決...
    沈念sama閱讀 38,432評論 3贊 401
  • 雙鴛鴦連環(huán)套：你想象不到人心有多黑
    文/蒼蘭香墨 我猛地睜開眼炉菲，長吁一口氣：“原來是場噩夢啊……” “哼堕战！你這毒婦竟也來了？” 一聲冷哼從身側(cè)響起拍霜，我...
    開封第一講書人閱讀 37,088評論 0贊 261
  • 萬榮殺人案實錄
    序言：老撾萬榮一對情侶失蹤文虏，失蹤者是張志新（化名）和其女友劉穎诫硕，沒想到半個月后退敦，有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體叽掘，經(jīng)...
    沈念sama閱讀 43,586評論 1贊 300
  • ?護林員之死
    正文 獨居荒郊野嶺守林人離奇死亡，尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 36,028評論 2贊 325
  • ?白月光啟示錄
    正文 我和宋清朗相戀三年道偷，在試婚紗的時候發(fā)現(xiàn)自己被綠了缀旁。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 38,137評論 1贊 334
  • 活死人
    序言：一個原本活蹦亂跳的男人離奇死亡勺鸦，死狀恐怖并巍，靈堂內(nèi)的尸體忽然破棺而出，到底是詐尸還是另有隱情换途，我是刑警寧澤懊渡，帶...
    沈念sama閱讀 33,783評論 4贊 324
  • ?日本核電站爆炸內(nèi)幕
    正文 年R本政府宣布，位于F島的核電站军拟，受9級特大地震影響剃执，放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜吻谋，卻給世界環(huán)境...
    茶點故事閱讀 39,343評論 3贊 307
  • 男人毒藥：我在死后第九天來索命
    文/蒙蒙 一忠蝗、第九天 我趴在偏房一處隱蔽的房頂上張望现横。 院中可真熱鬧漓拾，春花似錦阁最、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,333評論 0贊 19
  • 一樁弒父案速种，背后竟有這般陰謀
    文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至低千，卻和暖如春配阵，著一層夾襖步出監(jiān)牢的瞬間，已是汗流浹背示血。 一陣腳步聲響...
    開封第一講書人閱讀 31,559評論 1贊 262
  • 情欲美人皮
    我被黑心中介騙來泰國打工棋傍， 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留，地道東北人难审。 一個月前我還...
    沈念sama閱讀 45,595評論 2贊 355
  • 代替公主和親
    正文 我出身青樓瘫拣，卻偏偏與公主長得像，于是被迫代替她去往敵國和親告喊。 傳聞我的和親對象是個殘疾皇子麸拄，可洞房花燭夜當晚...
    茶點故事閱讀 42,901評論 2贊 345

推薦閱讀更多精彩內(nèi)容

  • 作者：郭霖原文作者：帶心情去旅行原文地址：http://www.reibang.com/u/769d3d3a9d4...
    胡二囧閱讀 1,467評論 0贊 1
  • 目錄 Getting StartedGetting HelpModelsRelationshipsWritesQu...
    Jafir閱讀 8,186評論 2贊 4
  • Spring Cloud為開發(fā)人員提供了快速構(gòu)建分布式系統(tǒng)中一些常見模式的工具（例如配置管理，服務(wù)發(fā)現(xiàn)黔姜，斷路器拢切，智...
    卡卡羅2017閱讀 134,601評論 18贊 139
  • Realm 一個跨平臺移動數(shù)據(jù)庫引擎 資料 Github 官網(wǎng) 說明文檔 中文說明文檔1.0.0 stetho 官...
    雨林雨林閱讀 4,814評論 2贊 13
  • 如何將圖畫成在black and white的背景下更好讀而不會丟失過多信息的策略之一：使用scale_fill_...
    zouxiaoyu閱讀 13,215評論 0贊 0