在Android开发中，经常会用到数据库操作，各种增删改查语句，烦不胜烦。今天介绍一款好用的数据库Realm，可以让数据库操作更加便捷。
一、目录
二、Realm简介
数据库Realm，是用来替代sqlite的一种解决方案，它有一套自己的数据库存储引擎，比sqlite更轻量级，拥有更快的速度，并且具有很多现代数据库的特性，比如支持JSON，流式api，数据变更通知，自动数据同步,简单身份验证，访问控制，事件处理，最重要的是跨平台，目前已有Java，Objective C，Swift，React-Native，Xamarin这五种实现。
优势
易用
Ream 不是在SQLite基础上的ORM，它有自己的数据查询引擎。并且十分容易使用。
快速
由于它是完全重新开始开发的数据库实现，所以它比任何的ORM速度都快很多，甚至比SLite速度都要快。
跨平台
Realm 支持 iOS & OS X (Objective‑C & Swift) & Android。我们可以在这些平台上共享Realm数据库文件，并且上层逻辑可以不用任何改动的情况下实现移植。
高级
Ream支持加密，格式化查询，易于移植，支持JSON，流式api，数据变更通知等高级特性
可视化
Realm 还提供了一个轻量级的数据库查看工具，在Mac Appstore 可以下载“Realm Browser”这个工具，开发者可以查看数据库当中的内容，执行简单的插入和删除数据的操作。
三、环境配置
（1） 在项目的build文件加上buildscript {
repositories {
jcenter()
}
dependencies {
classpath "io.realm:realm-gradle-plugin:3.0.0"
}
}
（2） 在app的build文件加上apply plugin: 'realm-android'
四、初始化Realm
（1） 在Application的oncreate()方法中Realm.init()public class MyApplication extends Application {
public void onCreate() {
super.onCreate();
Realm.init(this);
}
}
（2）在Application的oncreate()方法中对Realm进行相关配置
①使用默认配置public class MyApplication extends Application {
public void onCreate() {
super.onCreate();
// The Realm file will be located in Context.getFilesDir() with name "default.realm"
Realm.init(this);
RealmConfiguration config = new RealmConfiguration.Builder().build();
Realm.setDefaultConfiguration(config);
}
}
②使用自定义配置public class MyApplication extends Application {
public void onCreate() {
super.onCreate();
Realm.init(this);
RealmConfiguration config = new RealmConfiguration.Builder()
.name("myRealm.realm")
.deleteRealmIfMigrationNeeded()
.build();
Realm.setDefaultConfiguration(config);
}
}
（3）在AndroidManifest.xml配置自定义的Application<application
android:name=".MyApplication"
...
/>
五、创建实体
（1）新建一个类继承RealmObjectpublic class TimeInfo extends RealmObject {
//年月日信息
private String ymD;
//标题
private String title;
//内容
private String content;
//时间段信息 12：00-13：00
private String addTime;
//创建该条目时的时间
private String createTime;
//是否是新的任务
private boolean isNew = true;
//在列表中所处位置
private int position = -1;
................省略get,set方法
}
（2）其他相关说明
1、支持的数据类型：
boolean, byte, short, int, long, float, double, String, Date and byte[]
在Realm中byte, short, int, long最终都被映射成long类型
2、注解说明
@PrimaryKey
①字段必须是String、 integer、byte、short、 int、long 以及它们的封装类Byte, Short, Integer, and Long
②使用了该注解之后可以使用copyToRealmOrUpdate()方法，通过主键查询它的对象，如果查询到了，则更新它，否则新建一个对象来代替。
③使用了该注解将默认设置（@index）注解
④使用了该注解之后，创建和更新数据将会慢一点，查询数据会快一点。
@Required
数据不能为null
@Ignore
忽略，即该字段不被存储到本地
@Index
为这个字段添加一个搜索引擎，这将使插入数据变慢、数据增大，但是查询会变快。建议在需要优化读取性能的情况下使用。
六、增删改查
1.增
1）实现方法一：事务操作mRealm.beginTransaction();
TimeInfo info= realm.createObject(TimeInfo.class); // Create a new object
info.setTitle("realm");
realm.commitTransaction();
2）实现方法二：使用事务块mRealm.executeTransaction(new Realm.Transaction() {
public void execute(Realm realm) {
realm.copyToRealm(bean);
}
});
2.查
（1）查询全部RealmResults<? extends RealmObject> beans = mRealm.where(clazz).findAll();
（2）条件查询RealmObject bean = mRealm.where(clazz).equalTo(fieldName, value).findFirst();
常见的条件如下（详细资料请查官方文档）：
between(), greaterThan(), lessThan(), greaterThanOrEqualTo() & lessThanOrEqualTo()
equalTo() & notEqualTo()
contains(), beginsWith() & endsWith()
isNull() & isNotNull()
isEmpty() & isNotEmpty()
（3）对查询结果进行排序RealmResults<? extends RealmObject> beans = mRealm.where(clazz).findAll();
//升序排序
RealmResults<? extends RealmObject> results = beans.sort(fieldName, Sort.ASCENDING);
//降序排序
RealmResults<? extends RealmObject> results = beans.sort(fieldName, Sort.DESCENDING);
（4）其他查询
sum，min，max，average只支持整型数据字段/**
* 查询最大位置
*/
private void getMaxPosition(){
Number max= mRealm.where(TimeInfo.class).findAll().max("position");
int maxPosition=max.intValue();
}
其他使用类似
3.删
mRealm.executeTransaction(new Realm.Transaction() { |
4.改
TimeInfo info= mRealm.where(TimeInfo.class).equalTo("position", position).findFirst(); |
七、异步操作
大多数情况下，Realm的增删改查操作足够快，可以在UI线程中执行操作。但是如果遇到较复杂的增删改查，或增删改查操作的数据较多时，就可以子线程进行操作。
（1）异步增：RealmAsyncTask addTask= mRealm.executeTransactionAsync(new Realm.Transaction() {
public void execute(Realm realm) {
realm.copyToRealm(bean);
}
}, new Realm.Transaction.OnSuccess() {
public void onSuccess() {
ToastUtil.showShortToast(mContext,"添加成功");
}
}, new Realm.Transaction.OnError() {
public void onError(Throwable error) {
ToastUtil.showShortToast(mContext,"添加失败");
}
});
（2）异步删RealmAsyncTask deleteTask= mRealm.executeTransactionAsync(new Realm.Transaction() {
public void execute(Realm realm) {
TimeInfo info =realm.where(TimeInfo.class).equalTo("position",position).findFirst();
info .deleteFromRealm();
}
}, new Realm.Transaction.OnSuccess() {
public void onSuccess() {
ToastUtil.showShortToast(mContext,"删除成功");
}
}, new Realm.Transaction.OnError() {
public void onError(Throwable error) {
ToastUtil.showShortToast(mContext,"删除失败");
}
});
（3）异步改RealmAsyncTask updateTask= mRealm.executeTransactionAsync(new Realm.Transaction() {
public void execute(Realm realm) {
TimeInfo info =realm.where(TimeInfo.class).equalTo("position",position).findFirst();
info .setPosition(position);
}
}, new Realm.Transaction.OnSuccess() {
public void onSuccess() {
ToastUtil.showShortToast(mContext,"更新成功");
}
}, new Realm.Transaction.OnError() {
public void onError(Throwable error) {
ToastUtil.showShortToast(mContext,"失败成功");
}
});
（4）异步查RealmResults<TimeInfo> infos=mRealm.where(TimeInfo.class).findAllAsync();
infos.addChangeListener(new RealmChangeListener<RealmResults<TimeInfo>>() {
public void onChange(RealmResults<TimeInfo> element) {
//执行接收到查询结果数据
}
});
注意：findAllAsync()立刻返回结果，结果为空。可以添加监听，当返回的结果集合infos变化时，会调用该方法。
最后在销毁Activity或Fragment时，要取消掉异步任务，以及取消监听。
|
|
最后别忘了关掉Realm，防止内存泄漏。
mRealm.close(); |
八、封装使用
定义一个RealmOperationHelper类，里面封装各种增删改查方法，方便我们直接调用。
首先，把RealmOperationHelper设置为单例模式，使用静态内部类的方式。 private static Realm mRealm;
private static class SingletonHolder {
private static RealmOperationHelper INSTANCE = new RealmOperationHelper(
mRealm);
}
private RealmOperationHelper(Realm realm) {
this.mRealm = realm;
}
/**
* 获取RealmOperation的单例
*
* @param realm 传入realm实例对象
* @return 返回RealmOperation的单例
*/
public static RealmOperationHelper getInstance(Realm realm) {
if (realm != null) {
mRealm = realm;
}
return SingletonHolder.INSTANCE;
}
```
封装各种增删改查操作，包括同步与异步。异步操作中，对onSuccess，onError方法回调的没有进行处理，实用性不好，后面进一步考虑。
使用实例：
增
RealmOperationHelper.getInstance(AppApplication.REALM_INSTANCE).add(info);删
RealmOperationHelper.getInstance(AppApplication.REALM_INSTANCE).deleteElement(TimeInfo.class,curPosition);异步查
final RealmResults
results.addChangeListener(new RealmChangeListener<RealmResults<TimeInfo>>() {
@Override
public void onChange(RealmResults<TimeInfo> element) {
//只要results改变就会回调，及时取消监听
results.removeAllChangeListeners();
//获取数据，更新UI。
}
});
`
使用效果，很方便，很简洁。
