Android:Retrofit 结合 揽胜极光xJava的优雅使用(含实例教程)

5.1 互连网请求轮询(无条件)

  • 需求境况表明

示意图


3. 有血有肉贯彻

上边,作者将组成 RetrofitRxJava 达成 有标准化的轮询须求

1. Retrofit 简介

示意图

尤其注意:

  • 确切的话,Retrofit 是三个 RESTful 的 HTTP 互联网请求框架的卷入。
  • 原因:互连网请求的干活精神上是 OkHttp 落成,而 Retrofit 仅负责
    互联网请求接口的卷入

关于Retrofit的愈发详实介绍请看小说:那是一份很详细的 Retrofit 2.0
使用教程(含实例讲解)


4. Demo地址

Carson_Ho的Github地址 =
TiguanxJava2实战连串:有标准的轮询

有关无条件的互连网请求轮询,具体请看小说Android 卡宴xJava
实际运用讲解:互联网请求轮询


4.4 测试结果

示意图

接下去的手续均在RxJavafixRxjava.java内完结(请看注释)

RxJavafixRxjava.java

public class RxJavafixRetrofit extends AppCompatActivity {

    private static final String TAG = "Rxjava";

    // 设置变量 = 模拟轮询服务器次数
    private int i = 0 ;

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

                        // 步骤1:创建Retrofit对象
                        Retrofit retrofit = new Retrofit.Builder()
                                .baseUrl("http://fy.iciba.com/") // 设置 网络请求 Url
                                .addConverterFactory(GsonConverterFactory.create()) //设置使用Gson解析(记得加入依赖)
                                .addCallAdapterFactory(RxJava2CallAdapterFactory.create()) // 支持RxJava
                                .build();

                        // 步骤2:创建 网络请求接口 的实例
                        GetRequest_Interface request = retrofit.create(GetRequest_Interface.class);

                        // 步骤3:采用Observable<...>形式 对 网络请求 进行封装
                        Observable<Translation> observable = request.getCall();

                        // 步骤4:发送网络请求 & 通过repeatWhen()进行轮询
                        observable.repeatWhen(new Function<Observable<Object>, ObservableSource<?>>() {
                            @Override
                            // 在Function函数中,必须对输入的 Observable<Object>进行处理,此处使用flatMap操作符接收上游的数据
                            public ObservableSource<?> apply(@NonNull Observable<Object> objectObservable) throws Exception {
                                // 将原始 Observable 停止发送事件的标识(Complete() /  Error())转换成1个 Object 类型数据传递给1个新被观察者(Observable)
                                // 以此决定是否重新订阅 & 发送原来的 Observable,即轮询
                                // 此处有2种情况:
                                // 1. 若返回1个Complete() /  Error()事件,则不重新订阅 & 发送原来的 Observable,即轮询结束
                                // 2. 若返回其余事件,则重新订阅 & 发送原来的 Observable,即继续轮询
                                return objectObservable.flatMap(new Function<Object, ObservableSource<?>>() {
                                    @Override
                                    public ObservableSource<?> apply(@NonNull Object throwable) throws Exception {

                                        // 加入判断条件:当轮询次数 = 5次后,就停止轮询
                                        if (i > 3) {
                                            // 此处选择发送onError事件以结束轮询,因为可触发下游观察者的onError()方法回调
                                            return Observable.error(new Throwable("轮询结束"));
                                        }
                                        // 若轮询次数<4次,则发送1Next事件以继续轮询
                                        // 注:此处加入了delay操作符,作用 = 延迟一段时间发送(此处设置 = 2s),以实现轮询间间隔设置
                                        return Observable.just(1).delay(2000, TimeUnit.MILLISECONDS);
                                    }
                                });

                            }
                        }).subscribeOn(Schedulers.io())               // 切换到IO线程进行网络请求
                                .observeOn(AndroidSchedulers.mainThread())  // 切换回到主线程 处理请求结果
                                .subscribe(new Observer<Translation>() {
                                    @Override
                                    public void onSubscribe(Disposable d) {
                                    }

                                    @Override
                                    public void onNext(Translation result) {
                                        // e.接收服务器返回的数据
                                        result.show() ;
                                        i++;
                                    }

                                    @Override
                                    public void onError(Throwable e) {
                                        // 获取轮询结束信息
                                        Log.d(TAG,  e.toString());
                                    }

                                    @Override
                                    public void onComplete() {

                                    }
                                });

                    }
    }

前言

  • Andrroid付出中,互连网请求卓殊常用,而在Android互连网请求库中,Retrofit是当时最热的七个网络请求库

Github截图

  • Retrofit所以作为明天最风靡的网络请求库,其中贰个第一缘由是:支持RxJavaRxjava由于其依照事件流的链式调用、逻辑简洁
    & 使用不难
    的特点,深受各大 Android开发者的迎接。

Github截图

  • 今天,小编将为大家带来 Retrofit
    结合Rxjava骨子里利用案例教学,即大规模开发使用场景落成
    ,希望大家会欣赏。

正文紧要依据Retrofit 2.0 & Rxjava 2.0

  1. 本种类小说紧要基于 Rxjava 2.0
  2. 接下去的时日,作者将处处推出 AndroidRxjava 2.0
    的一文山会海小说,包罗原理、操作符、应用场景、背压等等

    ,有趣味可以一连关切Carson_Ho的安卓开发笔记!!

示意图


目录

示意图


a. 用于描述互连网请求 的接口设置

// 传统方式:Call<..>接口形式
public interface GetRequest_Interface {
 @GET("url地址")
    Call<Translation> getCall();
    // 注解里传入 网络请求 的部分URL地址
    // getCall()是接受网络请求数据的方法
}

//  RxJava 方式:Observable<..>接口形式
 @GET("url地址")
public interface GetRequest_Interface {
Observable<Translation> getCall();

欢迎关心Carson_Ho的简书!

不定期分享有关安卓开发的干货,追求短、平、快,但却不缺深度

5. 事实上开销须求案例

  • 下边,作者将采用Retrofit &
    RxJava,并结合实际的付出需求处境进行案例的教学
  • 教学的莫过于付出要求处境包含:

示意图

5. 总结

  • 正文紧要教授了
    Rxjava开创操作符的实在开发须求境况:有原则轮询须求
    ,并结合RetrofitRxJava 实现
  • 下边小编将构成 事实上处境应用 &
    Rxjava的连带应用框架(如RetrofitEventbus
    ,继续对
    AndroidRxjava 的实在支出须要情状举办浓厚讲解
    ,有趣味可以延续关切Carson_Ho的安卓开发笔记


请点赞!因为您的砥砺是自家创作的最大引力!

连锁小说阅读


步骤3:创制 用于描述网络请求 的接口

采用 注解 + Observable<...>接口描述 互联网请求参数

GetRequest_Interface.java

public interface GetRequest_Interface {

    @GET("ajax.php?a=fy&f=auto&t=auto&w=hi%20world")
    Observable<Translation> getCall();
     // 注解里传入 网络请求 的部分URL地址
    // Retrofit把网络请求的URL分成了两部分:一部分放在Retrofit对象里,另一部分放在网络请求接口里
    // 如果接口里的url是一个完整的网址,那么放在Retrofit对象里的URL可以忽略
    // 采用Observable<...>接口 
    // getCall()是接受网络请求数据的方法
}

手续1: 添加凭借

a. 在 Gradle加入Retrofit库的看重性

build.gradle

dependencies {

// Android 支持 Rxjava
// 此处一定要注意使用RxJava2的版本
compile 'io.reactivex.rxjava2:rxjava:2.0.1'
compile 'io.reactivex.rxjava2:rxandroid:2.0.1'

// Android 支持 Retrofit
compile 'com.squareup.retrofit2:retrofit:2.1.0'

// 衔接 Retrofit & RxJava
// 此处一定要注意使用RxJava2的版本
compile 'com.jakewharton.retrofit:retrofit2-rxjava2-adapter:1.0.0'

// 支持Gson解析
compile 'com.squareup.retrofit2:converter-gson:2.1.0'

}

b. 添加 网络权限
AndroidManifest.xml

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

欢迎关心Carson_Ho的简书!

不定期分享有关安卓开发的干货,追求短、平、快,但却不缺深度

3.1 步骤表达

  1. 增加凭借
  2. 始建 接收服务器重返数据 的类
  3. 开创 用于描述网络请求 的接口(不一致于Retrofit价值观花样)
  4. 创建 Retrofit 实例
  5. 始建 网络请求接口实例 并
    配置互联网请求参数(不一致于Retrofit价值观格局)
  6. 发送网络请求(差别于Retrofit价值观方式)
  7. 发送互连网请求
  8. 对回到的数码开展处理

本实例侧重于表达 RxJava
的轮询须要,关于Retrofit的利用请看小说:那是一份很详细的 Retrofit
2.0 使用教程(含实例讲解)

5.4 网络请求出错重连

  • 需求情况
示意图
  • 效果必要表达

示意图

  • 功效逻辑

示意图


3.2 步骤已毕

4.2 步骤表明

  1. 累加借助
  2. 开创 接收服务器重返数据 的类
  3. 创办 用于描述互连网请求 的接口(不一致于古板花样)
  4. 创建 Retrofit 实例
  5. 始建 网络请求接口实例 并 配置互联网请求参数(分裂于古板样式)
  6. 发送网络请求(不同于古板花样)
  7. 发送网络请求
  8. 对回到的数量开展处理

本实例侧重于表达 RxJava
的线程控制,关于Retrofit的利用请看小说:那是一份很详细的 Retrofit
2.0 使用教程(含实例讲解)

前言

  • Rxjava,由于其据悉事件流的链式调用、逻辑简洁 &
    使用简便
    的性状,深受各大 Android开发者的欢迎。

Github截图

尽管还连连解汉兰达xJava,请看小说:Android:那是一篇 清晰 & 易懂的锐界xjava
入门教程

  • RxJava那样受欢迎的原因,在于其提供了丰裕 &
    功用强大的操作符,大概能做到具有的功用须要
  • 前几日,小编将为大家带来
    Rxjava开创操作符的实际上花费须求处境:有标准的轮询须要
    ,并结合RetrofitRxJava 达成,希望我们会欣赏。
  1. 本种类作品主要遵照 Rxjava 2.0
  2. 接下去的年华,本身将不止推出 AndroidRxjava 2.0
    的一多级作品,包含原理、操作符、应用场景、背压等等

    ,有趣味可以持续关心Carson_Ho的安卓开发笔记!!

示意图


4.1 功用表明

  • 贯虱穿杨效益:将中文翻译成英文 – > 显示到界面
  • 贯彻方案:采取Get方式对 金山词霸API 发送互联网请求
  1. 先切换来工作线程 发送互联网请求
  2. 再切换来主线程进行 UI更新

金山词典

2. 效益表达

采用Get主意对 金山词霸API 按规定时间另行发送网络请求,从而模拟 轮询
须求完毕

  1. 终止轮询的尺度 = 当轮询到第4次时
  2. 采用 Gson 进行多少解析

金山词典


4.3 步骤完结

1. 要求境况

示意图

注:关于 Rxjava中的repeatWhen() 操作符的应用请看文章Android
猎豹CS6xJava:功效性操作符 周到授课


2. RxJava简介

示意图

关于RxJava的愈来愈详实介绍请看小说:Android Odysseyxjava:那是一篇 清晰 &
易懂的Rubiconxjava 入门教程


步骤2:创制 接收服务器重返数据 的类
  • 金山词霸API 的多少格式表达如下:

// URL模板
http://fy.iciba.com/ajax.php

// URL实例
http://fy.iciba.com/ajax.php?a=fy&f=auto&t=auto&w=hello%20world

// 参数说明:
// a:固定值 fy
// f:原文内容类型,日语取 ja,中文取 zh,英语取 en,韩语取 ko,德语取 de,西班牙语取 es,法语取 fr,自动则取 auto
// t:译文内容类型,日语取 ja,中文取 zh,英语取 en,韩语取 ko,德语取 de,西班牙语取 es,法语取 fr,自动则取 auto
// w:查询内容
  • 示例

API格式说明

  • 根据 金山词霸API 的数目格式,创建 接收服务器重返数据 的类:

Translation.java

public class Translation {

    private int status;

    private content content;
    private static class content {
        private String from;
        private String to;
        private String vendor;
        private String out;
        private int errNo;
    }

    //定义 输出返回数据 的方法
    public void show() {
        Log.d("RxJava", content.out );
    }
}

6. Demo地址

上述所有案例的源代码都存放在:Carson_Ho的Github地址 =
Retrofit结合汉兰达xJava实战体系


步骤3:创制 用于描述互连网请求 的接口

采用 注解 + Observable<...>接口描述 网络请求参数

GetRequest_Interface.java

public interface GetRequest_Interface {

    @GET("ajax.php?a=fy&f=auto&t=auto&w=hi%20world")
    Observable<Translation> getCall();
     // 注解里传入 网络请求 的部分URL地址
    // Retrofit把网络请求的URL分成了两部分:一部分放在Retrofit对象里,另一部分放在网络请求接口里
    // 如果接口里的url是一个完整的网址,那么放在Retrofit对象里的URL可以忽略
    // 采用Observable<...>接口 
    // getCall()是接受网络请求数据的方法
}

3. 二者结合使用

  • Retrofit于是作为当今最盛行的互联网请求库,其中三个紧要缘由是:支持RxJava

即:Retrofit除外提供古板的网络请求方式外,还提供 RxJava 版本的
互联网请求形式

  • 二种方式在接纳上最大的区分在于:古板方法使用了 Callback
    接口,而RxJava 格局则接纳了Observable接口。主要反映在:

    1. 用来描述网络请求 的接口 的设置
    2. 网络请求的包装格局 & 发送方式

3.3 测试结果

示意图


5.5 合并数据源 & 统一突显

  • 需要情形

示意图

至此,关于Retrofit & RxJava的实在支付须求情况讲解甘休。


4. 基础运用

下边,小编将接纳最基础的 Retrofit + RxJava 已毕 网络请求 的效用

请点赞!因为您的鼓励是本人创作的最大引力!

连带小说阅读


b. 网络请求的包装格局 & 发送形式各异

<-- 传统方式 ->>
        // 1. 创建 网络请求接口 的实例
        GetRequest_Interface request = retrofit.create(GetRequest_Interface.class);

        // 2. 采用Call<..>接口 对 发送请求 进行封装
        Call<Translation> call = request.getCall();

        // 3. 发送网络请求(异步)
        call.enqueue(new Callback<Translation>() {
            // 请求成功时回调
            @Override
            public void onResponse(Call<Translation> call, Response<Translation> response) {
                 ...  
            }

            // 请求失败时回调
            @Override
            public void onFailure(Call<Translation> call, Throwable throwable) {
                ....
            }
        });


<-- RxJava 版方式 ->>
        // 1. 创建 网络请求接口 的实例
        GetRequest_Interface request = retrofit.create(GetRequest_Interface.class);

        // 2. 采用Observable<...>形式 对 网络请求 进行封装
        Observable<Translation> observable = request.getCall();

        // 3. 发送网络请求(异步)
        observable.subscribeOn(Schedulers.io())               // 在IO线程进行网络请求
                  .observeOn(AndroidSchedulers.mainThread())  // 回到主线程 处理请求结果
                  .subscribe(new Observer<Translation>() {

                    // 发送请求后调用该复写方法(无论请求成功与否)
                    @Override
                    public void onSubscribe(Disposable d) {
                        ...// 初始化工作
                      }

                    // 发送请求成功后调用该复写方法
                    @Override
                    public void onNext(Translation result) {
                        ...// 对返回结果Translation类对象 进行处理
                    }

                    // 发送请求成功后,先调用onNext()再调用该复写方法
                    @Override
                    public void onComplete() {
                        Log.d(TAG, "请求成功");
                    }
                    // 发送请求失败后调用该复写方法
                    @Override
                    public void onError(Throwable e) {
                        Log.d(TAG, "请求失败");
                    }

                });
    }

接下去的步调均在MainActivity.java内已毕(请看注释)

MainActivity.java

public class MainActivity extends AppCompatActivity {

