基于Retrofit扩展一个统一处理网络请求的CallBack


声明:本文转载自https://my.oschina.net/xiaolei123/blog/1591244,转载目的在于传递更多信息,仅供学习交流之用。如有侵权行为,请联系我,我会及时删除。

##思路 首先我们来思考几个场景: >- 场景一、 每次网络请求,都不能保证成功,如果你现在正在请求一段数据是为了加载一段网络列表,你在加载成功那里,把显示“正在加载”字样的View控件隐藏掉,那么如果请求失败,你是否还要再写一遍?? >- 场景二、 在APP请求网络过程中,难免遇到网络异常的情况,如果请求失败,就给用户一个比较友好的提示,比如 ‘网络开小差啦~’ 之类的提示。那么你是否每次请求都去写一遍 ‘网络开小差~’之类的提示语呢?? >- 场景三、 有时候用户的手机网络卡,当他打开一个页面发现数据很久都没有刷新出来,等的不耐烦就关闭了界面,当他关闭界面之后网络突然好了,这时候如果还按照你设定的流程走,会不会出现难以预料的问题呢? >- 场景四、 你现在在做一个有登录功能的APP,这时你的后台人员跑过来跟你说,后台返回来的数据中,某一个字段如果为一个特定的值,你就去自动打开某个页面(譬如:当isLogin=false的时候,要你去自动打开登录页面。当isBank=true的时候,需要自动打开银行卡页面。等等……)。那么你是会怎么去处理这些看似 “变态” 实际却很常用的需求呢?

以上场景是我们在APP开发中经常遇到的情况,那么我们接下来的代码,就是要解决这样的需求,我们要用最少的代码来完成最绕的需求。 ##代码篇 >- 1 : 由于篇章关系,这里不会贴出全部代码,但是会贴出主要关键代码,完整代码将在文章结尾贴出。 >- 2 : 本篇章适用于已经熟悉了**Retrofit的基本使用的人,所以如果对Retrofit都不会的话,建议先去熟悉一下Retrofit的基本使用。 ###解决场景一的需求: 我们当然不会每个成功或者失败的回调都去写一遍对“加载中”字样的控件的操作,这里封装了一个onFinally()方法,不管是网络请求成功,还是网络请求失败,都会去调用一次onFinally** 所以,我们可以把对控件的统一操作事件写在**onFinally**里面(譬如:将下拉刷新控件的加载中的状态,修改为加载完成的状态)

Net net = retrofitBase.getRetrofit().create(Net.class); Call<DataBean> call = net.getIndex(city); call.enqueue(new SCallBack<DataBean>(this) {     @Override     public void onSuccess(@NonNull DataBean result) throws Exception     {         Log.d("MainActivity", "onSuccess:"+result.getLat());     }          @Override     public void onCache(@NonNull DataBean result) throws Exception     {         Log.d("MainActivity", "onCache");     }          @Override     public void onFail(Throwable t)     {         super.onFail(t);         Log.d("MainActivity", "onFail:");     }          @Override     public void onFinally()     {         Log.d("MainActivity", "onFinally");     } }); 
  • 1 : 使用SICallBack,或者SCallBack 来替换Retrofit的CallBack,SCallBack 实现于SICallBack。
  • 2 : 传入上下文,支持传入的类型是:Context Fragment v4.app.Fragment
  • 3 : 重写**onFinally()**方法 。

###解决场景二的需求: 对于这种统一的网络出错提示,这里提供了一个统一处理方式。

import android.content.Context; import android.widget.Toast;  import com.xiaolei.exretrofitcallback.network.common.IFailEvent; import com.xiaolei.exretrofitcallback.network.common.SICallBack; /**  * Created by xiaolei on 2017/12/15.  */ public class MyFailEvent implements IFailEvent {     @Override     public void onFail(SICallBack callBack, Throwable t, Context context)     {         Toast.makeText(context, "哇哦~,您的网络有问题哦~", Toast.LENGTH_SHORT).show();     } } 
  • 1 : 新建一个类,实现IFailEvent接口。
  • 2 : 重写onFail方法。
  • 3 : 把类设置到Config里面去:Config.setFailedEventClass(MyFailEvent.class);

有人可能会说,你都定义封装好了,那如果我这个接口比较特殊,不想用这种统一的处理方式呢?? 这种情况的确存在,所以,如果您在某个接口不想使用统一的错误处理方式。那么在调用SICallBack的时候,重写 onFail(Throwable t)方法,并且不调用 super.onFail(Throwable t),那么就不会走统一处理的方式。

