realm大致使用

Realm大致使用：

一、Realm簡介

數據庫Realm，是用來替代sqlite的一種解決方案，它有一套自己的數據庫存儲引擎，比sqlite更輕量級，擁有更快的速度，並且具有很多現代數據庫的特性，比如支持JSON，流式api，數據變更通知，自動數據同步,簡單身份驗證，訪問控制，事件處理，並且在github上擁有極多star
本篇文章用的版本爲Realm 2.0.2(官方文檔)

二、環境配置

（1） 在項目的build文件加上

buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath "io.realm:realm-gradle-plugin:2.0.2"
    }
}

（2） 在app的build文件加上

apply plugin: 'realm-android'

三、初始化Realm

（1） 在Application的oncreate()方法中Realm.init()

public class MyApplication extends Application {
  @Override
  public void onCreate() {
    super.onCreate();
    Realm.init(this);
  }
}

（2）在Application的oncreate()方法中對Realm進行相關配置
①使用默認配置

public class MyApplication extends Application {
  @Override
  public void onCreate() {
    super.onCreate();
    // The Realm file will be located in Context.getFilesDir() with name "default.realm"
    Realm.init(this);
    RealmConfiguration config = new RealmConfiguration.Builder().build();
    Realm.setDefaultConfiguration(config);
  }
}

②使用自定義配置

public class MyApplication extends Application {
  @Override
  public void onCreate() {
    super.onCreate();
    // The Realm file will be located in Context.getFilesDir() with name "default.realm"
    Realm.init(this);
    RealmConfiguration config = new RealmConfiguration.Builder().build();
    Realm.setDefaultConfiguration(config);
  }
}

（3）在AndroidManifest.xml配置自定義的Application

<application
  android:name=".MyApplication"
  ...
/>

四、創建實體

（1）新建一個類繼承RealmObject

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

    @PrimaryKey
    private String id;


    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;
    }

    public String getId() {
        return id;
    }

    public void setId(String id) {
        this.id = id;
    }
}

（2）其他相關說明
1、支持的數據類型：
boolean, byte, short, int, long, float, double, String, Date and byte[]
在Realm中byte, short, int, long最終都被映射成long類型

2、註解說明

@PrimaryKey
①字段必須是String、 integer、byte、short、 int、long 以及它們的封裝類Byte, Short, Integer, and Long

②使用了該註解之後可以使用copyToRealmOrUpdate()方法，通過主鍵查詢它的對象，如果查詢到了，則更新它，否則新建一個對象來代替。

③使用了該註解將默認設置@index註解

④使用了該註解之後，創建和更新數據將會慢一點，查詢數據會快一點。

@Required
數據不能爲null

@Ignore
忽略，即該字段不被存儲到本地

@Index
爲這個字段添加一個搜索引擎，這將使插入數據變慢、數據增大，但是查詢會變快。建議在需要優化讀取性能的情況下使用。

五、增

（1）實現方法一：事務操作

類型一 ：新建一個對象，並進行存儲

Realm realm=Realm.getDefaultInstance();

realm.beginTransaction();
Person person = realm.createObject(Person.class); // Create a new object
person.setName("John");
realm.commitTransaction();

類型二：複製一個對象到Realm數據庫

 Realm realm=Realm.getDefaultInstance();
Person person = new Person();
// Copy the object to Realm. Any further changes must happen on realmUser
realm.beginTransaction();
realm.copyToRealm(person);
realm.commitTransaction();

（2）實現方法二：使用事務塊

Realm  mRealm=Realm.getDefaultInstance();

final Person person = new Person();
person.setName("John");

mRealm.executeTransaction(new Realm.Transaction() {
            @Override
            public void execute(Realm realm) {

            realm.copyToRealm(user);

            }
        });

六、刪

    Realm  mRealm=Realm.getDefaultInstance();

    final RealmResults<Person> person=  mRealm.where(Person.class).findAll();

        mRealm.executeTransaction(new Realm.Transaction() {
            @Override
            public void execute(Realm realm) {
                person.deleteFromRealm();
                //刪除第一個數據
                person.deleteFirstFromRealm();
                //刪除最後一個數據
                person.deleteLastFromRealm();
                //刪除位置爲1的數據
                person.deleteFromRealm(1);
                //刪除所有數據
                person.deleteAllFromRealm();
            }
        });

同樣也可以使用同上的beginTransaction和commitTransaction方法進行刪除

七、改

Realm  mRealm=Realm.getDefaultInstance();

Person person = mRealm.where(Person.class).equalTo("id", id).findFirst();
mRealm.beginTransaction();
person.setName(newName);
mRealm.commitTransaction();

同樣也可以用事物塊來更新數據

八、查

（1）查詢全部

查詢結果爲RealmResults，可以使用mRealm.copyFromRealm(person)方法將它轉爲List

    public List<Person> queryAll() {
        Realm  mRealm=Realm.getDefaultInstance();

        RealmResults<Person> person = mRealm.where(Person.class).findAll();

        return mRealm.copyFromRealm(person);
    }

（2）條件查詢

   public Person queryPersonById(String id) {
        Realm  mRealm=Realm.getDefaultInstance();

        Person person = mRealm.where(Person.class).equalTo("id", id).findFirst();
        return person;
    }

常見的條件如下（詳細資料請查官方文檔）：

between(), greaterThan(), lessThan(), greaterThanOrEqualTo() & lessThanOrEqualTo()

equalTo() & notEqualTo()

contains(), beginsWith() & endsWith()

isNull() & isNotNull()

isEmpty() & isNotEmpty()