RxJava2 实战系列文章

RxJava2 实战知识梳理(1) – 后台执行耗时操作,实时通报 UI
更新
RxJava2 实战知识梳理(2) –
计算一段时间内数据的平均值
RxJava2 实战知识梳理(3) –
优化搜索联想功能
RxJava2 实战知识梳理(4) – 结合 Retrofit
请求新闻资讯
RxJava2 实战知识梳理(5) –
简单与进阶的轮询操作
RxJava2 实战知识梳理(6) –
基于左类型的重试请求
RxJava2 实战知识梳理(7) – 基于 combineLatest
实现之输入表单验证
RxJava2 实战知识梳理(8) – 使用 publish + merge
优化先加载缓存,再念博网络数据的请过程
RxJava2 实战知识梳理(9) – 使用 timer/interval/delay
实现任务调度
RxJava2 实战知识梳理(10) – 屏幕旋转导致 Activity
重建时回升任务
RxJava2 实战知识梳理(11) –
检测网络状态并活动重试请求
RxJava2 实战知识梳理(12) – 实战讲解 publish & replay & share & refCount
& autoConnect
RxJava2 实战知识梳理(13) –
如何让错误有常莫自行终止订阅关系
RxJava2 实战知识梳理(14) – 在 token 过期时,刷新过期 token
并再度发起呼吁
RxJava2 实战知识梳理(15) – 实现一个粗略的 MVP + RxJava + Retrofit
应用


一、前言

何以通过结合Retrofit框架来拓展网络要,也是RxJava的攻过程遭到必使控的如出一辙围绕。网上都起为数不少开源项目与文章介绍了,今天随即首稿子,我们尽管由此一个简易的例子,通过RxJava + Retrofit的方式贯彻网络要。

其一事例十分简单,我们由此
干货集中营
提供的接口,分别要Android类和iOS接近的资讯,并拿即时点儿独接口所返的数码以界面上进展展示。

经该例子,可以上怎么样拿RetrofitRxJava结合,并通过zip操作符实现等待多个网要完成。

二、示例

2.1 接口介绍

率先来熟悉一下所用到的测试接口,其数额来自于
干货集中营,这里选择AndroidiOS些微好像的新闻,通过接口的讲述,可以知晓发起呼吁时之变量包含三单:

  • 分类
  • 请个数
  • 吁页数

新濠娱乐 1

回来的数目格式如下:

新濠娱乐 2

2.2 编写 Entity 类

因分析好之数码格式,我们编辑对应的Entity类:

  • 单次返回结果的数据结构:

public class NewsEntity {

    private boolean error;
    private List<NewsResultEntity> results = new ArrayList<>();

    public boolean isError() {
        return error;
    }

    public void setError(boolean error) {
        this.error = error;
    }

    public List<NewsResultEntity> getResults() {
        return results;
    }

    public void setResults(List<NewsResultEntity> results) {
        this.results = results;
    }
}
  • 单条资讯的数据结构:

public class NewsResultEntity {

    private String type;
    private String publishedAt;
    private String desc;
    private String who;

    public String getType() {
        return type;
    }

    public void setType(String type) {
        this.type = type;
    }

    public String getPublishedAt() {
        return publishedAt;
    }

    public void setPublishedAt(String publishedAt) {
        this.publishedAt = publishedAt;
    }

    public String getDesc() {
        return desc;
    }

    public void setDesc(String desc) {
        this.desc = desc;
    }

    public String getWho() {
        return who;
    }

    public void setWho(String who) {
        this.who = who;
    }
}

2.3 引入 Retrofit 依赖

接下来,在build.gradle文本中,引入必要之靠,以下三单依靠包的用意分别吗:

  • Retrofit的核心库
  • 拿赶回的Call<Response>转换成Call<NewsEntity>
  • Call<NewsEntity>转换成Observable<NewsEntity>

dependencies {
     //省略....
    compile 'com.squareup.retrofit2:retrofit:2.1.0'
    compile 'com.squareup.retrofit2:converter-gson:2.0.0'
    compile 'com.jakewharton.retrofit:retrofit2-rxjava2-adapter:1.0.0'

}

末别忘了,在AndroidManifest.xml遭声称必要的网权限:

<uses-permission android:name="android.permission.INTERNET"/>

2.4 定义 Retrofit 需要之求接口

按照Retrofit的用介绍,我们得定义一个接口类,这个接口类的返回值为Observable<NewsEntity>,也即是我们之前定义好的数据结构。而这接口接收三个参数:请求类型、请求个数、请求所在页数。

public interface NewsApi {

    @GET("api/data/{category}/{count}/{page}")
    Observable<NewsEntity> getNews(@Path("category") String category, @Path("count") int count, @Path("page") int page);
}

当我们用请数据常常,就活该像下这样构造一个Observable<NewsEntity>

  • baseUrl:定义请求链接的前缀
  • addConverterFactory:将OKHttp回的正规化Response浅析成我们所用之数据类型NewsEntity
  • addCallAdapterFactory:将Call<NewsEntity>转换成Observable<NewsEntity>,这样才能确实用RetrofitRxJava结起来。

    private Observable<NewsEntity> getObservable(String category, int page) {
        NewsApi api = new Retrofit.Builder()
                .baseUrl("http://gank.io")
                .addConverterFactory(GsonConverterFactory.create())
                .addCallAdapterFactory(RxJava2CallAdapterFactory.create())
                .build().create(NewsApi.class);
        return api.getNews(category, 10, page);
    }

