Realm for Android 使用入门

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

[java]  view plain   copy

1. buildscript {  
2.     repositories {  
3.         jcenter()  
4.     }  
5.     dependencies {  
6.         classpath "io.realm:realm-gradle-plugin:3.7.0"  
7.     }  

可以看到 Realm 是作为一个插件来安装的

添加位置如下图：

2）在 app 的 build.gradle 中添加如下代码

[java]  view plain   copy

1. apply plugin: 'realm-android'  

添加位置如下图：

       当上面的这两步做好以后，可以刷新我们的 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() 初始化

[java]  view plain   copy

1. public class MyApplication extends Application {  
2.   @Override  
3.   public void onCreate() {  
4.     super.onCreate();  
5.     Realm.init(this);  
6.   }  
7. }  

2）在 Applaction的onCreate() 方法中对 Realm 进行相关的配置

1. 使用默认配置：

[java]  view plain   copy

1. Realm.init(this);  
2. Realm mRealm = Realm.getDefaultInstance();  

或者如下：

[java]  view plain   copy

1. public class MyApplication extends Application {  
2.   @Override