Rxjava + Retrofit网络请求封装

为什么说是代码提炼，而不是详解或是什么的呢，因为涉及的东西还真是比较多，要一点一点的讲，还真是一个很费工夫的事情。本人认为，先学会用得好用得爽了，道理后面就自然而然就通了。源代码（提取码：6u5y）

先看一下，这个优雅的实现，到底有多爽，那就要看在主线程中，我们调用接口获得数据，到底有多简洁了，如下看MainActivity.java：

package com.dingfang.org.httputildemo;

import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.view.View;
import android.widget.TextView;
import android.widget.Toast;

import com.dingfang.org.httputildemo.entity.Classfication;
import com.dingfang.org.httputildemo.http.RetrofitUtils;
import com.dingfang.org.httputildemo.http.request.ClassficationGet;
import com.dingfang.org.httputildemo.subscribers.ProgressSubscriber;

import java.util.List;

public class MainActivity extends AppCompatActivity {

    private MainActivity _this;

    TextView textView;

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

        init();
    }

    private void init() {
        _this = this;
        textView = (TextView) findViewById(R.id.text01);
    }

    public void doHttpRequest(View view) {
        //这个就是我们封装后的网络请求获取数据的部分，不能再简洁~~~此处，取代了传统的Handler接收处理数据的功能
        RetrofitUtils.getInstance().doHttp(new ClassficationGet(new ProgressSubscriber<List<Classfication>>(_this) {
            @Override
            public void onNext(List<Classfication> classfications) {
                //get datas and do something here
                Toast.makeText(_this, classfications.get(0).getTypeName(),Toast.LENGTH_SHORT).show();
                textView.setText(classfications.get(0).getTypeName());
            }

        }));
    }
}

activity_main.xml文件：

<?xml version="1.0" encoding="utf-8"?>
<android.support.constraint.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context="com.dingfang.org.httputildemo.MainActivity">

    <TextView
        android:id="@+id/text01"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Hello World!"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintLeft_toLeftOf="parent"
        app:layout_constraintRight_toRightOf="parent"
        app:layout_constraintTop_toTopOf="parent" />

    <Button
        android:onClick="doHttpRequest"
        android:text="发送请求"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />

</android.support.constraint.ConstraintLayout>

看吧，不能再简单了。这没有什么好解释的，那么接下来就看简洁背后的故事吧！
首当其冲RetrofitUtils，因为上面的MainActivity 中有用到该类。先看代码RetrofitUtils.java：

package com.dingfang.org.httputildemo.http;

import java.lang.reflect.Field;
import java.util.concurrent.TimeUnit;

import okhttp3.OkHttpClient;
import retrofit2.Retrofit;
import retrofit2.adapter.rxjava.RxJavaCallAdapterFactory;
import retrofit2.converter.gson.GsonConverterFactory;
import retrofit2.converter.scalars.ScalarsConverterFactory;
import rx.android.schedulers.AndroidSchedulers;
import rx.schedulers.Schedulers;

/**
 * 基本数据请求工具类
 */
public class RetrofitUtils {
    private static final int DEFAULT_TIMEOUT = 10;
    private RetrofitService retrofitService;
    private static RetrofitUtils INSTANCE;

    private RetrofitUtils(){
        retrofitService = create(RetrofitService.class);
    }

    /**
     * 暴露出去的单利模式
     * @return
     */
    public static RetrofitUtils getInstance(){
        if(INSTANCE == null){
            synchronized (RetrofitUtils.class){
                if(INSTANCE == null){
                    INSTANCE = new RetrofitUtils();
                }
            }
        }
        return INSTANCE;
    }


    /**
     * 创建被观察者 最终得到转化后的gson对象  如：User
     * @param service
     * @param <S>
     * @return
     */
    public <S> S create(Class<S> service) {
        Retrofit retrofit = new Retrofit.Builder()
                .client(getOkHttpClient())
                .addConverterFactory(GsonConverterFactory.create())
                .addCallAdapterFactory(RxJavaCallAdapterFactory.create())
                .baseUrl(getBaseUrl(service))
                .build();
        return retrofit.create(service);
    }