2.5 发起呼吁

如上就是拥有的准备工作,回顾一下咱们重点做了以下四步,这为是后我们运用外任意接口时之正儿八经流程:

  • 熟悉接口
  • 根据接口返回的多少,定义Entity
  • 基于接口的url结方式定义Retrofit所用的接口声明,接口函数的回路也Observable<Entity>,其中Entity纵使是第二步着定义好的回来数据类型。
  • 通过Retrofit,根据第三步的接口定义,返回真正的Observable

骨子里通过以上的季步,我们的干活便差不多做到了,只需要把上面第四步着回到的Observable<XXXEntity>作一个发送数据的屡见不鲜数据源就好了。

示范代码如下,我们请求了AndroidiOS个别只接口,并且应用zip操作符让有限个接口都回到后,才以数据见为用户,同时每次点击刷新资讯之后,我们拿页数增加一以告新的情报。

public class NewsActivity extends AppCompatActivity {

    private int mCurrentPage = 1;
    private NewsAdapter mNewsAdapter;
    private List<NewsResultEntity> mNewsResultEntities = new ArrayList<>();
    private CompositeDisposable mCompositeDisposable = new CompositeDisposable();

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_news);
        initView();
    }

    private void initView() {
        Button btRefresh = (Button) findViewById(R.id.bt_refresh);
        btRefresh.setOnClickListener(new View.OnClickListener() {

            @Override
            public void onClick(View v) {
                refreshArticle(++mCurrentPage);
            }
        });
        RecyclerView recyclerView = (RecyclerView) findViewById(R.id.rv_news);
        LinearLayoutManager layoutManager = new LinearLayoutManager(this);
        recyclerView.setLayoutManager(layoutManager);
        mNewsAdapter = new NewsAdapter(mNewsResultEntities);
        recyclerView.setAdapter(mNewsAdapter);
        refreshArticle(++mCurrentPage);
    }

    private void refreshArticle(int page) {
       Observable<List<NewsResultEntity>> observable = Observable.just(page).subscribeOn(Schedulers.io()).flatMap(new Function<Integer, ObservableSource<List<NewsResultEntity>>>() {

            @Override
            public ObservableSource<List<NewsResultEntity>> apply(Integer page) throws Exception {
                Observable<NewsEntity> androidNews = getObservable("Android", page);
                Observable<NewsEntity> iosNews = getObservable("iOS", page);
                return Observable.zip(androidNews, iosNews, new BiFunction<NewsEntity, NewsEntity, List<NewsResultEntity>>() {

                    @Override
                    public List<NewsResultEntity> apply(NewsEntity androidEntity, NewsEntity iosEntity) throws Exception {
                        List<NewsResultEntity> result = new ArrayList<>();
                        result.addAll(androidEntity.getResults());
                        result.addAll(iosEntity.getResults());
                        return result;
                    }
                });
            }
        });
        DisposableObserver<List<NewsResultEntity>> disposable = new DisposableObserver<List<NewsResultEntity>>() {

            @Override
            public void onNext(List<NewsResultEntity> value) {
                mNewsResultEntities.clear();
                mNewsResultEntities.addAll(value);
                mNewsAdapter.notifyDataSetChanged();
            }

            @Override
            public void onError(Throwable e) {

            }

            @Override
            public void onComplete() {

            }
        };
        observable.observeOn(AndroidSchedulers.mainThread()).subscribe(disposable);
        mCompositeDisposable.add(disposable);
    }

    private Observable<NewsEntity> getObservable(String category, int page) {
        NewsApi api = new Retrofit.Builder()
                .baseUrl("http://gank.io")
                .addConverterFactory(GsonConverterFactory.create())
                .addCallAdapterFactory(RxJava2CallAdapterFactory.create())
                .build().create(NewsApi.class);
        return api.getNews(category, 10, page);
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        mCompositeDisposable.clear();
    }
}

运转结果吗:

新濠娱乐 3

老三、示例解析

有关什么用Retrofit + RxJava前已经说得比较清楚了,下面我们最主要介绍一下新接触的少数只操作符,flatMapzip

3.1 flatMap

flatMap的规律图如下所示:

新濠娱乐 4

它们接受一个Function函数,对于上游发送的每个事件它还见面下该函数,这个函数返回一个初的Observable,如果发生多单Observable,那么他会见发送合并后的结果。

以方的事例中,上游的just发送一个要的所在页数,我们根据此页数再失创造一个初的Observable来发送数据。

3.2 zip

zip操作符的原理图如下所示:

新濠娱乐 5

她接受多只Observable,以及一个函数,该函数的形参为这些Observable出殡的数额,并且要对等所有的Observable都发出完会后才见面回调该函数。

通过zip操作符,我们即便足以兑现等待多只大网要完成再返回的需要,例如当上头的例子中,我们见面等待AndroidiOS类的新闻请求都归后,再统一它们的结果发送给下游,在界面上出示。


再多篇,欢迎访问我之 Android 知识梳理系列:

  • Android
    知识梳理目录:http://www.jianshu.com/p/fd82d18994ce
  • 个人主页:http://lizejun.cn
  • 民用知识总结目录:http://lizejun.cn/categories/
网站地图xml地图