更简单的数据库:Realm For Android

作者: Android架构 | 来源:发表于2019-05-27 17:03 被阅读14次

    在Android开发中,经常会用到数据库操作,各种增删改查语句,烦不胜烦。今天介绍一款好用的数据库Realm,可以让数据库操作更加便捷。

    一、目录

    二、Realm简介

    数据库Realm,是用来替代sqlite的一种解决方案,它有一套自己的数据库存储引擎,比sqlite更轻量级,拥有更快的速度,并且具有很多现代数据库的特性,比如支持JSON,流式api,数据变更通知,自动数据同步,简单身份验证,访问控制,事件处理,最重要的是跨平台,目前已有Java,Objective C,Swift,React-Native,Xamarin这五种实现。

    优势

    易用

    Ream 不是在SQLite基础上的ORM,它有自己的数据查询引擎。并且十分容易使用。

    快速

    由于它是完全重新开始开发的数据库实现,所以它比任何的ORM速度都快很多,甚至比SLite速度都要快。

    跨平台

    Realm 支持 iOS & OS X (Objective‑C & Swift) & Android。我们可以在这些平台上共享Realm数据库文件,并且上层逻辑可以不用任何改动的情况下实现移植。

    高级

    Ream支持加密,格式化查询,易于移植,支持JSON,流式api,数据变更通知等高级特性

    可视化

    Realm 还提供了一个轻量级的数据库查看工具,在Mac Appstore 可以下载“Realm Browser”这个工具,开发者可以查看数据库当中的内容,执行简单的插入和删除数据的操作。

    三、环境配置

    (1) 在项目的build文件加上

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

    (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();
        Realm.init(this);
        RealmConfiguration config = new  RealmConfiguration.Builder()
                                             .name("myRealm.realm")
                                             .deleteRealmIfMigrationNeeded()
                                             .build();
        Realm.setDefaultConfiguration(config);
      }
    }
    
    

    (3)在AndroidManifest.xml配置自定义的Application

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

    五、创建实体

    (1)新建一个类继承RealmObject

    public class TimeInfo extends RealmObject {
            //年月日信息
            private String ymD;
            //标题
            private String title;
            //内容
            private String content;
            //时间段信息  12:00-13:00
            @PrimaryKey
            private String addTime;
            //创建该条目时的时间
            private String createTime;
            //是否是新的任务
            private boolean isNew = true;
            //在列表中所处位置
            private int position = -1;
           ................省略get,set方法
    }
    
    

    (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.增

    1)实现方法一:事务操作

    mRealm.beginTransaction();
    TimeInfo info= realm.createObject(TimeInfo.class); // Create a new object
    info.setTitle("realm");
    realm.commitTransaction();
    
    

    2)实现方法二:使用事务块

    mRealm.executeTransaction(new Realm.Transaction() {
                @Override
                public void execute(Realm realm) {
                    realm.copyToRealm(bean);
    
                }
            });
    
    

    2.查

    (1)查询全部

    RealmResults<? extends RealmObject> beans = mRealm.where(clazz).findAll();
    
    

    (2)条件查询

    RealmObject bean = mRealm.where(clazz).equalTo(fieldName, value).findFirst();
    
    

    常见的条件如下(详细资料请查官方文档):

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

    equalTo() & notEqualTo()

    contains(), beginsWith() & endsWith()

    isNull() & isNotNull()

    isEmpty() & isNotEmpty()

    (3)对查询结果进行排序

    RealmResults<? extends RealmObject> beans = mRealm.where(clazz).findAll();
    //升序排序
    RealmResults<? extends RealmObject> results = beans.sort(fieldName, Sort.ASCENDING);
    //降序排序
    RealmResults<? extends RealmObject> results = beans.sort(fieldName, Sort.DESCENDING);
    
    

    (4)其他查询
    sum,min,max,average只支持整型数据字段

        /**
         *  查询最大位置
         */
        private void getMaxPosition(){
          Number max=  mRealm.where(TimeInfo.class).findAll().max("position");
            int maxPosition=max.intValue();
        }
    
    

    其他使用类似

    3.删

     mRealm.executeTransaction(new Realm.Transaction() {
                @Override
                public void execute(Realm realm) {
    
                    //删除第一个数据
                    beans.deleteFirstFromRealm();
                    //删除最后一个数据
                     beans.deleteLastFromRealm();
                    //删除某个位置的数据
                  beans.deleteFromRealm(position);
                    //删除所有数据
                 beans.deleteAllFromRealm();
                }
            });
    
    

    4.改

    TimeInfo info= mRealm.where(TimeInfo.class).equalTo("position", position).findFirst();
    mRealm.beginTransaction();
    info.setPosition(newPosition);
    mRealm.commitTransaction();
    
    

    七、异步操作

    大多数情况下,Realm的增删改查操作足够快,可以在UI线程中执行操作。但是如果遇到较复杂的增删改查,或增删改查操作的数据较多时,就可以子线程进行操作。
    (1)异步增:

    RealmAsyncTask  addTask=  mRealm.executeTransactionAsync(new Realm.Transaction() {
                @Override
                public void execute(Realm realm) {
                    realm.copyToRealm(bean);
                }
            }, new Realm.Transaction.OnSuccess() {
                @Override
                public void onSuccess() {
                    ToastUtil.showShortToast(mContext,"添加成功");
                }
            }, new Realm.Transaction.OnError() {
                @Override
                public void onError(Throwable error) {
                    ToastUtil.showShortToast(mContext,"添加失败");
                }
            });
    
    

    (2)异步删

    RealmAsyncTask  deleteTask=   mRealm.executeTransactionAsync(new Realm.Transaction() {
                @Override
                public void execute(Realm realm) {
                    TimeInfo info =realm.where(TimeInfo.class).equalTo("position",position).findFirst();
                    info .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,"删除失败");
                }
            });
    
    

    (3)异步改

    RealmAsyncTask  updateTask=   mRealm.executeTransactionAsync(new Realm.Transaction() {
                @Override
                public void execute(Realm realm) {
                     TimeInfo info =realm.where(TimeInfo.class).equalTo("position",position).findFirst();
                    info .setPosition(position);
                }
            }, new Realm.Transaction.OnSuccess() {
                @Override
                public void onSuccess() {
                    ToastUtil.showShortToast(mContext,"更新成功");
    
                }
            }, new Realm.Transaction.OnError() {
                @Override
                public void onError(Throwable error) {
                    ToastUtil.showShortToast(mContext,"失败成功");
                }
            });
    
    

    (4)异步查

    RealmResults<TimeInfo>   infos=mRealm.where(TimeInfo.class).findAllAsync();
    infos.addChangeListener(new RealmChangeListener<RealmResults<TimeInfo>>() {
                @Override
                public void onChange(RealmResults<TimeInfo> element) {
                   //执行接收到查询结果数据
    
                }
            });
    
    

    注意:findAllAsync()立刻返回结果,结果为空。可以添加监听,当返回的结果集合infos变化时,会调用该方法。

    最后在销毁Activity或Fragment时,要取消掉异步任务,以及取消监听。
    @Override
        protected void onDestroy() {
            super.onDestroy();
           if (updateTask!=null&&!addTask.isCancelled()){
                updateTask.cancel();
            }
        }
    
    
    @Override
        protected void onDestroy() {
            super.onDestroy();
            infos.removeChangeListeners();
    
        }
    
    
    最后别忘了关掉Realm,防止内存泄漏。
    mRealm.close();
    
    

    八、封装使用

    定义一个RealmOperationHelper类,里面封装各种增删改查方法,方便我们直接调用。

    首先,把RealmOperationHelper设置为单例模式,使用静态内部类的方式。

        private static Realm mRealm;
    
        private static class SingletonHolder {
            private static RealmOperationHelper INSTANCE = new RealmOperationHelper(
                    mRealm);
        }
    
        private RealmOperationHelper(Realm realm) {
            this.mRealm = realm;
    
        }
    
        /**
         * 获取RealmOperation的单例
         *
         * @param realm 传入realm实例对象
         * @return 返回RealmOperation的单例
         */
        public static RealmOperationHelper getInstance(Realm realm) {
            if (realm != null) {
                mRealm = realm;
            }
            return SingletonHolder.INSTANCE;
        }
    
    

    封装各种增删改查操作,包括同步与异步。异步操作中,对onSuccess,onError方法回调的没有进行处理,实用性不好,后面进一步考虑。

    使用实例:

    RealmOperationHelper.getInstance(AppApplication.REALM_INSTANCE).add(info);
    
    

    RealmOperationHelper.getInstance(AppApplication.REALM_INSTANCE).deleteElement(TimeInfo.class,curPosition);
    
    

    异步查

    final RealmResults<TimeInfo> results = (RealmResults<TimeInfo>) RealmOperationHelper.getInstance(AppApplication.REALM_INSTANCE).queryAllAsync(TimeInfo.class);
    
            results.addChangeListener(new RealmChangeListener<RealmResults<TimeInfo>>() {
                @Override
                public void onChange(RealmResults<TimeInfo> element) {
                    //只要results改变就会回调,及时取消监听
                    results.removeAllChangeListeners();
                   //获取数据,更新UI。
                }
            });
    
    

    使用效果,很方便,很简洁。

    Realm封装工具类地址

    自己是从事了七年开发的Android工程师,不少人私下问我,2019年Android进阶该怎么学,方法有没有?

    没错,年初我花了一个多月的时间整理出来的学习资料,希望能帮助那些想进阶提升Android开发,却又不知道怎么进阶学习的朋友。【包括高级UI、性能优化、架构师课程、NDK、Kotlin、混合式开发(ReactNative+Weex)、Flutter等架构技术资料】,希望能帮助到您面试前的复习且找到一个好的工作,也节省大家在网上搜索资料的时间来学习。

    资料获取方式:加入Android架构交流QQ群聊:513088520 ,进群即领取资料!!!

    点击链接加入群聊【Android移动架构总群】:加入群聊

    资料大全

    相关文章

      网友评论

        本文标题:更简单的数据库:Realm For Android

        本文链接:https://www.haomeiwen.com/subject/tftozqtx.html