Realm 移動 輕量級數據庫框架

首先 大家對SQLiteOpenHelper 這個類并不陌生 ，伴隨著 你需要有DAO類 包括IMPL實現類！

SQLiteOpenHelper 涉及到創建表 數據庫升級 ，數據庫加密 ，數據的增刪改查等。。。 sqllite 的多表聯查 左鏈接 等等

數據庫Realm，是用來替代sqlite的一種解決方案！

它有一套自己的數據庫存儲引擎，比sqlite更輕量級，擁有更快的速度，并且具有很多現代數據庫的特性，比如支持JSON，流式api，數據變更通知，自動數據同步,簡單身份驗證，訪問控制，事件處理，最重要的是跨平臺，目前已有Java，Objective C，Swift，React-Native，Xamarin這五種實現，但是他也有自己的缺點 例如 不能多表聯查。。

不過我們主要來講講風靡中的Realm 框架 是如何使用的！

環境配置

  • 在項目的build文件加上
buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath "io.realm:realm-gradle-plugin:2.0.2"
    }
}
  • app的build 文件加上
apply plugin: 'realm-android'
  • application 自定義配置
    .schemaVersion(1) 設置一個版本號，如果沒設置，默認是0
    .encryptionKey() 數據庫加密
    .deleteRealmIfMigrationNeeded() 遷移方案的一種，當數據庫結構改變時，刪除原數據庫中的所有數據， 這在debug版本的時候非常有用，一旦應用上線，需要保留原數據數據，這個方案就不適用了。
    .migration() 指定一個遷移方案，如果應用上線之后，數據庫結構需要發生改變，可以通過配置Migration來解決，用于將原數據庫中的數據遷移到新數據庫中。
public class MyApplication extends Application {
  @Override
  public void onCreate() {
    super.onCreate();
    Realm.init(this);
    RealmConfiguration config = new  RealmConfiguration.Builder()
                                         .name("myRealm.realm")
                                         .deleteRealmIfMigrationNeeded()
                                         .build();
    Realm.setDefaultConfiguration(config);
  }
}
  • 創建實體
public class Dog 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;
    }
}

再往下 我們就說 增刪改查的各個用法

  • 增

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

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

Realm realm=Realm.getDefaultInstance();

realm.beginTransaction();
User user = realm.createObject(User.class); // Create a new object
user.setName("John");
user.setEmail("john@corporation.com");
realm.commitTransaction();

類型二：復制一個對象到Realm數據庫

Realm realm=Realm.getDefaultInstance();

User user = new User("John");
user.setEmail("john@corporation.com");

// Copy the object to Realm. Any further changes must happen on realmUser
realm.beginTransaction();
realm.copyToRealm(user);
realm.commitTransaction();

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

Realm  mRealm=Realm.getDefaultInstance();

final User user = new User("John");
user.setEmail("john@corporation.com");

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

            realm.copyToRealm(user);

            }
        });
  • 刪
    同樣也可以使用同上的beginTransaction和commitTransaction方法進行刪除
 Realm  mRealm=Realm.getDefaultInstance();

    final RealmResults<Dog> dogs=  mRealm.where(Dog.class).findAll();

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

                Dog dog=dogs.get(5);
                dog.deleteFromRealm();
                //刪除第一個數據
                dogs.deleteFirstFromRealm();
                //刪除最后一個數據
                dogs.deleteLastFromRealm();
                //刪除位置為1的數據
                dogs.deleteFromRealm(1);
                //刪除所有數據
                dogs.deleteAllFromRealm();
            }
        });
  • 改
    同樣也可以用事物塊來更新數據
Realm  mRealm=Realm.getDefaultInstance();

Dog dog = mRealm.where(Dog.class).equalTo("id", id).findFirst();
mRealm.beginTransaction();
dog.setName(newName);
mRealm.commitTransaction();
  • 查
    （1）查詢全部
    查詢結果為RealmResults<T>，可以使用mRealm.copyFromRealm(dogs)方法將它轉為List<T>
 public List<Dog> queryAllDog() {
        Realm  mRealm=Realm.getDefaultInstance();

        RealmResults<Dog> dogs = mRealm.where(Dog.class).findAll();

        return mRealm.copyFromRealm(dogs);
    }

（2）條件查詢

 public Dog queryDogById(String id) {
        Realm  mRealm=Realm.getDefaultInstance();

        Dog dog = mRealm.where(Dog.class).equalTo("id", id).findFirst();
        return dog;
    }

（3）對查詢結果進行排序

/**
     * query （查詢所有）
     */
    public List<Dog> queryAllDog() {
        RealmResults<Dog> dogs = mRealm.where(Dog.class).findAll();
        /**
         * 對查詢結果，按Id進行排序，只能對查詢結果進行排序
         */
        //增序排列
        dogs=dogs.sort("id");
        //降序排列
        dogs=dogs.sort("id", Sort.DESCENDING);
        return mRealm.copyFromRealm(dogs);
    }