    private static final String TAG = "Rxjava";

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

        //步骤4:创建Retrofit对象
        Retrofit retrofit = new Retrofit.Builder()
                .baseUrl("http://fy.iciba.com/") // 设置 网络请求 Url
                .addConverterFactory(GsonConverterFactory.create()) //设置使用Gson解析(记得加入依赖)
                .addCallAdapterFactory(RxJava2CallAdapterFactory.create()) // 支持RxJava
                .build();

        // 步骤5:创建 网络请求接口 的实例
        GetRequest_Interface request = retrofit.create(GetRequest_Interface.class);

        // 步骤6:采用Observable<...>形式 对 网络请求 进行封装
        Observable<Translation> observable = request.getCall();

        // 步骤7:发送网络请求
        observable.subscribeOn(Schedulers.io())               // 在IO线程进行网络请求
                  .observeOn(AndroidSchedulers.mainThread())  // 回到主线程 处理请求结果
                  .subscribe(new Observer<Translation>() {
                    @Override
                    public void onSubscribe(Disposable d) {
                        Log.d(TAG, "开始采用subscribe连接");
                    }

                    @Override
                    public void onNext(Translation result) {
                        // 步骤8:对返回的数据进行处理
                        result.show() ;
                    }

                    @Override
                    public void onError(Throwable e) {
                        Log.d(TAG, "请求失败");
                    }

                    @Override
                    public void onComplete() {
                        Log.d(TAG, "请求成功");
                    }
                });
    }
}

步骤1: 添加依靠

a. 在 Gradle加入Retrofit库的依靠

build.gradle