    /**
     * 创建被观察者 最终得到字符串对象    如："我时一个快乐的字符串"
     * @param service
     * @param <S>
     * @return
     */
    public <S> S create1(Class<S> service) {
        Retrofit retrofit = new Retrofit.Builder()
                .client(getOkHttpClient())
                .addConverterFactory(ScalarsConverterFactory.create())
                .addCallAdapterFactory(RxJavaCallAdapterFactory.create())
                .baseUrl(getBaseUrl(service))
                .build();
        return retrofit.create(service);
    }

    /**
     *通过反射得到该类中的基址字符串对象
     * @param service
     * @param <S>
     * @return
     */
    private <S> String getBaseUrl(Class<S> service) {
        try {
            Field field = service.getField("BASE_URL");// 此处只能解析service类中形如 String BASE_URL = ApiInterface.API;的参数
            return (String) field.get(service);
        } catch (Exception e) {
            e.printStackTrace();
        }
        return "";
    }

    /**
     * 这里配置okHttp请求配置
     * @return
     */
    private OkHttpClient getOkHttpClient() {
        //配置超时拦截器
        OkHttpClient.Builder builder = new OkHttpClient.Builder();
        builder.connectTimeout(DEFAULT_TIMEOUT, TimeUnit.SECONDS);
        builder.writeTimeout(DEFAULT_TIMEOUT, TimeUnit.SECONDS);
        builder.readTimeout(DEFAULT_TIMEOUT, TimeUnit.SECONDS);

        //配置log打印拦截器
//        HttpLoggingInterceptor loggingInterceptor = new HttpLoggingInterceptor();
//        loggingInterceptor.setLevel(HttpLoggingInterceptor.Level.BODY);
//        builder.addInterceptor(loggingInterceptor);
        return builder.build();
    }



    /**
     * post、get等请求
     * @param httpResultFunc
     */
    public void doHttp(HttpResultFunc httpResultFunc){
        //通过结果来获取 Observable、Subscriber
        httpResultFunc.getObservable(retrofitService)
                .subscribeOn(Schedulers.io())
                .unsubscribeOn(Schedulers.io())
                .observeOn(AndroidSchedulers.mainThread())
                .map(httpResultFunc)
                .subscribe(httpResultFunc.getSubscriber());
    }
}

这个类的封装，针对Retrofit的，亮点太多，自己细细品味。这里主要看这一段：

    public void doHttp(HttpResultFunc httpResultFunc){
        //通过结果来获取 Observable、Subscriber
        httpResultFunc.getObservable(retrofitService)
                .subscribeOn(Schedulers.io())
                .unsubscribeOn(Schedulers.io())
                .observeOn(AndroidSchedulers.mainThread())
                .map(httpResultFunc)
                .subscribe(httpResultFunc.getSubscriber());
    }

这里有一个HttpResultFunc 类，我看过好多大神的封装，觉得这个封装，是最让人拍案叫绝的封装方式，哈哈哈，原谅我自娱自乐一番~~~
下面看一看这个HttpResultFunc.java类：

package com.dingfang.org.httputildemo.http;

import com.dingfang.org.httputildemo.entity.ResponseResult;
import com.dingfang.org.httputildemo.exception.ResultErrorException;

import rx.Observable;
import rx.Subscriber;
import rx.functions.Func1;

/**
 * 所有基本数据请求实体类基类，必须继承自该类
 */
public abstract class HttpResultFunc<T> implements Func1<ResponseResult<T>,T> {

    @Override
    public T call(ResponseResult<T> tResponseResult) {
        //这里的判断，要看每个用户后台给的返回数据的格式和规范而定
        if(tResponseResult.getStatus()!=1){
            throw  new ResultErrorException(tResponseResult.getReturnMsg());
        }
        return tResponseResult.getResult();
    }

    public abstract Observable getObservable(RetrofitService retrofitService);

    public abstract Subscriber getSubscriber();

}

这个类实际上所有网路请求接口将Rxjava中观察者和被观察者结合起来的一个类。
下面可以来看看该类的一个实现类ClassficationGet.java：也就是具体调用接口的位置：

package com.dingfang.org.httputildemo.http.request;

import com.dingfang.org.httputildemo.http.HttpResultFunc;
import com.dingfang.org.httputildemo.http.RetrofitService;

import rx.Observable;
import rx.Subscriber;

/**
 * 用来写具体些网络请求的类，请求参数都在这里声明
 */

public class ClassficationGet extends HttpResultFunc {

    private Subscriber subscriber;