（4）其他查詢
sum，min，max，average只支持整型數據字段

/**
     *  查詢平均年齡
     */
    private void getAverageAge() {
         double avgAge=  mRealm.where(Dog.class).findAll().average("age");
    }

    /**
     *  查詢總年齡
     */
    private void getSumAge() {
      Number sum=  mRealm.where(Dog.class).findAll().sum("age");
        int sumAge=sum.intValue();
    }

    /**
     *  查詢最大年齡
     */
    private void getMaxId(){
      Number max=  mRealm.where(Dog.class).findAll().max("age");
        int maxAge=max.intValue();
    }

異步操作

大多數情況下，Realm的增刪改查操作足夠快，可以在UI線程中執行操作。但是如果遇到較復雜的增刪改查，或增刪改查操作的數據較多時，就可以子線程進行操作

（1）異步增：

 private void addCat(final Cat cat) {
      RealmAsyncTask  addTask=  mRealm.executeTransactionAsync(new Realm.Transaction() {
            @Override
            public void execute(Realm realm) {
                realm.copyToRealm(cat);
            }
        }, new Realm.Transaction.OnSuccess() {
            @Override
            public void onSuccess() {
                ToastUtil.showShortToast(mContext,"收藏成功");
            }
        }, new Realm.Transaction.OnError() {
            @Override
            public void onError(Throwable error) {
                ToastUtil.showShortToast(mContext,"收藏失敗");
            }
        });

    }

最后在銷毀Activity或Fragment時，要取消掉異步任務

@Override
    protected void onDestroy() {
        super.onDestroy();
       if (addTask!=null&&!addTask.isCancelled()){
            addTask.cancel();
        }
    }

（2）異步刪

 private void deleteCat(final String id, final ImageView imageView){
      RealmAsyncTask  deleteTask=   mRealm.executeTransactionAsync(new Realm.Transaction() {
            @Override
            public void execute(Realm realm) {
                Cat cat=realm.where(Cat.class).equalTo("id",id).findFirst();
                cat.deleteFromRealm();

            }
        }, new Realm.Transaction.OnSuccess() {
            @Override
            public void onSuccess() {
                ToastUtil.showShortToast(mContext,"取消收藏成功");
            }
        }, new Realm.Transaction.OnError() {
            @Override
            public void onError(Throwable error) {
                ToastUtil.showShortToast(mContext,"取消收藏失敗");
            }
        });

    }

最后在銷毀Activity或Fragment時，要取消掉異步任務

@Override
    protected void onDestroy() {
        super.onDestroy();
       if (deleteTask!=null&&!addTask.isCancelled()){
            deleteTask.cancel();
        }
    }

（3）異步改

RealmAsyncTask  updateTask=   mRealm.executeTransactionAsync(new Realm.Transaction() {
            @Override
            public void execute(Realm realm) {
                Cat cat=realm.where(Cat.class).equalTo("id",mId).findFirst();
                cat.setName(name);
            }
        }, new Realm.Transaction.OnSuccess() {
            @Override
            public void onSuccess() {
                ToastUtil.showShortToast(UpdateCatActivity.this,"更新成功");

            }
        }, new Realm.Transaction.OnError() {
            @Override
            public void onError(Throwable error) {
                ToastUtil.showShortToast(UpdateCatActivity.this,"失敗成功");
            }
        });

最后在銷毀Activity或Fragment時，要取消掉異步任務

@Override
    protected void onDestroy() {
        super.onDestroy();
       if (updateTask!=null&&!addTask.isCancelled()){
            updateTask.cancel();
        }
    }

（4）異步查

 RealmResults<Cat>   cats=mRealm.where(Cat.class).findAllAsync();
        cats.addChangeListener(new RealmChangeListener<RealmResults<Cat>>() {
            @Override
            public void onChange(RealmResults<Cat> element) {
               element= element.sort("id");
                List<Cat> datas=mRealm.copyFromRealm(element);

            }
        });

最后在銷毀Activity或Fragment時，要取消掉異步任務

@Override
    protected void onDestroy() {
        super.onDestroy();
        cats.removeChangeListeners();

    }

其他相關說明
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為這個字段添加一個搜索引擎，這將使插入數據變慢、數據增大，但是查詢會變快。建議在需要優化讀取性能的情況下使用。

推薦文章 涉及到Realm 加密 升級
轉 載 自： http://www.lxweimin.com/p/28912c2f31db
Demo地址：https://github.com/RaphetS/DemoRealm
歡迎加入android QQ群：104286694

最后編輯于 ：
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明：文章內容（如有圖片或視頻亦包括在內）由作者上傳并發布，文章內容僅代表作者本人觀點，簡書系信息發布平臺，僅提供信息存儲服務。

推薦閱讀更多精彩內容