Android 之路 (3) - 對Retrofit的封裝

引言

上篇中實現(xiàn)了MVP的改造,但是我們的網(wǎng)絡(luò)請求部分任然是比較冗余了谭溉,本篇將對Retrofit進行封裝墙懂。

正文

思路

對Retrofit進行封裝算是我們基礎(chǔ)框架的一部分,所以我們需要將這部分代碼封裝到 library-core 中扮念,對于封裝的實現(xiàn)思路如下:

  1. 將Retrofit的創(chuàng)建更改為單例模式創(chuàng)建损搬,增加可配置性,減少重復(fù)創(chuàng)建
  2. 將Service的創(chuàng)建也更改為單例模式

創(chuàng)建NetConfiger接口

既然是作為基礎(chǔ)框架的一部分柜与,那么在設(shè)計上面就需要高自由可配置巧勤,所以我們創(chuàng)建一個 NetConfiger 接口,用來進行 baseUrl旅挤、攔截器踢关、超時時間、debug等的配置粘茄、然后在 Application 中進行配置签舞,具體看以下代碼:

**
 * 網(wǎng)絡(luò)配置器
 * <p>在Application中使用</p>
 */
public interface NetConfiger {
    /**
     * 通用請求地址
     *
     * @return
     */
    String configBaseUrl();

    /**
     * 攔截器
     *
     * @return
     */
    Interceptor[] configInterceptors();

    /**
     * 連接超時時間
     *
     * @return
     */
    long configConnectTimeoutMills();

    /**
     * 讀取超時時間
     *
     * @return
     */
    long configReadTimeoutMills();


    /**
     * 是否調(diào)試模式
     *
     * @return
     */
    boolean configLogEnable();
}

創(chuàng)建BaseApi

創(chuàng)建BaseApi類秕脓,主要用來做Retrofit的生成和OkhttpClient的配置等,先看代碼:

/**
 * 基類  API
 */
public class BaseApi {
    /**
     * 網(wǎng)絡(luò)配置項
     */
    private static NetConfig mConfig = null;
    /**
     * mRetrofit
     */
    private Retrofit mRetrofit;
    /**
     * mClient
     */
    private OkHttpClient mClient;
    /**
     * 默認連接超時時間
     */
    private static final long DEFAULT_CONNECT_TIMEOUT_MILLS = 40 * 1000L;
    /**
     * 默認讀取超時時間
     */
    private static final long DEFAULT_READ_TIMEOUT_MILLS = 40 * 1000L;
    /**
     * 實例
     **/
    private static BaseApi instance;

    private BaseApi() {
        mRetrofit = null;
        mClient = null;
    }


    /**
     * 創(chuàng)建 Retrofit
     *
     * @return Retrofit
     */
    public static synchronized Retrofit createRetrofit() {
        return getInstance().getRetrofit();
    }


    /**
     * 單例 獲取
     *
     * @return BaseApi
     */
    private static synchronized BaseApi getInstance() {
        if (instance == null)
            instance = new BaseApi();
        return instance;
    }


    /**
     * 創(chuàng)建class
     *
     * @param service 服務(wù)class
     * @param <C>     類泛型
     * @return 泛型
     */
    public static <C> C get(Class<C> service) {
        return getInstance().getRetrofit().create(service);
    }


   /**
     * 注冊配置
     *
     * @param config
     */
    public static void registerConfig(NetConfig config) {
        BaseApi.mConfig = config;
        //賦值為空
        instance = null;
    }


    /**
     * 獲取Retrofit
     *
     * @return 獲取Retrofit
     */
    public Retrofit getRetrofit() {
        if (mRetrofit == null) {
            Retrofit.Builder builder = new Retrofit.Builder()
                    .baseUrl(mConfig.configBaseUrl())//配置BaseUrl
                    .client(getHttpClient())// 設(shè)置client
                    .addConverterFactory(GsonConverterFactory.create());//gson轉(zhuǎn)換器
            builder.addCallAdapterFactory(RxJava2CallAdapterFactory.create());
            mRetrofit = builder.build();
        }
        return mRetrofit;
    }


    /**
     * 獲取httpclient
     *
     * @return OkHttpClient
     */
    private OkHttpClient getHttpClient() {
        if (mClient == null) {
            OkHttpClient.Builder builder = new OkHttpClient.Builder();

            // 連接超時時間
            builder.connectTimeout(mConfig.configConnectTimeoutMills() != 0
                    ? mConfig.configConnectTimeoutMills()
                    : DEFAULT_CONNECT_TIMEOUT_MILLS, TimeUnit.MILLISECONDS);
            // 讀取超時時間
            builder.readTimeout(mConfig.configReadTimeoutMills() != 0
                    ? mConfig.configReadTimeoutMills() : DEFAULT_READ_TIMEOUT_MILLS, TimeUnit.MILLISECONDS);

            // 攔截器
            Interceptor[] interceptors = mConfig.configInterceptors();
            if (interceptors != null && interceptors.length > 0) {
                for (Interceptor interceptor : interceptors) {
                    builder.addInterceptor(interceptor);
                }
            }
            if (mConfig.configLogEnable()) {//配置打印
                HttpLoggingInterceptor logInterceptor = new HttpLoggingInterceptor();
                logInterceptor.setLevel(HttpLoggingInterceptor.Level.BODY);
                builder.addInterceptor(logInterceptor);
            }

            mClient = builder.build();
        }
        return mClient;
    }
}

