Realm 是一个手机数据库,是用来替代 SQlite 的解决方案,比 SQlite 更轻量级,速度更快,因为它有一套自己的数据库搜索引擎,并且还具有很多现代数据库的优点,支持 JSON,流式 API 调用,数据变更通知,自动数据同步,简单身份验证,访问控制,事件处理,最重要的是跨平台,目前已经支持 Java、Swift、Object - C、React - Native 等多种实现,今天我们就来简单的入门 Ream 数据库的使用
GitHub 地址:Realm GitHub 地址
官方文档地址:官方文档地址
一、使用要求
首先使用 Realm 的一些使用要求我们还是需要先来了解
- Android Studio 的使用版本必须在 1.5.1 或更高
- 使用 JDK 7 或更高版本
- Android API 9 或更高(即 Android 2.3 及以上)
- Realm 不在 Android 支持 Java,不支持 Eclipse 作为 IDE,如果使用请转到 Android Studio
上面基本就是我们要注意的事项,大家了解即可
二、环境配置
在了解 Realm 在 Andorid 中的基本使用要求之后,接下来我们来看看,如何在 Android Studio 中来引入 Realm
1)首先在工程的根目录(工程目录) build.gradle 中引入如下代码,注意是工程的 build.gradle 而不是 app 的 build.gradle
可以看到 Realm 是作为一个插件来安装的
添加位置如下图:
2)在 app 的 build.gradle 中添加如下代码
添加位置如下图:
当上面的这两步做好以后,可以刷新我们的 Gradle 依赖,如果你是通过 v 0.88 以前的版本来更新,你需要去清理一下你的 Gradle 项目(./gradlew clean),来移除之前的安装,另外对 Maven 和 Ant 并不支持
三、官方推荐的例子
introExample:包括了简单的例子,让你知道如何去使用当前的 API
gridViewExample:一个简单的 APP,来展示怎么通过 Realm 来支持 GridView 的存储,同时它还呈现了如何构建一个 JSON 的数据库(通过 GSON)
thread Example :简单展示如何在多线程中使用 Realm
adapterExample:如何通过使用 RealmBaseAdapter 和 RealmRecyclerViewAdapter 来使 Realm 以优雅的方式作用于 ListView 和 RecyclerView
jsonExample:如何使用一种新的 Realm JSON 工具
encryptionExample:如何使用加密 Realms
rxJavaExample:如何搭配 RxJava 来使用 Realm
UnitTestExample:教你在使用 Realm 时如何编写单元测试
四、初始化 Realm
1)在 Applaction 的 onCreate() 方法中使用 Realm.init() 初始化
2)在 Applaction的onCreate() 方法中对 Realm 进行相关的配置
1. 使用默认配置:
或者如下: