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();
}
