- 原文出自《RxJava Essentials》
- 原文作者 : Ivan Morgillo
- 译文出自 : 开发技术前线 www.devtf.cn
- 转载声明: 本译文已授权开发人员头条享有独家转载权,未经同意。不得转载!
- 译者 : yuxingxin
- 项目地址 : RxJava-Essentials-CN
向响应式世界问好
在上一章中,我们对观察者模式有个理论上的高速概述。我们也看了从头開始、从列表、或者从已经存在的函数来创建Observables。
在本章中。我们将用我们学到的来创建我们第一个响应式Android应用程序。
首先,我们须要搭建好开发环境,导入须要的库和实用的库。然后我们将创建一个简单的应用程序,在不同的flavors中包括几个用RxJava填充的RecycleView items。
启动引擎
我们将使用IntelliJ IDEA/Android Studio来创建这个project,因此你会对截图看起来比較熟悉。
让我们開始创建一个新的Androidproject。你能够创建你自己的project或者用本书中提供的导入。选择你自己喜欢的创建方式这取决于你。
假设你想用Android Studio创建一个新的project。通常你能够參考官方文档:http://developer.android.com/intl/zh-cn/training/basics/firstapp/creating-project.html
依赖
非常明显,我们将使用Gradle来管理我们的依赖列表。我们的build.gradble文件看起来像这样:
正如你看到的我们引入了RxAndroid。RxAndroid是RxJava的增强版,尤其是针对Android设计的。
RxAndroid
RxAndroid是RxJava家族的一部分。它基于RxJava1.0.x,在普通的RxJava基础上加入了几个实用的类。大多数情况下。它为Android加入了特殊的调度器。我们将在第七章Schedulers-Defeating the Android MainThread Issue再讨论它。
工具
出于实用,我们引入了Lombok 和 Butter Knife。这两个能够帮助我们在Android应用程序中少写很多模板类代码。
Lombok
Lombok使用注解的方式为你生成很多代码。我们将使用它老生成getter/setter
、toString()
、equals()
、hashCode()
。
它借助于Gradle依赖和一个Android Studio插件。
Butter Knife
Butter Knife使用注解的方式来帮助我们免去写findViewById()
和设置点击监听的痛苦。至于Lombok,我们能够通过导入依赖和安装Android Studio插件来获得更好的体验。
Retrolambda
最后,我们导入Retrolambda,是由于我们开发的Android是基于Java 1.6。然后我们能够借助它来实现Java 8 Lambda函数从而降低很多模板代码。
我们的第一个Observable
在我们的第一个列子里,我们将检索安装的应用列表并填充RecycleView的item来展示它们。
我们也设想一个下拉刷新的功能和一个进度条来告知用户当前任务正在运行。
首先。我们创建Observable。我们须要一个函数来检索安装的应用程序列表并把它提供给我们的观察者。我们一个接一个的发射这些应用程序数据,将它们分组到一个单独的列表中,以此来展示响应式方法的灵活性。
private Observable<AppInfo> getApps(){
return Observable.create(subscriber -> {
List<AppInfoRich> apps = new ArrayList<AppInfoRich>();
final Intent mainIntent = new Intent(Intent.ACTION_MAIN,null);
mainIntent.addCategory(Intent.CATEGORY_LAUNCHER);
List<ResolveInfo> infos = getActivity().getPackageManager().queryIntentActivities(mainIntent, 0);
for(ResolveInfo info : infos){
apps.add(new AppInfoRich(getActivity(),info));
}
for (AppInfoRich appInfo:apps) {
Bitmap icon = Utils.drawableToBitmap(appInfo.getIcon());
String name = appInfo.getName();
String iconPath = mFilesDir + "/" + name;
Utils.storeBitmap(App.instance, icon,name);
if (subscriber.isUnsubscribed()){
return;
}
subscriber.onNext(new AppInfo(name,iconPath,appInfo.getLastUpdateTime()));
}
if (!subscriber.isUnsubscribed()){
subscriber.onCompleted();
}
});
}
AppInfo对象例如以下:
@Data
@Accessors(prefix = "m")
public class AppInfo implements Comparable<Object> {
long mLastUpdateTime;
String mName;
String mIcon;
public AppInfo(String nName, long lastUpdateTime, String icon) {
mName = nName;
mIcon = icon;
mLastUpdateTime = lastUpdateTime;
}
@Override
public int compareTo(Object another) {
AppInfo f = (AppInfo)another;
return getName().compareTo(f.getName());
}
}
须要重点注意的是在发射新的数据或者完毕序列之前要检測观察者的订阅情况。
这样的话代码会更高效。由于假设没有观察者等待时我们就不生成没有必要的数据项。
此时,我们能够订阅Observable并观察它。
订阅一个Observable意味着当我们须要的数据进来时我们必须提供相应的操作来运行它。
当前的场景是什么?我们展示一个进度条来等待数据。当数据到来时,我们须要隐藏掉进度条,填充list,终于展示列表。如今,我们知道当一切都准备好了该做什么。那么错误的场景呢?对于错误这样的情况,我们仅仅是用Toast展示一个错误的信息。
使用Butter Knife,我们得到list和下拉刷新组件的引用:
@InjetcView(R.id.fragment_first_example_list)
RecyclerView mRecycleView;
@InjectView(R.id.fragment_first_example_swipe_container)
SwipeRefreshLayout mSwipeRefreshLayout;
我们使用Android 5的标准组件:RecyclerView和SwipeRefreshLayout。截屏展示了我们这个简单App的list Fragment的layout文件:
我们使用一个下拉刷新方法,因此列表数据能够来自初始化载入,或由用户触发的一个刷新动作。针对这两个场景,我们用相同的行为,因此我们把我们的观察者放在一个易被复用的函数里面。
以下是我们的观察者,定义了成功、失败、完毕要做的事情:
private void refreshTheList() {
getApps().toSortedList()
.subscribe(new Observer<List<AppInfo>>() {
@Override
public void onCompleted() {
Toast.makeText(getActivity(), "Here is the list!", Toast.LENGTH_LONG).show();
}
@Override
public void onError(Throwable e) {
Toast.makeText(getActivity(), "Something went wrong!", Toast.LENGTH_SHORT).show();
mSwipeRefreshLayout.setRefreshing(false);
}
@Override
public void onNext(List<AppInfo> appInfos) {
mRecyclerView.setVisibility(View.VISIBLE);
mAdapter.addApplications(appInfos);
mSwipeRefreshLayout.setRefreshing(false);
}
});
}
定义一个函数使我们能够用相同一个block来处理两种场景成为了可能。当fragment载入时我们仅仅需调用refreshTheList()
方法并设置refreshTheList()
方法作为用户下拉这一行为所触发的方法。
mSwipeRefreshLayout.setOnRefreshListener(this::refreshTheList);
我们第一个样例如今完毕了,运行跑一下。
从列表创建一个Observable
在这个样例中,我们将引入from()
函数。使用这个特殊的“创建”函数。我们能够从一个列表中创建一个Observable。
Observable将发射出列表中的每个元素,我们能够通过订阅它们来对这些发出的元素做出响应。
为了实现和第一个样例相同的结果,我们在每个onNext()
函数更新我们的适配器,加入元素并通知插入。
我们将复用和第一个样例相同的结构。基本的不同的是我们不再检索已安装的应用列表。列表由外部实体提供:
mApps = ApplicationsList.getInstance().getList();
获得列表后,我们仅需将它响应化并填充RecyclerView的item:
private void loadList(List<AppInfo> apps) {
mRecyclerView.setVisibility(View.VISIBLE);
Observable.from(apps)
.subscribe(new Observable<AppInfo>() {
@Override
public void onCompleted() {
mSwipeRefreshLayout.setRefreshing(false);
Toast.makeText(getActivity(), "Here is the list!", Toast.LENGTH_LONG).show();
}
@Override
public void onError(Throwable e) {
Toast.makeText(getActivity(), "Something went wrong!", Toast.LENGTH_SHORT).show();
mSwipeRefreshLayout.setRefreshing(false);
}
@Override
public void onNext(AppInfo appInfo) {
mAddedApps.add(appInfo);
mAdapter.addApplication(mAddedApps.size() - 1,appInfo);
}
});
}
正如你看到的,我们将已安装的应用程序列表作为參数传进from()
函数,然后我们订阅生成的Observable。
观察者和我们第一个样例中的观察者十分相像。
一个基本的不同是我们在onCompleted()
函数中停掉进度条是由于我们一个一个的发射元素;第一个样例中的Observable发射的是整个list,因此在onNext()
函数中停掉进度条的做法是安全的。
再多几个样例
在这一节中,我们将基于RxJava的just()
,repeat()
,defer()
,range()
,interval()
,和timer()
方法展示一些样例。
just()
假如我们仅仅有3个独立的AppInfo对象而且我们想把他们转化为Observable并填充到RecyclerView的item中:
List<AppInfo> apps = ApplicationsList.getInstance().getList();
AppInfo appOne = apps.get(0);
AppInfo appTwo = apps.get(10);
AppInfo appThree = apps.get(24);
loadApps(appOne,appTwo,appThree);
我们能够像我们之前的样例那样检索列表并提取出这三个元素。然后我们将他们传到这个loadApps()
函数里面:
private void loadApps(AppInfo appOne,AppInfo appTwo,AppInfo appThree) {
mRecyclerView.setVisibility(View.VISIBLE);
Observable.just(appOne,appTwo,appThree)
.subscribe(new Observable<AppInfo>() {
@Override
public void onCompleted() {
mSwipeRefreshLayout.setRefreshing(false);
Toast.makeText(getActivity(), "Here is the list!", Toast.LENGTH_LONG).show();
}
@Override
public void onError(Throwable e) {
Toast.makeText(getActivity(), "Something went wrong!", Toast.LENGTH_SHORT).show();
mSwipeRefreshLayout.setRefreshing(false);
}
@Override
public void onNext(AppInfo appInfo) {
mAddedApps.add(appInfo);
mAdapter.addApplication(mAddedApps.size() - 1,appInfo);
}
});
}
正如你看到的,代码和之前的样例非常像。
这样的方法让我们有机会来考虑一下代码的复用。
你能够将一个函数作为參数传给just()
方法。你将会得到一个已存在代码的原始Observable版本号。在一个新的响应式架构的基础上迁移已存在的代码,这种方法可能是一个实用的開始点。
repeat()
假如你想对一个Observable反复发射三次数据。比如。我们用just()
样例中的Observable:
private void loadApps(AppInfo appOne,AppInfo appTwo,AppInfo appThree) {
mRecyclerView.setVisibility(View.VISIBLE);
Observable.just(appOne,appTwo,appThree)
.repeat(3)
.subscribe(new Observable<AppInfo>() {
@Override
public void onCompleted() {
mSwipeRefreshLayout.setRefreshing(false);
Toast.makeText(getActivity(), "Here is the list!", Toast.LENGTH_LONG).show();
}
@Override
public void onError(Throwable e) {
Toast.makeText(getActivity(), "Something went wrong!", Toast.LENGTH_SHORT).show();
mSwipeRefreshLayout.setRefreshing(false);
}
@Override
public void onNext(AppInfo appInfo) {
mAddedApps.add(appInfo);
mAdapter.addApplication(mAddedApps.size() - 1,appInfo);
}
});
}
正如你看到的,我们在just()
创建Observable后追加了repeat(3)
。它将会创建9个元素的序列,每个都单独发射。
defer()
有这样一个场景。你想在这声明一个Observable可是你又想推迟这个Observable的创建直到观察者订阅时。看以下的getInt()
函数:
private Observable<Integer> getInt(){
return Observable.create(subscriber -> {
if(subscriber.isUnsubscribed()){
return;
}
App.L.debug("GETINT");
subscriber.onNext(42);
subscriber.onCompleted();
});
}
这比較简单,而且它没有做太多事情,可是它正好为我们服务。如今,我们能够创建一个新的Observable而且应用defer()
:
Observable<Integer> deferred = Observable.defer(this::getInt);
这次。deferred
存在。可是getInt()
create()
方法还没有调用:logcat日志也没有“GETINT”打印出来:
deferred.subscribe(number -> {
App.L.debug(String.valueOf(number));
});
可是一旦我们订阅了,create()
方法就会被调用而且我们也能够在logcat日志中得到下卖弄两个:GETINT和42。
range()
你须要从一个指定的数字X開始发射N个数字吗?你能够用range
:
Observable.range(10,3)
.subscribe(new Observable<Integer>() {
@Override
public void onCompleted() {
Toast.makeText(getActivity(), "Yeaaah!", Toast.LENGTH_LONG).show();
}
@Override
public void onError(Throwable e) {
Toast.makeText(getActivity(), "Something went wrong!", Toast.LENGTH_SHORT).show();
}
@Override
public void onNext(Integer number) {
Toast.makeText(getActivity(), "I say " + number, Toast.LENGTH_SHORT).show();
}
});
range()
函数用两个数字作为參数:第一个是起始点,第二个是我们想发射数字的个数。
interval()
interval()
函数在你须要创建一个轮询程序时非常好用。
Subscription stopMePlease = Observable.interval(3,TimeUnit.SECONDS)
.subscribe(new Observable<Integer>() {
@Override
public void onCompleted() {
Toast.makeText(getActivity(), "Yeaaah!", Toast.LENGTH_LONG).show();
}
@Override
public void onError(Throwable e) {
Toast.makeText(getActivity(), "Something went wrong!", Toast.LENGTH_SHORT).show();
}
@Override
public void onNext(Integer number) {
Toast.makeText(getActivity(), "I say " + number, Toast.LENGTH_SHORT).show();
}
});
interval()
函数的两个參数:一个指定两次发射的时间间隔。还有一个是用到的时间单位。
timer()
假设你须要一个一段时间之后才发射的Observable,你能够像以下的样例使用timer()
:
Observable.timer(3,TimeUnit.SECONDS)
.subscribe(new Observable<Long>() {
@Override
public void onCompleted() {
}
@Override
public void onError(Throwable e) {
}
@Override
public void onNext(Long number) {
Log.d("RXJAVA", "I say " + number);
}
});
它将3秒后发射0,然后就完毕了。让我们使用timer()
的第三个參数,就像以下的样例:
Observable.timer(3,3,TimeUnit.SECONDS)
.subscribe(new Observable<Long>() {
@Override
public void onCompleted() {
}
@Override
public void onError(Throwable e) {
}
@Override
public void onNext(Long number) {
Log.d("RXJAVA", "I say " + number);
}
});
用这个代码,你能够创建一个以初始值来延迟(上一个样例是3秒)运行的interval()
版本号,然后每隔N秒就发射一个新的数字(前面的样例是3秒)。
总结
在本章中,我们创建了第一个由RxJava强化的Android应用程序。
我们从头、从已有的列表、从已有的函数来创建Observable。
我们也学习了怎样创建反复发射的Observables。间隔发射的Observables以及延迟发射的Observables。
在下一章中,我们将掌握过滤操作。能够从我们接收到的序列中创建我们须要的序列。