dependencies {

// Android 支持 Rxjava
// 此处一定要注意使用RxJava2的版本
compile 'io.reactivex.rxjava2:rxjava:2.0.1'
compile 'io.reactivex.rxjava2:rxandroid:2.0.1'

// Android 支持 Retrofit
compile 'com.squareup.retrofit2:retrofit:2.1.0'

// 衔接 Retrofit & RxJava
// 此处一定要注意使用RxJava2的版本
compile 'com.jakewharton.retrofit:retrofit2-rxjava2-adapter:1.0.0'

// 支持Gson解析
compile 'com.squareup.retrofit2:converter-gson:2.1.0'

}

b. 添加 网络权限
AndroidManifest.xml

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

5.2 网路请求轮询(有原则)

  • 须要意况

示意图


5.3 互联网请求嵌套回调

  • 背景
    内需开展嵌套网络请求:即在第3个网络请求成功后,继续再开展五遍互联网请求

如 先进行 用户注册 的互联网请求, 待注册成功后回再持续发送
用户登录 的网络请求

  • 冲突
    嵌套完成互连网请求较为复杂,即嵌套调用函数

上面体现的是整合 RetrofitRxJava的主干用法,即未用操作符前

// 发送注册网络请求的函数方法
    private void register() {
        api.register(new RegisterRequest())
                .subscribeOn(Schedulers.io())               //在IO线程进行网络请求
                .observeOn(AndroidSchedulers.mainThread())  //回到主线程去处理请求结果
                .subscribe(new Consumer<RegisterResponse>() {
                    @Override
                    public void accept(RegisterResponse registerResponse) throws Exception {
                        Toast.makeText(MainActivity.this, "注册成功", Toast.LENGTH_SHORT).show();
                        login();   //注册成功, 调用登录的方法
                    }
                }, new Consumer<Throwable>() {
                    @Override
                    public void accept(Throwable throwable) throws Exception {
                        Toast.makeText(MainActivity.this, "注册失败", Toast.LENGTH_SHORT).show();
                    }
                });
    }


// 发送登录网络请求的函数方法
private void login() {
        api.login(new LoginRequest())
                .subscribeOn(Schedulers.io())               //在IO线程进行网络请求
                .observeOn(AndroidSchedulers.mainThread())  //回到主线程去处理请求结果
                .subscribe(new Consumer<LoginResponse>() {
                    @Override
                    public void accept(LoginResponse loginResponse) throws Exception {
                        Toast.makeText(MainActivity.this, "登录成功", Toast.LENGTH_SHORT).show();
                    }
                }, new Consumer<Throwable>() {
                    @Override
                    public void accept(Throwable throwable) throws Exception {
                        Toast.makeText(MainActivity.this, "登录失败", Toast.LENGTH_SHORT).show();
                    }
                });
    }

4.5 Demo地址

Carson_Ho的Github地址 =
Retrofit结合福特ExplorerxJava实战种类:基础运用


7. 总结

  • 正文主要教学了Retrofit & RxJava的组合使用 & 实际开发须求已毕
  • 下边,作者将继续长远讲解 Rxjava 的其余实际开发需要场景
    (结合有关框架,如RxBindingEventbus),有趣味可以三番五次关切Carson_Ho的安卓开发笔记

目录

示意图


手续2:创设 接收服务器重返数据 的类
  • 金山词霸API 的数目格式表达如下:

// URL模板
http://fy.iciba.com/ajax.php

// URL实例
http://fy.iciba.com/ajax.php?a=fy&f=auto&t=auto&w=hello%20world

// 参数说明:
// a:固定值 fy
// f:原文内容类型,日语取 ja,中文取 zh,英语取 en,韩语取 ko,德语取 de,西班牙语取 es,法语取 fr,自动则取 auto
// t:译文内容类型,日语取 ja,中文取 zh,英语取 en,韩语取 ko,德语取 de,西班牙语取 es,法语取 fr,自动则取 auto
// w:查询内容
  • 示例

API格式表明

  • 依照 金山词霸API 的多寡格式,创制 接收服务器再次回到数据 的类:

Translation.java

public class Translation {
    private int status;

    private content content;
    private static class content {
        private String from;
        private String to;
        private String vendor;
        private String out;
        private int errNo;
    }

    //定义 输出返回数据 的方法
    public void show() {
        System.out.println( "Rxjava翻译结果:" + status);
        System.out.println("Rxjava翻译结果:" + content.from);
        System.out.println("Rxjava翻译结果:" + content.to);
        System.out.println("Rxjava翻译结果:" + content.vendor);
        System.out.println("Rxjava翻译结果:" + content.out);
        System.out.println("Rxjava翻译结果:" + content.errNo);
    }
}

相关文章