    public ClassficationGet(Subscriber subscriber) {
        this.subscriber = subscriber;
    }

    @Override
    public Observable getObservable(RetrofitService retrofitService) {
        return retrofitService.getClassfication();//调用接口
    }

    @Override
    public Subscriber getSubscriber() {
        return subscriber;
    }
}

上面说了，这个类是将Rxjava中观察者和被观察者结合起来的一个类。是不是很眼熟，当然了，这个类是调用接口的地方，那么不就是MainActivity中调用的那个类吗。
那么就来看一看被观察者吧RetrofitService.java，这个类实际上市接口声明的地方，代码如下：

package com.dingfang.org.httputildemo.http;

import com.dingfang.org.httputildemo.entity.Classfication;
import com.dingfang.org.httputildemo.entity.ResponseResult;

import java.util.List;

import retrofit2.http.GET;
import rx.Observable;

/**
 * 所有接口均写在该类下,类名不可修改，如需修改需在其他调用文件相应修改
 */
public interface RetrofitService {    

    //接口前缀
    public String BASE_URL = "http://www.ttreader.com/ecp/rest/xxx/";

    //具体请求的接口
    @GET("com.cloud.bizinterface.service.IOrgService.queryCustomTypeByTypeGid(typeGid)")
    Observable<ResponseResult<List<Classfication>>> getClassfication();

}

所有的接口，都可以写在RetrofitService.java这个类文件中。这里用到了ResponseResult类，这个是一个金典啊，把所有的请求结果，都以统一的格式给封装了，这个类一般会根据公司内具体的返回字段而确定。我公司的返回字段如下，代码如下：

package com.dingfang.org.httputildemo.entity;

/**
 * 数据请求结果统一预处理实体类（要求服务器返回数据统一格式）
 * 如数据格式为：
 *
 *    {
 *    "status": 0,
 *    "returnMsg": "成功",
 *    "result": {}
 *    }
 *
 * result字段可以是数组字符串等，根据需求而定。
 * 可以具体需求进行更改该类字段格式
 *
 */
public class ResponseResult<T> {

    private String returnMsg;
    private int status;
    private T result;

    public T getResult() {
        return result;
    }

    public void setResult(T result) {
        this.result = result;
    }


    public String getReturnMsg() {
        return returnMsg;
    }

    public void setReturnMsg(String returnMsg) {
        this.returnMsg = returnMsg;
    }

    public int getStatus() {
        return status;
    }

    public void setStatus(int status) {
        this.status = status;
    }

    @Override
    public String toString() {
        return "ResponseResult{" +
                "returnMsg='" + returnMsg + '\'' +
                ", status=" + status +
                ", result=" + result +
                '}';
    }
}

说完了被观察者，看面说说观察者，这里我的观察者，就是网络请求的圈圈，它观察的是网络请求的数据，在网络正常的情况下，若是数据没有到之前就转圈圈，给用户一个交互，由于这不是今天分享的内容的主要部分，就不细细分析了，直接看代码吧：

package com.dingfang.org.httputildemo.subscribers;

import android.content.Context;

import com.dingfang.org.httputildemo.progress.HHProgressAlertDialog;
import com.dingfang.org.httputildemo.progress.ProgressCancelListener;
import com.dingfang.org.httputildemo.utils.ToastUtils;

import java.lang.ref.WeakReference;
import java.net.ConnectException;
import java.net.SocketTimeoutException;

import rx.Subscriber;

/**
 * Created by：hcs on 2016/10/17 16:38
 * e_mail：aaron1539@163.com
 */
public abstract class ProgressSubscriber<T> extends Subscriber<T> implements ProgressCancelListener {

    private HHProgressAlertDialog progressAlertDialog;
    private ToastUtils toast;
    private boolean isShowProgress = true;
    private WeakReference<Context> contextWeakReference;

    /**
     *  默认显示弹出框，不可以取消
     * @param context
     */
    public ProgressSubscriber(Context context){
        contextWeakReference = new WeakReference<Context>(context);
        init(false);
    }

    /**
     * 可设置弹出框是否显示取消
     * @param context
     * @param isShowProgress 是否显示弹出框
     * @param isCancel 是否可以取消
     */
    public ProgressSubscriber(Context context, boolean isShowProgress, boolean isCancel){
        this.isShowProgress = isShowProgress;
        this.contextWeakReference = new WeakReference<Context>(context);
        init(isCancel);
    }

