译文:原文地址
更少的公式化代码,更少的SQL语句的编译时间,更少的基于SQL的异步观测查询语句的编译时间---
听上去怎么样?这些在Room数据库(来自架构组件的持续库)中都可以实现。异步查询返回的LiveData、RxJava中的Maybe、Single或者Flowable对象。返回LiveData和Flowable对象的都是可观测对象。他们可以做到无论什么时候你的数据发生改变了,UI都会及时响应实时的数据中的数据的变化。如果你已经在自己的app中使用了RxJava2,那么使用Rooom和Maybe、Single、Flowable就很轻而易举了。
让我们来思考这样一个UI情况:用户在界面上可以看到并且编辑自己的用户名。
这个用户名和用户的其他信息一样都会被保存到数据库中。
为了可以获得User这个对象我们需要在UserDao中使用这样的查询语句:
@Query(“SELECT * FROM Users WHERE id = :userId”)
User getUserById(String userId);
这样的方式有两个缺点:
1.这是一个阻塞的同步的调用
2.在用户数据发生改变的时候需要我们手动调用这个方法来进行更新
Room提供了使用RxJava中的Single、Flowable、Maybe对象的异步查询的方法,来实现观察者模式。(一个目标物件管理所有相依于它的观察者物件,并且在它本身的状态改变时主动发出通知)
如果你还在担心线程的问题,放一百八十个心吧。Room并不是在主线程中调用观察查询的。通过在Scheduler和observeOn方法中设置,你完全可以操控发射给下流的的数据在哪个线程中运行。
对于返回Maybe和Single的查询语句,请确保你的subscribeOn使用的Scheduler不是AndroidSchedulers.mainThread()
如果要和 Room一起使用RxJava2,那么就在自己项目的build.gradle中添加一下引用
// RxJava support for Room
implementation “android.arch.persistence.room:rxjava2:1.0.0-alpha5”
// Testing support
androidTestImplementation “android.arch.core:core-testing:1.0.0-alpha5”
Maybe
@Query(“SELECT * FROM Users WHERE id = :userId”)
Maybe getUserById(String userId);
发生了什么呢?
1.若数据库中没有用户,那么Maybe就会被complete(RxJava中概念)
2.若数据库中有一个用户,那么Maybe就会触发onSuccess方法并且被complete
3.若数据库中用户信息在Maybe被complete之后被更新了,啥都不会发生
Single
@Query(“SELECT * FROM Users WHERE id = :userId”)
Single getUserById(String userId);
就会发生这些事情:
1.若数据库中没有用户,那么Single就会触发onError(EmptyResultSetException.class)
2.若数据库中有一个用户,那么Single就会触发onSuccess
3.若数据库中用户信息在Single.onComplete调用之后被更新了,啥都不会发生,因为数据流已经完成了
Flowable
@Query(“SELECT * FROM Users WHERE id = :userId”)
Flowable getUserById(String userId);
Flowable会这样运行:
1.若数据库中没有用户,那么Flowable就不会发射事件,既不运行onNext,也不运行onError
2.若数据库中有一个用户,那么Flowable就会触发onNext
3.若数据库中用户信息被更新了,Flowable就会自动发射事件,允许你根据更新的数据来更新UI界面
测试
测试一个返回Maybe/Single/Flowable的查询和测试同步查询并没有什么两样。在UserDaoTest中,要确定我们使用的是内存数据库,因为在进程被销毁的时候保存在这里的数据就会被自动清理。
@RunWith(AndroidJUnit4.class)
public class UserDaoTest {
…
private UsersDatabase mDatabase;
@Before
public void initDb() throws Exception {
mDatabase = Room.inMemoryDatabaseBuilder(
InstrumentationRegistry.getContext(),
UsersDatabase.class)
// allowing main thread queries, just for testing
.allowMainThreadQueries()
.build();
}
@After
public void closeDb() throws Exception {
mDatabase.close();
}
在你的test中增加InstantTaskExecutorRule规则,确保Room被迅速执行。
@Rule
public InstantTaskExecutorRule instantTaskExecutorRule =
new InstantTaskExecutorRule();
在这个测试中,我们来订阅getUserById的发射事件,并且确保用户信息被新增了,被Flowable对象发射的。
@Test
public void insertAndGetUserById() {
// Given that we have a user in the data source
mDatabase.userDao().insertUser(USER);
// When subscribing to the emissions of user
mDatabase.userDao()
.getUserById(USER.getId())
.test()
// assertValue asserts that there was only one emission
.assertValue(new Predicate() {
@Override
public boolean test(User user) throws Exception {
// The emitted user is the expected one
return user.getId().equals(USER.getId()) &&
user.getUserName().equals(USER.getUserName());
}
});
}
就是这样子啦!如果你在你的app中也使用了RxJava2,不妨试试响应式数据库,并且确保你的UI一直显示最新的数据,点击此处查看Room和RxJava的例子哦