安装

第一步：在项目的 build.gradle 文件中添加如下 class path 依赖。

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

项目的build.gradle文件在如下位置：

第二步：在 app 的 build.gradle 文件中应用realm-android插件。

applyplugin:'realm-android'

app的build.gradle文件在如下位置：

使用

Realm数据库的基本增删查改，跟传统的数据库一样，他主要的优势是对json数据结构的保存

注意事项

1、Realm保存的结果其实是在一个文件里面，默认的文件名是"default.realm"，在"Context.getFilesDir()"目录中，即：/data/data//files/default.realm。意思是，当你在应用管理里面给当前app"清除数据"，realm数据库的数据会丢失。故我们需要把默认的数据文件放到asset目录中，当数据库初始化时再copy到"Context.getFilesDir()"下。

2、在创建RealmConfiguration对象时，可以通过.assetFile(this,"realm file path in assets")方法指定初始化的数据库文件。Realm会把制定路径下的xxx.realm文件copy到Context.getFilesDir()目录中，以替换默认创建的空数据库文件。

3、可以设置默认文件名，通过RealmConfiguration类进行配置。路径似乎改不了，需要看具体设备供应商的实现。

4、Realm的实例需要在每次的具体操作中获取，可以看成是一个数据操作的sessin，用完后必须close关闭。

打开和关闭Realm实例，应当放在onCreate/onDestroy或者onStart/onStop方法中。

5、Realm中似乎有RxJava的影子，支持链式异步任务？

6、Realm中有个各种增删改差的方法，还可以根据JSON的数据实例化一个RealmObject子类java bean。

7、重点：切记，Realm数据库的主键字段不是自动增长的，需要自己设置，做添加的时候如果不给id字段值，默认会为0。后面再添加会报错，说id为0的数据已经存在。尤其是批量添加的时候要注意，当心出现只添加了一条记录的悲剧。

8、数据自动更新。mRealm.addChangeListener(this);//当数据库的数据有变化时，系统回调此方法。

缺点

这里有的也不能说是缺点, 只是使用起来觉得不方便的地方.

限制了创建对象和操作对象必须在同一个线程.

违反了这条会报错:java.lang.IllegalStateException: Realm access from incorrect thread. Realm objects can only be accessed on the thread they were created.比如我们在UI线程查询出来的对象, 想要异步地删除或者更新, 我们必须在新的线程重新查询.

没有主键自增的功能, 见Issue #469, 需要自己控制主键自增.

从List中删除了一项之后, 最后的一项会移动过来补到被删除的那一项原来的位置. 这是因为人家就是这么设计的stackoverflow. 默认情况下是没有排序的, 数据按照添加的顺序返回, 但是这并不是一种保证, 所以当删除了中间的元素, 后面的会补上这个位置, 以保证底层的数据是放在一起的. 解决办法就是指定一个排序规则.

查询出来的对象不可以临时改变其数据, 否则会报错:java.lang.IllegalStateException: Changing Realm data can only be done from inside a transaction.

不支持反向link的查询. (见前面链式查询部分的介绍).

不支持级联删除. 即从数据库中删除一个对象的时候, 不会删除其中RealmObject子类或RealmList类型的字段在数据库中对应的数据.Issue #1104,Issue #2717. 这点也可以理解, 因为model之间的关系可能是多对多的. 所以需要实现级联删除的地方需要手动处理.

测试不方便:RealmResults对象即不能被mock也不能被new; 所有的Model对象也不能被mock. 因为Mockito can only mock non-private & non-final classes.