831804-20170216224841207-2015883983.jpg
相信用过Android Realm数据库的同学享受了Realm的强大的同时，也忍受了Realm事物操作的繁琐。例如 Realm有很多限制，让它操作起来变得非常复杂。
如需要人为打开和关闭Realm实例，且要在同一个线程中执行。
另一个限制是，你没有先从Realm解开不同线程之间的链接，那么你就不能在它们之间传递你的查询结果。即使你要执行的是单一操作，你还必须注意事务管理。
有些很烦人的限制例子，你必须意识到它们并在未来避免这些问题。
下面给大家介绍的这款Realm API转换成了我们大家喜欢的样子，忽略了众多的Realm限制，使其工作在更高的抽象层
这个库的名称是Kotlin Realm Extensions（Kotlin Realm扩展），你可以在这里找到。
其次，你应该知道这个库能为你做什么：
获得默认的Realm实例，在事务完成后关闭它。
启动和提交事务。
在其它线程中，为使Realm对象之间工作，断开它们的链接。
在主线程中执行可观察的查询（Realm要求这类查询）
最后，我们必须做下列工作。下面我们看看一些对比的例子：
以Java持久化实体
Realm realm = Realm.getDefaultInstance();
try{
realm.executeTransaction(realm -> {
realm.copyToRealmOrUpdate(user);
});
} finally {
realm.close();
}
User user = new User("John");
Realm realm = Realm.getDefaultInstance();
try{
realm.executeTransaction(realm -> {
realm.copyToRealmOrUpdate(user);
});
} finally {
realm.close();
}
等效的Kotlin Realm扩展
User("John").save()
我们还可以有saveAll()方法用于数组和集合。
Java
Realm realm = Realm.getDefaultInstance();
try {
realm.executeTransaction(realm -> {
realm.copyToRealmOrUpdate(users);
});
} finally {
realm.close();
}
Kotlin
listOf<User>(...).saveAll()
以Java查询所有给定类型的实体
Realm realm = Realm.getDefaultInstance();
try {
Event firstEvent = realm.where(Event.class).findFirst();
firstEvent = realm.copyFromRealm(event);
} finally {
realm.close();
}
等效的Kotlin Realm扩展
val firstEvent = Event().queryFirst() //Or val first = queryFirst<Event>
我们也能以简单的方法执行条件查询：
Java
Realm realm = Realm.getDefaultInstance();
try{
List<Event> events = realm.where(Event.class).equalTo("id",1).findAll();
events = realm.copyFromRealm(event);
} finally {
realm.close();
}
Kotlin
val events = Event().query { equalTo("id",1) } //Or query<Event> { ... }
//NOTE: If you have a compilation problems in equalTo method (overload ambiguity error), you can use equalToValue("id",1) instead
如果您只需要第一个或最后一个结果，您还可以使用：
val first = Event().queryFirst { equalTo("id",1) }
val last = Event().queryLast { equalTo("id",1) }
获取排序的实体
val sortedEvents = Event().querySorted("name",Sort.DESCENDING)
val sortedEvents = Event().querySorted("name",Sort.DESCENDING) { equalTo("id",1) }
删除实体
Java
Realm realm = Realm.getDefaultInstance();
try{
List<Event> events = realm.where(Event.class).findAll();
realm.executeTransaction(realm -> {```
events.deleteAllFromRealm();
});
} finally {
realm.close();
}
Kotlin
Event().deleteAll() //Or deleteAll<Event>
按条件删除
Java
Realm realm = Realm.getDefaultInstance();
try{
List<Event> events = realm.where(Event.class).equalTo("id",1).findAll().deleteAllFromRealm();
events = realm.copyFromRealm(event);
} finally {
realm.close();
}
Kotlin
Event().delete { equalTo("id", 1) }
监听数据变更
Java
Realm realm = Realm.getDefaultInstance();
Flowable<List<Event>> obs = realm.where(Event.class).findAllAsync()
.asFlowable()
.filter(RealmResults::isLoaded)
.map(realm::copyFromRealm)
.doOnUnsubscribe(() -> realm.close());
Kotlin
val obs = Event().queryAllAsFlowable() //Or queryAllAsFlowable<Event>
这里不再一一列举，完整的文档在GitHub站点上提供。