具體方法說明如下:

registerConfig(NetConfig config)

進行網(wǎng)絡(luò)的相關(guān)配置吠架,在Application中進行調(diào)用

getHttpClient()

獲取和配置OkHttpClient

連接超時時間
讀取超時時間
自定義攔截器
請求日志攔截器

getRetrofit()

獲取Retrofit實例

配置BaseUrl
配置client
配置轉(zhuǎn)換器

其他略....

注冊相關(guān)配置

新建Application類在 AndroidManifest 中引用,并調(diào)用BaseApi的registerConfig搂鲫,傳入registerConfig的實例進行相關(guān)配置傍药,具體代碼如下:

public class DevApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        BaseApi.registerConfig(new NetConfig() {
            @Override
            public String configBaseUrl() {
                return "http://olrt5mymy.bkt.clouddn.com/";
            }

            @Override
            public Interceptor[] configInterceptors() {
                return new Interceptor[0];
            }

            @Override
            public long configConnectTimeoutMills() {
                return 45 * 1000;
            }

            @Override
            public long configReadTimeoutMills() {
                return 45 * 1000;
            }

            @Override
            public boolean configLogEnable() {
                return true;
            }
        });
    }
}

創(chuàng)建ServiceBuild類

在app的biz層中創(chuàng)建ServiceBuild類,主要是用來獲取service的實例魂仍。

/**
 * 服務(wù)獲取類
 */
public class ServiceBuild {
    /**
     * 用戶服務(wù)
     */
    private static UserService mUserService;

    /**
     * 獲取用戶服務(wù)
     */
    public static synchronized UserService getUserService() {
        if (null == mUserService) {
            mUserService = BaseApi.createRetrofit().create(UserService.class);
        }
        return mUserService;
    }
}

更改Presenter代碼

將LoginPresenter中創(chuàng)建Retrofit的代碼和創(chuàng)建service的代碼都去掉拐辽,換成調(diào)用ServiceBuild。

/**
 * 登陸Presenter
 */
public class LoginPresenter extends LoginContract.Presenter {

    private String TAG = "LoginPresenter";

    public LoginPresenter(LoginContract.View view) {
        super(view);
    }

    @Override
    public void login(String userName, String password) {
        // 開始請求
        Subscriber subscriber = ServiceBuild.getUserService()
                .login(userName, password)
                .subscribeOn(Schedulers.io())//運行在io線程
                .observeOn(AndroidSchedulers.mainThread())//回調(diào)在主線程
                .subscribeWith(new ResourceSubscriber<LoginDto>() {
                    @Override
                    public void onNext(LoginDto loginDto) {
                        //結(jié)果回調(diào)
                        Log.e(TAG, "onNext: " + loginDto);
                        if (loginDto.getCode() == 200) {
                            view.loginSuccess(loginDto);
                        } else {
                            view.loginFailure(loginDto.getMessage());
                        }

                    }

                    @Override
                    public void onError(Throwable t) {
                        Log.e(TAG, "onError: ");
                        view.loginFailure("登陸失敳磷谩:" + t.getMessage());
                    }

                    @Override
                    public void onComplete() {
                        Log.e(TAG, "onComplete: ");
                    }
                });
    }
}

移除了大部分代碼俱诸,Presenter看上去更加的簡潔和優(yōu)雅,接下來就運行起來看看效果吧赊舶。

查看效果

運行起來看看效果吧睁搭。

效果

效果和上章一致。

HttpLoggingInterceptor

HttpLoggingInterceptor 的作用可以說是非常的強大笼平,使用這個攔截器园骆,可以打印請求一切過程,包括請求頭寓调、請求體锌唾、請求參數(shù)、響應(yīng)頭等捶牢,對于接口對接中快速定位問題有很大的幫助鸠珠,具體看看截圖:

HttpLoggingInterceptor效果圖

結(jié)束

總結(jié)

  1. 分離了Retrofit的創(chuàng)建,減少了代碼的冗余秋麸,利用接口來做配置項,靈活性大大提升炬太。
  2. 獨立了Service的創(chuàng)建灸蟆,以后直接通過ServiceBuild的get方法進行獲取。
  3. 雖然增加了一部分的代碼亲族,但是隨著業(yè)務(wù)的增加炒考,實則減少代碼量。
  4. 大多數(shù)的Service都可以放到ServiceBuild中進行創(chuàng)建霎迫,方便統(tǒng)一管理斋枢。

