Realm 是一个 MVCC （多版本并发控制）数据库，由Y Combinator公司在2014年7月发布一款支持运行在手机、平板和可穿戴设备上的嵌入式数据库，目标是取代sqlite。
Realm 本质上是一个嵌入式数据库，他并不是基于sqlite所构建的。它拥有自己的数据库存储引擎，可以高效且快速地完成数据库的构建 *** 作。和sqlite不同，它允许你在持久层直接和数据对象工作。在它之上是一个函数式风格的查询API，众多的努力让它比传统的sqlite *** 作更快 。
详细介绍（如果进不去，看这个也行）
如果在在使用它时候，连它的优势在哪都不知道的话就有点说不过去了。
易用Ream 不是在sqlite基础上的ORM，它有自己的数据查询引擎。并且十分容易使用。快速
由于它是完全重新开始开发的数据库实现，所以它比任何的ORM速度都快很多，甚至比Slite速度都要快。跨平台
Realm 支持 iOS & OS X (Objective‑C & Swift) & AndroID。我们可以在这些平台上共享Realm数据库文件，并且上层逻辑可以不用任何改动的情况下实现移植。高级
Ream支持加密，格式化查询，易于移植，支持JsON，流式API，数据变更通知等高级特性可视化
Realm 还提供了一个轻量级的数据库查看工具，在Mac Appstore 可以下载“Realm browser”这个工具，开发者可以查看数据库当中的内容，执行简单的插入和删除数据的 *** 作。（windows上还不清楚）条件目前不支持
AndroID以外的JavaAndroID 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'创建modelRealm从v1.0.0后，不支持Ecilpse，我们推荐使用AndroID Studio
创建一个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 数据模型之外，还可以通过实现 RealmModel接口并添加 @RealmClass修饰符来声明。
@RealmClasspublic class User implements RealmModel { ...}boolean, byte, short,int,long,float, double,String, Date 和，byte[], RealmObject, RealmList<? extends RealmObject>还支持
Boolean, Byte, Short, Integer, Long, float 和 DoubleTip：整数类型
short、int 和 long 都被映射到 Realm 内的相同类型（实际上为 long ）@PrimaryKey——表示该字段是主键使用过数据库的同学应该看出来了，
PrimaryKey就是主键。使用@PrimaryKey来标注，字段类型必须是字符串（String）或整数（byte，short，int或long）以及它们的包装类型（Byte,Short, Integer, 或 Long）。不可以存在多个主键，使用字符串字段作为主键意味着字段被索引（注释@PrimaryKey隐式地设置注释@Index）。@PrimaryKeyprivate String ID;@required——表示该字段非空在某些情况下，有一些属性是不能为
null的。使用@required可用于用于强行要求其属性不能为空，只能用于Boolean, Byte, Short, Integer, Long, float, Double, String, byte[] 和 Date。在其它类型属性上使用 @required修饰会导致编译失败。Tip：基本数据类型不需要使用注解
@required，因为他们本身就不可为空。@requiredprivate String name;@Ignore——表示忽略该字段被添加
@Ignore标签后，存储数据时会忽略该字段。@Ignoreprivate String name;@Index——添加搜索索引为字段添加搜索索引，这样会使得插入的速度变慢，数据量也变得更大。不过在查询速度将变得更快，建议只在优化读取性能的特定情况时添加索引。支持索引：
String，byte，short，int，long，boolean和Date字段。 > **注意**：如果你创建Model并运行过，然后修改了Model。那么就需要升级数据库，否则会抛异常。升级方式后面会提到### **初始化**使用默认配置```java Realm.init(this); Realm mRealm = Realm.getDefaultInstance();这时候会创建一个叫做 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);创建非持久化的Realm，也就是保持在内存中，应用关闭后就清除了。
RealmConfiguration myConfig = new RealmConfiguration.Builder(context) .name("myrealm.realm")//保存在内存中 .inMemory() .build();RealmConfiguration支持的方法：
Builder.name : 指定数据库的名称。如不指定默认名为default。Builder.schemaVersion : 指定数据库的版本号。Builder.encryptionKey : 指定数据库的密钥。Builder.migration : 指定迁移 *** 作的迁移类。Builder.deleteRealmIfMigrationNeeded : 声明版本冲突时自动删除原数据库。Builder.inMemory : 声明数据库只在内存中持久化。build : 完成配置构建。关闭Realm记得使用完后，在onDestroy中关闭Realm
@OverrIDe protected voID onDestroy() { super.onDestroy(); // Close the Realm instance. realm.close(); }写入 *** 作需要在事务中进行，可以使用executeTransaction方法来开启事务。
executeTransaction方法插入数据 mRealm.executeTransaction(new Realm.Transaction() { @OverrIDe public voID execute(Realm realm) { User user = realm.createObject(User.class); user.setname("Gavin"); user.setAge(23); } });在execute方法中执行插入 *** 作
使用注意：如果在UI线程中插入过多的数据，可能会导致主线程拥塞。
copyToRealmOrUpdate或copyToRealm方法插入数据当Model中存在主键的时候，推荐使用
copyToRealmOrUpdate方法插入数据。如果对象存在，就更新该对象；反之，它会创建一个新的对象。若该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); } });modlepublic 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; } });Dog：public class Dog extends RealmObject { private String name; private int age; //getters and setters}对应的User属性中加入Dog类
public class User extends RealmObject { private String name; private int age; private Dog dog; //getters and setters}如果你养了不止一只，你养了二哈、阿拉撕家…那你就要用到RealmList了。在User中加入该属性
private RealmList<Dog> dogs;插入数据
@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方法插入数据，还有另一种方法可以用于插入数据——beginTransaction和commitTransactionmRealm.beginTransaction();//开启事务User user = mRealm.createObject(User.class);user.setname("Gavin");user.setID("3");mRealm.commitTransaction();//提交事务在插入前，先调用beginTransaction()，完成后调用commitTransaction()即可。
使用注意：在UI和后台线程同时开启创建write的事务，可能会导致ANR错误。为了避免该问题，可以使用
executeTransactionAsync来实现。
executeTransactionAsync该方法会开启一个子线程来执行事务，并且在执行完成后进行结果通知。
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"); }});还可以加入监听
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() { //成功回调 }}, new Realm.Transaction.OnError() { @OverrIDe public voID one rror(Throwable error) { //失败回调 }});注意：如果当Acitivity或Fragment被销毁时，在OnSuccess或OnError中执行UI *** 作，将导致程序奔溃 。用RealmAsyncTask .cancel();可以取消事务
在onStop中调用，避免crash
public voID onStop () { if (transaction != null && !transaction.isCancelled()) { transaction.cancel(); }}Realm还是个很nice的功能就是将Json字符串转化为对象，厉害了我的Realm
（直接借用官方的例子）
// 一个city modelpublic class City extends RealmObject { private String city; private int ID; // getters and setters left out ...}// 使用Json字符串插入数据realm.executeTransaction(new Realm.Transaction() { @OverrIDe public voID execute(Realm realm) { realm.createObjectFromJson(City.class, "{ city: \"copenhagen\", ID: 1 }"); }});// 使用inputStream插入数据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 时遵循如下规则：
使用包含空值（null）的 JsON 创建对象：对于非必须（可为空值的属性），设置其值为 null；对于必须（不可为空值的属性），抛出异常；使用包含空值（null）的 JsON 更新对象：对于非必须（可为空值的属性），设置其值为 null；对于必须（不可为空值的属性），抛出异常；使用不包含对应属性的 JsON： * 该属性保持不变查查找 *** 作就比插入方便多了，并不需在事务中 *** 作，直接查询即可。
findAll ——查询例：查询所有的
UserRealmResults<User> userList = mRealm.where(User.class).findAll();这里使用RealmResults来接受查询到的结果，突然出现的RealmResults可能会让人懵逼。看看他的源码，发现RealmResults继承了AbstractList，而AbstractList又实现了List接口。好吧，原来实现了我们熟悉的List接口。
public final class RealmResults<E extends RealmModel> extends AbstractList<E>public abstract class AbstractList<E> extends AbstractCollection<E> implements List<E> 注意：
RealmResults虽然实现了List接口，不过有很多方法是不能用的。比如add、addAll、remove、clear等，调用后会直接抛异常。不过也不用当心误用这些方法，因为它们都被标记为@Deprecated了。
findAllAsync——异步查询当数据量较大，可能会引起ANR的时候，就可以使用
findAllAsync RealmResults<User> userList = mRealm.where(User.class) .equalTo("name", "Gavin") .findAllAsync();值得注意的是，这里并不会马上查到数据，是有一定延时的。也就是说，你马上使用userList的时候，里面是没有数据的。可以注册Realmchangelistener监听器，或者使用isLoaded()方法，判断是否查询完成
if (result.isLoaded()) { // 完成查询}findFirst ——查询第一条数据例：查询
User表中的第一条数据User user2 = mRealm.where(User.class).findFirst();equalTo ——根据条件查询例：得到
name为Gavin的用户列表。RealmResults<User> userList = mRealm.where(User.class) .equalTo("name", "Gavin").findAll();如果User中还有Dog属性，希望根据Dog的条件来获取用户：
例：查询dogs.name为二哈的User
RealmResults<User> userList = mRealm.where(User.class) .equalTo("dogs.name", "二哈").findAll();得到有养有dogs.name为”二哈”的用户列表（这里的dogs是User表中的属性名）
equalTo ——多条件查询当然，我们还经常要用到多条件的查询的功能。
例：找到用户名为“Gavin”，且
dogs.name为“二哈”的UserRealmResults<User> userList = mRealm.where(User.class) .equalTo("name", "Gavin").findAll();RealmResults<User> userList = user5.where() .equalTo("dogs.name", "二哈").findAll();上面先找到name为“Gavin”的User列表，然后再得到的结果中查询dogs.name为“二哈”
觉得这样写太麻烦？我也是这样想的，所以还可以这样写
RealmResults<User> userList = mRealm.where(User.class) .equalTo("name", "Gavin") .equalTo("dogs.name", "二哈") .findAll();是不是很清爽~~~
更多查询条件
上面就展示了equalTo的用法。当然，查询还有更多的用法，我就不一一示例了。已知的方法如下：sum()：对指定字段求和。average()：对指定字段求平均值。min(): 对指定字段求最小值。max() : 对指定字段求最大值。count : 求结果集的记录数量。findAll(): 返回结果集所有字段，返回值为RealmResults队列findAllSorted() : 排序返回结果集所有字段，返回值为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()方法
这么一大串，你又觉得麻烦了？没事，继续简化。
RealmResults<User> userList = mRealm.where(User.class) .equalTo("name", "Gavin") .or().equalTo("name", "Eric") .findAll();Tip：查询的时候你不用当心得到的RealmResults为null。如果查询的结果为空，那么RealmResults的size为0
查询结束后，还可以进行排序，就像这样：
RealmResults<User> userList = mRealm.where(User.class) .findAll();userList = result.sort("age"); //根据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); }});修改也是需要在事务中 *** 作。
使用查询语句得到数据，然后将内容改了即可。
deleteFromrealm()//先查找到数据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表的第一条数据userList.deleteLastFromrealm();//删除user表的最后一条数据results.deleteallFromrealm();//删除user表的全部数据当数据结构发生变化是，需要升级数据库。对于Realm来说，数据库升级就是迁移 *** 作，把原来的数据库迁移到新结构的数据库。（体验：略麻烦）
例1：User类发生变化，移除age，新增个@required的ID字段。User版本：version 0String name;int age;User版本：version 1
@requiredString ID;String name;创建迁移类CustomMigration，需要实现RealmMigration接口。执行版本升级时的处理：
/** * 升级数据库 */ 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(DynamicRealmObject obj) { obj.set("ID", "1");//为ID设置值 } }) .removeFIEld("age");//移除age属性 oldVersion++; } } }使用Builder.migration升级数据库，将版本号改为1（原版本号：0）。当Realm发现新旧版本号不一致时，会自动使用该迁移类完成迁移 *** 作。
RealmConfiguration config = new RealmConfiguration.Builder() .name("myrealm.realm") //文件名 .schemaVersion(1) .migration(new CustomMigration())//升级数据库 .build();Dog类，User中加入Dog集合。User版本：version 1@requiredString ID;String name;User版本：version 2
@requiredprivate String ID;private String name;private RealmList<Dog> dogs;Dog类
public class Dog extends RealmObject { private String name; private int age;}在迁移类CustomMigration中，继续添加处理方法。
if (oldVersion == 1 && newVersion == 2) { //创建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) { //为已存在的数据设置dogs数据 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");例：为字段设置值
obj.setString("name", "Gavin");obj.setInt("ID", 1);obj.setLong("ID", 1);加密疑问：我在deBUG时发现这样的数据，如图：
userList展开后的userListg
什么，dogs、ID、name的值怎么都是null？这~~
开始我还以为升级时数据丢失，不过在图中userList第0条数据的右边看到了我的数据，于是我展开了里面的内容，如图：
好吧，他并不是我想象中的那种存法，我已经不知道他内部是怎么实现的了。（还望大神赐教）
（官方原文）
Realm 文件可以通过传递一个512位（64字节）的密钥参数给 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);保证了所有永久性存储在磁盘上的数据都是通过标准 AES-256 加密的。每次创建新的 Realm 实例的时候，都需要提供相同的密钥。
参考 examples/encryptionExample。这个例子演示了如何通过 AndroID KeyStore 来安全地存储密钥。
（官方原文）
Realm提供了一些抽象的工具类来方便地将 OrderedRealmCollection
（RealmResults和 RealmList 都实现了这个借口）展示到UI控件上。
RealmBaseAdapter 可以与ListVIEw配合使用。参见示例.RealmRecyclerVIEwAdapter可以与 RecyclerVIEw配合使用。参见示例.你需要在 app 的 build.gradle中添加额外的依赖以使用这些适配器。
dependencIEs { compile 'io.realm:androID-adapters:1.4.0'}（官方原文）
你不可以直接通过 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部分。该示例展示了在安卓开发中常用的如何传递 ID 并且得到对应的 RealmObject。
对于这么火的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轻松转换成RxJava中的Observable，使用.filter(persons.isLoaded)来判断是否已查询完成。到这里，熟悉RxJava的同学应该已经看明白了~~。可能还有人会一脸懵逼，->? 这是什么鬼？哈哈，这叫Lambda，有时间可以去看看。
也许还有很多同学不了解RxJava，这里极力推荐给 Android 开发者的 RxJava 详解。
终于写完了~~~说好易用的，没想到内容居然这么多。
源码地址GitHub
参考资料官方文档
GitHub
Realm for Android快速入门教程
Android开发笔记（八十五）手机数据库Realm
在Android加入和使用Realm
Android 进阶之第三方库的介绍 Realm [一] 基础用法
以上是内存溢出为你收集整理的【Android】Realm详解全部内容，希望文章能够帮你解决【Android】Realm详解所遇到的程序开发问题。
如果觉得内存溢出网站内容还不错，欢迎将内存溢出网站推荐给程序员好友。
欢迎分享，转载请注明来源：内存溢出
微信扫一扫
支付宝扫一扫
评论列表（0条）