Realm 数据库的学习和总结

Realm数据库简介

• 可以是本地的也可以是与服务器同步的（TODO 确认）（同步的暂时不管先看本地的）
• 如果是同步的 有权限的设备都可以进行写入
• 同步的话 需要用户权限 TODO 确认
• 在一个线程里面只有一个realm数据库对象。 TODO 确认 （在多个配置下面有句话 可以看看）

配置Realm数据库

• 1 在项目gradle中配置依赖

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

• 2 在应用gradle中配置
  apply plugin: 'realm-android'
• 3 同步gradle。
• 4 与realm服务器同步 TODO 我在代码里面没发现这样的配置，是没有还是另外设置了，另外 就是这个地方的作用是什么 数据上传到服务器？？

realm {
  syncEnabled = true;
}

代码中初始化 Realm数据库

• 在application中init （官方推荐）

public class MyApplication extends Application {
  @Override
  public void onCreate() {
    super.onCreate();
    Realm.init(this);
  }
}

在代码中使用Realm中使用数据库

• 命名是唯一的
• 使用默认配置的Realm

// Get a Realm instance for this thread           
Realm realm = Realm.getDefaultInstance();    //使用这个方法拿到默认配置的数据库对象

默认配置文件 可以通过 Context.getFilesDir() 可以拿到名为 “ default.realm ”的默认配置文件

• 自定义配置Realm

// The RealmConfiguration is created using the builder pattern.
// The Realm file will be located in Context.getFilesDir() with name "myrealm.realm"     自定义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);

• 同一个app中采用不同配置 来创建不同的对象（TODO确认）

RealmConfiguration myConfig = new RealmConfiguration.Builder()
  .name("myrealm.realm")
  .schemaVersion(2)
  .modules(new MyCustomSchema())
  .build();

RealmConfiguration otherConfig = new RealmConfiguration.Builder()
  .name("otherrealm.realm")
  .schemaVersion(5)
  .modules(new MyOtherSchema())
  .build();

Realm myRealm = Realm.getInstance(myConfig);
Realm otherRealm = Realm.getInstance(otherConfig);

• 设置Realm只读

RealmConfiguration config = new RealmConfiguration.Builder()
    .assetFile("my.realm")
    .readOnly()
    // It is optional, but recommended to create a module that describes the classes
    // found in your bundled file. Otherwise if your app contains other classes
    // than those found in the file, it will crash when opening the Realm as the
    // schema cannot be updated in read-only mode.
    .modules(new BundledRealmModule())
    .build();

• 配置Realm数据存储在内存中 不会存在 disk上（当内存低的时候仍然会存储在disk上，但是当close的时候会删除所有存储 另外一种情况 需要一直有引用指向，否则 就会清空所有数据）

RealmConfiguration myConfig = new RealmConfiguration.Builder()
    .name("myrealm.realm")
    .inMemory()
    .build();

在代码中关闭数据库

• 在一个线程当中 call 几次 getInstance() 方法，就需要call 几次 close() 方法。
• 关闭数据库的示例代码如下所示

 Realm realm = Realm.getDefaultInstance();
        try {
            // ... Use the Realm instance ...
        } finally {
            realm.close();
        }