問題

  1. RxJava線程轉(zhuǎn)換還能進一步的封裝。
  2. RxJava沒有取消訂閱知给。
  3. 訂閱的時候重寫的方法過于冗余瓤帚,可以去除描姚,做統(tǒng)一的訂閱結(jié)果管理。

最后

本系列的課程還遠著呢戈次,就關(guān)于這個登陸都還能再寫兩篇文章轩勘,敬請期待。

源碼-tag:0.3

微信公眾號

AndroidRookie
最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末怯邪,一起剝皮案震驚了整個濱河市绊寻,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌悬秉,老刑警劉巖澄步,帶你破解...
    沈念sama閱讀 217,277評論 6 503
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異和泌,居然都是意外死亡村缸,警方通過查閱死者的電腦和手機,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,689評論 3 393
  • 文/潘曉璐 我一進店門允跑,熙熙樓的掌柜王于貴愁眉苦臉地迎上來王凑,“玉大人,你說我怎么就攤上這事聋丝∷髋耄” “怎么了?”我有些...
    開封第一講書人閱讀 163,624評論 0 353
  • 文/不壞的土叔 我叫張陵弱睦,是天一觀的道長百姓。 經(jīng)常有香客問我,道長况木,這世上最難降的妖魔是什么垒拢? 我笑而不...
    開封第一講書人閱讀 58,356評論 1 293
  • 正文 為了忘掉前任,我火速辦了婚禮火惊,結(jié)果婚禮上求类,老公的妹妹穿的比我還像新娘。我一直安慰自己屹耐,他們只是感情好尸疆,可當我...
    茶點故事閱讀 67,402評論 6 392
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著惶岭,像睡著了一般寿弱。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上按灶,一...
    開封第一講書人閱讀 51,292評論 1 301
  • 那天症革,我揣著相機與錄音,去河邊找鬼鸯旁。 笑死噪矛,一個胖子當著我的面吹牛量蕊,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播摩疑,決...
    沈念sama閱讀 40,135評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼危融,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了雷袋?” 一聲冷哼從身側(cè)響起吉殃,我...
    開封第一講書人閱讀 38,992評論 0 275
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎楷怒,沒想到半個月后蛋勺,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 45,429評論 1 314
  • 正文 獨居荒郊野嶺守林人離奇死亡鸠删,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 37,636評論 3 334
  • 正文 我和宋清朗相戀三年抱完,在試婚紗的時候發(fā)現(xiàn)自己被綠了。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片刃泡。...
    茶點故事閱讀 39,785評論 1 348
  • 序言:一個原本活蹦亂跳的男人離奇死亡巧娱,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出烘贴,到底是詐尸還是另有隱情禁添,我是刑警寧澤,帶...
    沈念sama閱讀 35,492評論 5 345
  • 正文 年R本政府宣布桨踪,位于F島的核電站老翘,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏锻离。R本人自食惡果不足惜铺峭,卻給世界環(huán)境...
    茶點故事閱讀 41,092評論 3 328
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望汽纠。 院中可真熱鬧卫键,春花似錦、人聲如沸虱朵。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,723評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽卧秘。三九已至,卻和暖如春官扣,著一層夾襖步出監(jiān)牢的瞬間翅敌,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 32,858評論 1 269
  • 我被黑心中介騙來泰國打工惕蹄, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留蚯涮,地道東北人治专。 一個月前我還...
    沈念sama閱讀 47,891評論 2 370
  • 正文 我出身青樓,卻偏偏與公主長得像遭顶,于是被迫代替她去往敵國和親张峰。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 44,713評論 2 354

推薦閱讀更多精彩內(nèi)容

  • Android 自定義View的各種姿勢1 Activity的顯示之ViewRootImpl詳解 Activity...
    passiontim閱讀 172,102評論 25 707
  • 用兩張圖告訴你棒旗,為什么你的 App 會卡頓? - Android - 掘金 Cover 有什么料喘批? 從這篇文章中你...
    hw1212閱讀 12,723評論 2 59
  • 進入成年,就會發(fā)生成年人應(yīng)該做的事铣揉,摒棄幼稚饶深,天真,開始走向成熟逛拱。曾幾何時敌厘,天馬行空的一面,帶來快樂朽合,帶來幸福俱两,現(xiàn)...
    小花的能量閱讀 311評論 0 0
  • 釣魚舟閱讀 383評論 4 9
  • 我流浪了三十年,畏縮在文字里茍延殘喘曹步。待今天宪彩,拔起旱地上的荒草,明白埋在土地里面的肌膚之痛箭窜。草長鶯飛毯焕,斜陽落幕,我...
    甲申紀事dcl閱讀 683評論 0 1