    /**
     * 初始化
     * @param isCancel
     */
    private void init(boolean isCancel) {
        Context context = contextWeakReference.get();
        progressAlertDialog = new HHProgressAlertDialog(context);
        progressAlertDialog.setCancelable(isCancel);
        toast = new ToastUtils(context);
    }

    private void showProgress(){
        if(!isShowProgress){
            return;
        }
        if(progressAlertDialog!=null){
            if(!progressAlertDialog.isShowing()){
                progressAlertDialog.show();
            }
        }
    }

    private void dismissProgress(){
        if(!isShowProgress){
            return;
        }
        if(progressAlertDialog!=null){
            if(progressAlertDialog.isShowing()){
                progressAlertDialog.dismiss();
            }
        }
    }

    @Override
    public void onStart() {
        showProgress();
    }

    @Override
    public void onCompleted() {
        dismissProgress();
    }

    @Override
    public void onError(Throwable e) {
        if (e instanceof SocketTimeoutException) {
            toast.showSingleToast("网络中断，请检查您的网络状态");
        } else if (e instanceof ConnectException) {
            toast.showSingleToast("网络中断，请检查您的网络状态");
        } else {
            toast.showSingleToast("error:" + e.getMessage());
        }
        dismissProgress();
    }

    @Override
    public void onCancelProgress() {
        if(!this.isUnsubscribed()){
            this.unsubscribe();
        }
    }
}

到此，在MainActivity中出现了的类，都已经列出来了，当然，还有些辅助类，没有列出来。详细代码可以参考源代码（提取码：6u5y）。
上面Rxjava的观察者和被观察者都出现了，Retrofit网络请求也贴出来了，今天的内容重点也就分享完了。是不是还不迷糊的。是的，那就下载demo跑起来看源码吧。

最后编辑于：2017.12.08 22:17:45

人面猴
序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
沈念sama阅读 211,884评论 6赞 492
死咒
序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
沈念sama阅读 90,347评论 3赞 385
救了他两次的神仙让他今天三更去死
文/潘晓璐我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
开封第一讲书人阅读 157,435评论 0赞 348
道士缉凶录：失踪的卖姜人
文/不坏的土叔我叫张陵，是天一观的道长。经常有香客问我，道长，这世上最难降的妖魔是什么？我笑而不...
开封第一讲书人阅读 56,509评论 1赞 284
港岛之恋（遗憾婚礼）
正文为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
茶点故事阅读 65,611评论 6赞 386
恶毒庶女顶嫁案：这布局不是一般人想出来的
文/花漫我一把揭开白布。她就那样静静地躺着，像睡着了一般。火红的嫁衣衬着肌肤如雪。梳的纹丝不乱的头发上，一...
开封第一讲书人阅读 49,837评论 1赞 290
城市分裂传说
那天，我揣着相机与录音，去河边找鬼。笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。我是一名探鬼主播，决...
沈念sama阅读 38,987评论 3赞 408
双鸳鸯连环套：你想象不到人心有多黑
文/苍兰香墨我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
开封第一讲书人阅读 37,730评论 0赞 267
万荣杀人案实录
序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
沈念sama阅读 44,194评论 1赞 303
护林员之死
正文独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋以下内容为张勋视角年9月15日...
茶点故事阅读 36,525评论 2赞 327
白月光启示录
正文我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
茶点故事阅读 38,664评论 1赞 340
活死人
序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
沈念sama阅读 34,334评论 4赞 330
日本核电站爆炸内幕
正文年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
茶点故事阅读 39,944评论 3赞 313
男人毒药：我在死后第九天来索命
文/蒙蒙一、第九天我趴在偏房一处隐蔽的房顶上张望。院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
开封第一讲书人阅读 30,764评论 0赞 21
一桩弑父案，背后竟有这般阴谋
文/苍兰香墨我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。一阵脚步声响...
开封第一讲书人阅读 31,997评论 1赞 266
情欲美人皮
我被黑心中介骗来泰国打工，没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。一个月前我还...
沈念sama阅读 46,389评论 2赞 360
代替公主和亲
正文我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
茶点故事阅读 43,554评论 2赞 349

Rxjava + Retrofit网络请求封装

推荐阅读更多精彩内容