###解决场景三的需求: 这里就是一个网络请求慢,但是界面已经关闭的处理需求。 在**SICallBack**里面默认对Activity进行了判断,如果界面已经关闭,那么就算成功之后,还去更新界面UI已经失去意义,所以不会去执行onSuccess ,onFail,onFinally,方法。

@Override public void onFailure(Call<T> call, Throwable t) {     if (checkActivityFinish())         return;     try     {         onFail(t);     } finally     {         onFinally();     } } 
  • SICallBack里面,默认已经对本需求进行了处理。

###解决场景四的需求: 这个需求在很多APP里面都需要这种功能,有的人称之为路由之间的跳转。这里给一个例子:

import android.content.Context; import android.support.annotation.Nullable; import android.util.Log;  import com.xiaolei.exretrofitcallback.network.regist.OnCallBack; import com.xiaolei.exretrofitcallback.network.regist.ResponseBeanRegister; import com.xiaolei.exretrofitcallbackexample.Net.DataBean;  /**  * 这里是对地址进行拦截  * 如果是兰州市的地址,运行兰州市的方法,且不再执行onSuccess方法。  * 如果是深圳市的地址,运行深圳市的方法,不拦截,继续执行onSuccess方法。  * Created by xiaolei on 2017/12/15.  */  public class MyRegister extends ResponseBeanRegister<DataBean> {     @Nullable     @Override     public String filter(DataBean bean)     {         return bean.getLat();     }          @OnCallBack(value = "36.06108")//兰州市     public void onInLanzhou(Context context)     {         Log.d("MainActivity", "拦截:兰州市");     }      @OnCallBack(value = "22.54309",stopNextStep = false)//深圳市     public void onInShenzhen(Context context)     {         Log.d("MainActivity", "拦截:深圳市");     }      } 
  • 1、 :新建一个类,继承**ResponseBeanRegister&lt;T&gt;**,泛型里,则写上你的本地请求返回数据的类型,比如:一个Bean,或者,String 字符串。
  • 2、 :你的每次网络请求成功后都会自动调用这个onfilter方法,所以需要重写**String filter(T bean);**方法。返回的数据则是你需要去判断的数据。比如:你的泛型是DataBean,你需要判断DataBean里面 lat字段的值,那么你就应该这么写:
@Nullable @Override public String filter(DataBean bean) {     return bean.getLat(); } 
  • 3、 : 定义一个方法,使用用**@OnCallBack**去注解,示例如下:
@OnCallBack(value = "22.54309",stopNextStep = false)//深圳市 public void onInShenzhen(Context context) {     Log.d("MainActivity", "拦截:深圳市"); } 

这里有2个需要注意的: ①:OnCallBack里面,有两个参数,第一个参数value是用来比较的值,当onfilter方法返回的值等于value的时候,则会自动调用当前方法,第二个参数stopNextStep是一个布尔值,不写默认为true。当为true的时候,则当调用完本方法,不再调用onSuccess方法。当为false,则会继续调用onSuccess方法。 >stopNextStep = false -> 本方法 -> onSuccess -> onFinally >stopNextStep = true -> 本方法 -> onFinally

②:对于定义的方法的参数,支持两个,一个是CallBack的返回的参数,一个则是Context上下文。 支持自动注入值的参数类型

  • 4、 :在Config里注册:Config.registResponseBean(DataBean.class,MyRegister.class);//路由之间跳转的注册 。可注册多个Bean以及对应的ResponseRegister.

#结尾 移步这里获取Demo以及完整关键源码: Gtihub:https://github.com/xiaolei123/ExRetrofitCallback

gradle直接使用:

compile 'com.xiaolei:ExRetrofitCallBack:1.0.1' 

本文发表于2017年12月18日 10:38
(c)注:本文转载自https://my.oschina.net/xiaolei123/blog/1591244,转载目的在于传递更多信息,并不代表本网赞同其观点和对其真实性负责。如有侵权行为,请联系我们,我们会及时删除.

阅读 12369 讨论 8 喜欢 1

抢先体验

扫码体验
趣味小程序
文字表情生成器

闪念胶囊

你要过得好哇,这样我才能恨你啊,你要是过得不好,我都不知道该恨你还是拥抱你啊。

直抵黄龙府,与诸君痛饮尔。

那时陪伴我的人啊,你们如今在何方。

不出意外的话,我们再也不会见了,祝你前程似锦。

这世界真好,吃野东西也要留出这条命来看看

快捷链接
网站地图
提交友链
Copyright © 2016 - 2021 Cion.
All Rights Reserved.
京ICP备2021004668号-1