Android Realm数据库使用(1)

本文面向Android开发, 所以只讨论Java实现.

目前Realm Java的最新版本是2.3.1.

官方文档在此: realm java doc, 花一个下午就可以基本过一遍, 之后随时查用.

我写了一个小程序TodoRealm, 使用Realm做数据库实现的一个To-do应用, 在实际使用的过程中也有一些发现.

本文是我自己看文档的时候的一些记录, 有一些实际使用时的发现也穿插在对应的章节了.

Setup

---

在项目的根build.gradle的文件中添加:

buildscript {

repositories {

jcenter()

}

dependencies {

classpath “io.realm:realm-gradle-plugin:2.3.0”

}

}

然后在app的build.gradle文件中添加:

apply plugin: ‘realm-android’

Done.

Models

---

Model类只要继承RealmObject即可.

public class User extends RealmObject { private String name; private int age; @Ignore private int sessionId; // Standard getters & setters generated by your IDE… 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 int getSessionId() { return sessionId; } public void setSessionId(int sessionId) { this.sessionId = sessionId; } }

字段类型

Model类中可以包含的字段类型包括基本数据类型(及它们的装箱类型)和Date类, 另外也可以包含RealmObject的子类或者是RealmList<? extends RealmObject>.

字段性质

在字段上加注解可以定义字段的性质:

@Required表明字段非null.

原生类型和RealmList类型默认是非null的.

RealmObject字段永远是可以为null的.

@Ignore表示字段不会被存储.

@Index加索引.

@PrimaryKey加主键, 主键只能有一个, 主键默认加索引.

但是注意主键默认没有加@Required, 如果主键要求非null, 需要显式添加@Required.

主键使用

有主键才能使用copyToRealmOrUpdate()这个方法.

主键类型必须是String或者整型(byte, short, int, long)或者它们的装箱类型(Byte, Short, Integer, Long).

有主键的对象创建的时候不能使用createObject(Class<E> clazz)方法, 而应该使用createObject(Class<E> clazz, Object primaryKeyValue)附上主键.

或者用

copyToRealm(obj)或copyToRealmOrUpdate(obj), 前者遇到主键冲突时会崩溃, 后者遇到主键冲突会更新已有对象.

自动更新的对象

Realm中的数据对象是自动更新(Auto-Updating)的, 对象一旦被查询出来, 后续发生的任何数据改变也会立即反映在结果中, 不需要刷新对象.

这是一个非常有用的特性, 结合数据变化的通知可以很方便地刷新UI.

关系

–

Realm model对象间可以很方便地建立关系.

你可以在Model中存储另一个对象的引用, 建立多对一的关系; 也可以存储一组对象RealmList<T>, 建立一对多或多对多的关系.

RealmList<T>的getter永远也不会返回null, 它只会返回一个为空的list.

把这个字段设置为null可以清空这个list.

初始化

---

Realm在使用之前需要调用初始化:

Realm.init(context);

建议把它放在Application的onCreate()里.

配置

配置类: RealmConfiguration定义了Realm的创建配置.

最基本的配置:

RealmConfiguration config = new RealmConfiguration.Builder().build();

它会创建一个叫default.realm的文件, 放在Context.getFilesDir()的目录下.

如果我们想自定义一个配置, 可以这样写:

// The RealmConfiguration is created using the builder pattern. // The Realm file will be located in Context.getFilesDir() with name “myrealm.realm” RealmConfiguration config = new RealmConfiguration.Builder() .name(“myrealm.realm”) .encryptionKey(getKey()) .schemaVersion(42) .modules(new MySchemaModule()) .migration(new MyMigration()) .build(); // Use the config Realm realm = Realm.getInstance(config);

所以我们是可以有多个配置, 访问多个Realm实例的.

我们可以把配置设置为默认配置:

Realm.init(this); RealmConfiguration config = new RealmConfiguration.Builder().build(); Realm.setDefaultConfiguration(config);

之后用Realm.getDefaultInstance()取到的就是这个默认配置对应的实例.

数据库迁移

---

迁移的策略是通过config指定的:

RealmConfiguration config = new RealmConfiguration.Builder() .schemaVersion(2) // Must be bumped when the schema changes .migration(new MyMigration()) // Migration to run instead of throwing an exception .build()

其中MyMigration实现了RealmMigration接口, 在migrate()方法中根据新旧版本号进行一步一步地升级.

具体例子见Migration.

开发的时候为了方便我用的是.deleteRealmIfMigrationNeeded(), 这样在需要数据库迁移的时候直接就删了数据重新开始了.

关于Realm的close()

---

一个打开的Realm实例会持有一些资源, 有一些是Java不能自动管理的, 所以就需要打开实例的代码负责在不需要的时候将其关闭.

Realm的instance是引用计数的(reference counted cache), 在同一个线程中获取后续实例是免费的, 但是底层的资源只有当所有实例被释放了之后才能释放. 也即你调用了多少次getInstance(), 就需要调用相应次数的close()方法.

比较建议的方法是在Activity或Fragment的生命周期中处理Realm实例的开启和释放:

• 在Activity的onCreate()中getInstance(), onDestroy()中close().

• 在Fragment的onCreateView()中getInstance(), onDestroyView()中close().

如果多个Fragment相关的都是同一个数据库实例, 那么在Activity中处理更好一些.

写

写操作一般的流程是这样:

// Obtain a Realm instance Realm realm = Realm.getDefaultInstance(); realm.beginTransaction(); //… add or update objects here … realm.commitTransaction();

这里创建对象可以用createObject()方法或者copyToRealm()方法.

前者是先创建再set值, 后者是先new对象再更新数据库.

如果不想自己处理beginTransaction(), cancelTransaction()和commitTransaction(), 可以直接调用realm.executeTransaction()方法:

realm.executeTransaction(new Realm.Transaction() { @Override public void execute(Realm realm) { User user = realm.createObject(User.class); user.setName(“John”); user.setEmail(“john@corporation.com”); } });

异步

因为transactions之间是互相阻塞的.

异步执行可以用这个方法:

realm.executeTransactionAsync(new Realm.Transaction() { @Override public void execute(Realm bgRealm) { User user = bgRealm.createObject(User.class); user.setName(“John”); user.setEmail(“john@corporation.com”); } }, new Realm.Transaction.OnSuccess() { @Override public void onSuccess() { // Transaction was a success. } }, new Realm.Transaction.OnError() { @Override public void onError(Throwable error) { // Transaction failed and was automatically canceled. } });

这两个回调是Optional的, 它们只能在有Looper的线程调用.

注意: 这个方法的返回值对象可以用于在Activity/Fragment生命周期结束的时候取消未完的操作.

删除和更新

所有的写操作都要放在transaction中进行, 如上, 不同的操作只是其中具体方法不同.

删除操作:

final RealmResults users = getUsers(); // method 1: users.get(0).deleteFromRealm(); // method 2: users.deleteFromRealm(0); // delete all users.deleteAllFromRealm();

更新操作:

realm.copyToRealmOrUpdate(obj);

注意: 这个方法需要Model有主键, 会更新obj的主键对应的对象, 如果不存在则新建对象.

查询

–

查询可以流式地写:

// Or alternatively do the same all at once (the “Fluent interface”): RealmResults result2 = realm.where(User.class) .equalTo(“name”, “John”) .or() .equalTo(“name”, “Peter”) .findAll();

查询条件默认是and的关系, or则需要显式指定.

这个RealmResults是继承Java的AbstractList的, 是有序的集合, 可以通过索引访问.

RealmResults永远不会为null, 当查不到结果时, 它的size()返回0.

查询的线程

基本上所有的查询都是很快进行的, 足够在UI线程上同步进行.

所以绝大多数情况在UI线程上使用findAll()是没有问题的.

如果你要进行非常复杂的查询, 或者你的查询是在非常大的数据集上进行的, 你可以选择异步查询, 使用findAllAsync().
自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数初中级Android工程师，想要提升技能，往往是自己摸索成长或者是报班学习，但对于培训机构动则近万的学费，着实压力不小。自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！

因此收集整理了一份《2024年Android移动开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上Android开发知识点，真正体系化！

由于文件比较大，这里只是将部分目录截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新！

如果你觉得这些内容对你有帮助，可以扫码获取！！（备注：Android）

小福利：

在当下这个碎片化信息环境的时代，很多资源都可以在网络上找到，只取决于你愿不愿意找或是找的方法对不对了

很多朋友不是没有资料，大多都是有几十上百个G，但是杂乱无章，不知道怎么看从哪看起，甚至是看后就忘

如果大家觉得自己在网上找的资料非常杂乱、不成体系的话，我也分享一套给大家，比较系统，我平常自己也会经常研读。

2021大厂最新Android面试真题解析

各个模块学习视频：如数据结构与算法

只有系统，有方向的学习，才能在段时间内迅速提高自己的技术。

这份体系学习笔记，适应人群：**第一，**学习知识比较碎片化，没有合理的学习路线与进阶方向。**第二，**开发几年，不知道如何进阶更进一步，比较迷茫。第三，到了合适的年纪，后续不知道该如何发展，转型管理，还是加强技术研究。如果你有需要，我这里恰好有为什么，不来领取！说不定能改变你现在的状态呢！点赞+评论即可获得！

《互联网大厂面试真题解析、进阶开发核心学习笔记、全套讲解视频、实战项目源码讲义》点击传送门即可获取！

723425375)]

各个模块学习视频：如数据结构与算法

[外链图片转存中…(img-cUKg0i3H-1713723425377)]

只有系统，有方向的学习，才能在段时间内迅速提高自己的技术。
[外链图片转存中…(img-ZxYaONGQ-1713723425378)]

[外链图片转存中…(img-GwlIEg5y-1713723425379)]

这份体系学习笔记，适应人群：**第一，**学习知识比较碎片化，没有合理的学习路线与进阶方向。**第二，**开发几年，不知道如何进阶更进一步，比较迷茫。第三，到了合适的年纪，后续不知道该如何发展，转型管理，还是加强技术研究。如果你有需要，我这里恰好有为什么，不来领取！说不定能改变你现在的状态呢！点赞+评论即可获得！

《互联网大厂面试真题解析、进阶开发核心学习笔记、全套讲解视频、实战项目源码讲义》点击传送门即可获取！