手把手為你封裝一個(gè)MVP+RxJava+Retrofit2+Dagger2+BaseRecyclerView快速開(kāi)發(fā)框架，兩周一個(gè)版本不是夢(mèng)

距離我上次發(fā)表文章都有超過(guò)半年時(shí)間了，年前一直在復(fù)習(xí)，年后一段時(shí)間都在找工作，期間還去了一家公司三天，覺(jué)得不合適就溜了，感覺(jué)挺對(duì)不起那家公司的。最后等了一個(gè)多月（期間自己也有一段時(shí)間去了復(fù)習(xí)怎么做網(wǎng)頁(yè)）才入職一家比較知名的國(guó)企，拿到自己想要的薪水，也是對(duì)上一年自己學(xué)習(xí)成果的回報(bào)吧，也實(shí)現(xiàn)了自己不想再待在外包公司小小的愿望?，F(xiàn)在回想起2016剛畢業(yè)真的覺(jué)得有點(diǎn)苦，白天在外包公司工作量成倍的增長(zhǎng)，晚上還堅(jiān)持看書(shū)學(xué)習(xí)做筆記，最后真正實(shí)現(xiàn)了逃亡的目標(biāo)的時(shí)候自己也想放松一段日子，所以在2017年的上半年自己基本處于一種半頹廢的狀態(tài)，直到最近在新公司接到一個(gè)搭建新框架的任務(wù)才重新投入安卓的懷抱，2017年自己的計(jì)劃也正式的算是開(kāi)始了。
好吧，不扯個(gè)人經(jīng)歷這種無(wú)聊的話題了，回歸正題，通過(guò)一段時(shí)間的歸納和總結(jié)網(wǎng)上很多我覺(jué)得很好的代碼，就自己搭建了一套快速開(kāi)發(fā)的框架，下面我就把自己的愚見(jiàn)和網(wǎng)上收集的資料分享一下。
如果不想聽(tīng)我多啰嗦的話可以在GitHub上直接下載源碼下載鏈接

1.首先，介紹一下BaseRecyclerView：

BaseRecyclerView適配器的使用.png

可以看到，封裝之后的Adapter，我們只需要重寫(xiě)convert一個(gè)方法就可以實(shí)現(xiàn)該有的效果，比原來(lái)要重寫(xiě)多個(gè)方法代碼簡(jiǎn)潔多了。
我們只用了

viewHolder.setText(R.id.tv_title,item.getTitle());

一句代碼就完成了對(duì)View的初始化和運(yùn)用，下面我們看看ViewHolder是怎么寫(xiě)的：

public class BaseViewHolder extends RecyclerView.ViewHolder {

    private SparseArray<View> mViews;
    public View mConvertView;
    public Context mContext;

    public BaseViewHolder(Context context,View itemView) {
        super(itemView);
        mViews = new SparseArray<>();
        mConvertView = itemView;
        mContext = context;
    }

    public View getConvertView()
    {
        return mConvertView;
    }

    public static BaseViewHolder createViewHolder(Context context, View itemView){
        BaseViewHolder holder = new BaseViewHolder(context, itemView);
        return holder;
    }

    public static BaseViewHolder createViewHolder(Context context, ViewGroup parent, int layoutId){
        View itemView = LayoutInflater.from(context).inflate(layoutId, parent,
                false);
        BaseViewHolder holder = new BaseViewHolder(context, itemView);
        return holder;
    }

    public BaseViewHolder setText(@IdRes int viewId, CharSequence value) {
        TextView view = getView(viewId);
        view.setText(value);
        return this;
    }

    public BaseViewHolder setBackgroundColor(@IdRes int viewId, @ColorInt int color) {
        View view = getView(viewId);
        view.setBackgroundColor(color);
        return this;
    }

    public BaseViewHolder setBackgroundRes(@IdRes int viewId, @DrawableRes int backgroundRes) {
        View view = getView(viewId);
        view.setBackgroundResource(backgroundRes);
        return this;
    }

    public BaseViewHolder setTextColor(@IdRes int viewId, @ColorInt int textColor) {
        TextView view = getView(viewId);
        view.setTextColor(textColor);
        return this;
    }

    public BaseViewHolder setImageDrawable(@IdRes int viewId, Drawable drawable) {
        ImageView view = getView(viewId);
        view.setImageDrawable(drawable);
        return this;
    }

    public BaseViewHolder setImageBitmap(@IdRes int viewId, Bitmap bitmap) {
        ImageView view = getView(viewId);
        view.setImageBitmap(bitmap);
        return this;
    }

    public BaseViewHolder setVisible(@IdRes int viewId, boolean visible) {
        View view = getView(viewId);
        view.setVisibility(visible ? View.VISIBLE : View.GONE);
        return this;
    }

    //關(guān)于事件
    public BaseViewHolder setOnClickListener(@IdRes int viewId, View.OnClickListener listener) {
        View view = getView(viewId);
        view.setOnClickListener(listener);
        return this;
    }



    public BaseViewHolder setOnTouchListener(@IdRes int viewId,View.OnTouchListener listener)
    {
        View view = getView(viewId);
        view.setOnTouchListener(listener);
        return this;
    }

    public BaseViewHolder setOnLongClickListener(@IdRes int viewId,View.OnLongClickListener listener)
    {
        View view = getView(viewId);
        view.setOnLongClickListener(listener);
        return this;
    }



    public <T extends View> T getView(int viewId){
        View view = mViews.get(viewId);
        if(view == null){
            view = itemView.findViewById(viewId);
            mViews.put(viewId,view);
        }
        return (T) view;
    }
}

關(guān)鍵的三步：

1.用SparseArray來(lái)存儲(chǔ)各個(gè)View；
2.用getView的方法去集體聲明View；
3.用系統(tǒng)給出的setText等方法達(dá)到你想要的效果。

簡(jiǎn)單的封裝就能省略了開(kāi)發(fā)中初始化ViewHolder的很多重復(fù)繁雜的代碼~
在BaseAdapter，我也做了一些小小的封裝處理，把a(bǔ)dapter的onCreateViewHolder（），onBindViewHolder（），getItemCount（）三個(gè)必要寫(xiě)的方法也減少為只需要重寫(xiě)convert（）一個(gè)方法。

BaseRecyclerView其他用法.png

可以看到，在adapter我同樣封裝了增加頭部、尾部和子項(xiàng)監(jiān)聽(tīng)事件，在下拉刷新，上拉加載方面，我用了之前自己寫(xiě)過(guò)的一個(gè)SwipeRecyclerView融合在一起，有興趣的朋友可以去看看SwipeRecyclerView源碼下載鏈接
至于怎么實(shí)現(xiàn)，我是參考了網(wǎng)上幾個(gè)對(duì)RecyclerView封裝的很好的框架進(jìn)行修改的。以下是參考的鏈接：
BaseRecyclerViewHelperAdapter
為RecyclerView打造通用Adapter 讓RecyclerView更加好用

2.RxJava和Retrofit2的兩種網(wǎng)絡(luò)鏈接方式：

因?yàn)楦魅硕加凶约旱膼?ài)好，所以我聽(tīng)取別人給我的建議，選擇去封裝了兩種不同鏈接方式。

（1）分參數(shù)上傳：

分參數(shù)上傳.png

分參數(shù)上傳-View代碼.png

分參數(shù)上傳-Presenter代碼.png

這種方式是RxJava和Retrofit2在MVP模式中最普遍的用法，它跟以前很多網(wǎng)絡(luò)框架不一樣要先確定參數(shù)和JavaBean，所以也有習(xí)慣了以前模式的人吐槽這種方式，特別是Presenter的代碼量太多，冗余得代碼也多，但是這種封裝卻是最能體現(xiàn)RxJava和Retrofit2特性的封裝，以后查詢接口可以一目了然地知道鏈接和所需要的參數(shù)。
這種鏈接方式比較常見(jiàn)，所以我也不做太多的解釋。
以下是參考鏈接：
GeekNews

（2）批量參數(shù)上傳：
批量參數(shù)上傳-View層請(qǐng)求代碼.png
批量參數(shù)上傳-Presenter層請(qǐng)求代碼.png

很明顯，這種封裝Presenter層的代碼量看上去會(huì)減少很多，同時(shí)，這樣的封裝跟以前很多網(wǎng)絡(luò)框架的模式很像：

（1）用一個(gè)HashMap裝載所有的請(qǐng)求參數(shù)；
（2）url和參數(shù)直接在View層顯示；
（3）在請(qǐng)求的時(shí)候返回是一個(gè)callback。

下面我們看看代碼：
一開(kāi)始我還以為Retrofit不能批量參數(shù)上傳的，只能確定好每個(gè)參數(shù)，但是后來(lái)在網(wǎng)上才發(fā)現(xiàn)原來(lái)還有這種操作，所以就參照著幾個(gè)好的框架來(lái)實(shí)現(xiàn)了一次~

public interface BaseServerApi {

    @POST("{path}")
    Observable<ResponseBody> post(
            @Path(value = "path", encoded = true) String path,
            @QueryMap Map<String, Object> map);

    @GET("{path}")
    Observable<ResponseBody> get(
            @Path(value = "path", encoded = true) String path,
            @QueryMap Map<String, Object> map);
}

Retrofit2的相關(guān)配置和Get、Post上傳方法

public class RetrofitHelper {

    private static final int CONNECT_TIME_OUT = 20;
    private static final int READ_TIME_OUT = 20;
    private static final int WRITE_TIME_OUT = 20;
    private static final int MAX_CACHE_SIZE = 1024 * 1024 * 50;
    private static final String HTTP_CACHE_DIR = Environment.getExternalStorageDirectory() + "/HTTP_LIBRARY_CACHE";

    private static Retrofit retrofit;
    private static BaseServerApi baseServerApi;

    private static OkHttpClient mOkHttpClient = null;

    @Inject
    //初始化Retrofit
    public RetrofitHelper() {
        initOkHttp();
        retrofit = new Retrofit.Builder()
                .baseUrl(AppURL.BaseURL)
                .client(mOkHttpClient)
                .addConverterFactory(GsonConverterFactory.create()) //自定義的gsonConverter 在里面處理了登錄失效處理
                .addCallAdapterFactory(RxJavaCallAdapterFactory.create())
                .build();
        baseServerApi = retrofit.create(BaseServerApi.class);

    }

    //get方法
    public <T> T Get(String url, Map<String, Object> maps, BaseSubscriber<T> subscriber){

        return (T) baseServerApi.get(url,maps)
                .compose(RxUtil.<ResponseBody>rxSchedulerHelper())
                .compose(RxUtil.<T>handleResult())
                .subscribe(subscriber);
    }

    //post方法
    public <T> T Post(String url, Map<String, Object> maps, BaseSubscriber<T> subscriber){

        return (T) baseServerApi.post(url,maps)
                .compose(RxUtil.<ResponseBody>rxSchedulerHelper())
                .compose(RxUtil.<T>handleResult())
                .subscribe(subscriber);
    }

    //配置okHttp的數(shù)據(jù)
    public static void initOkHttp() {
        OkHttpClient.Builder builder = new OkHttpClient.Builder();
        if (Logger.DEBUG) {
            HttpLoggingInterceptor loggingInterceptor = new HttpLoggingInterceptor();
            loggingInterceptor.setLevel(HttpLoggingInterceptor.Level.BODY);
            builder.addInterceptor(loggingInterceptor);
        }

        File cacheFile = new File(HTTP_CACHE_DIR);
        Cache cache = new Cache(cacheFile, MAX_CACHE_SIZE);
        Interceptor cacheInterceptor = new CacheInterceptor();
        //設(shè)置緩存
        builder.addNetworkInterceptor(cacheInterceptor);
        builder.addInterceptor(cacheInterceptor);
        builder.cache(cache);
        //設(shè)置超時(shí)
        builder.connectTimeout(CONNECT_TIME_OUT, TimeUnit.SECONDS);
        builder.readTimeout(READ_TIME_OUT, TimeUnit.SECONDS);
        builder.writeTimeout(WRITE_TIME_OUT, TimeUnit.SECONDS);

        //錯(cuò)誤重連
        builder.retryOnConnectionFailure(true);
        mOkHttpClient = builder.build();
    }
}

按照一位以前班里的大神說(shuō)：
這種方式來(lái)說(shuō)，可讀性可能比較差點(diǎn)，但是如果以后你想換一種網(wǎng)絡(luò)框架，只需要把callback稍微改一下就好了而不需要像第一種那樣整個(gè)項(xiàng)目都要傷筋動(dòng)骨，但是這樣做卻把RxJava的鏈?zhǔn)浇Y(jié)構(gòu)的特性給抹殺掉了。。。
其實(shí)兩種鏈接方式各有各的優(yōu)點(diǎn)，看你喜歡哪一種，或者按照個(gè)人習(xí)慣去選擇，兩種方式我都放在框架里面了。
以下是參考鏈接：
Android 巧妙封裝，基于Retrofit+RxJava網(wǎng)絡(luò)框架“Leopard”---完整淺析
Novate：Retrofit2.0和RxJava的又一次完美改進(jìn)加強(qiáng)！

其實(shí)，很多時(shí)候我們請(qǐng)求數(shù)據(jù)回來(lái)都需要有第一層封裝去處理，譬如說(shuō)超時(shí)登錄等等，所以接下來(lái)我們也來(lái)封裝一下：
第二種網(wǎng)絡(luò)鏈接方式的處理：

第二種網(wǎng)絡(luò)鏈接方式的第一層數(shù)據(jù)封裝.png
public static <T> Observable.Transformer<ResponseBody, T> handleResult() {
        return new Observable.Transformer<ResponseBody, T>() {
            @Override
            public Observable<T> call(Observable<ResponseBody> tObservable) {
                return tObservable.flatMap(
                        new Func1<ResponseBody, Observable<T>>() {
                            @Override
                            public Observable<T> call(ResponseBody responseBody) {
                                try {
                                    String jstr = new String(responseBody.bytes());
                                    Type type = new TypeToken<WXHttpResponse>() {
                                    }.getType();
                                    Log.e("responseBody",jstr);
                                    //需要手動(dòng)解析Json，WXHttpResponse相當(dāng)于BaseBean，自己可以修改
                                    WXHttpResponse wxHttpResponse = new Gson().fromJson(jstr,type);
                                    //驗(yàn)證成功返回碼
                                    if (wxHttpResponse.getCode() == 200) {
                                        Log.e("wxHttpResponse",wxHttpResponse.getNewslist().toString());
                                        return (Observable<T>) Observable.just(wxHttpResponse.getNewslist());
                                    } else {
                                        // 處理被踢出登錄情況
                                        return Observable.error(new ReloginException("服務(wù)器返回error"));
                                    }
                                    } catch (IOException e) {
                                        e.printStackTrace();
                                    }
                                return Observable.error(new ReloginException("服務(wù)器返回error"));
                            }
                        }
                );
            }
        };
    }

public abstract class BaseSubscriber<T> extends Subscriber<T> {

    private Task<T> resultTask;
    private String msg;

    public BaseSubscriber(){
        Type type = getSuperClassGenricType(getClass(),0);
        this.resultTask = new Task(type);
    }

    @Override
    public void onCompleted() {

    }

    @Override
    public void onError(Throwable throwable) {
        throwable.printStackTrace();

        if(throwable instanceof ReloginException){
            // 踢出登錄
        }else if (throwable instanceof UnknownHostException) {
            msg = "沒(méi)有網(wǎng)絡(luò)...";
        } else if (throwable instanceof SocketTimeoutException) {
            // 超時(shí)
            msg = "超時(shí)...";
        }else{
            msg = "請(qǐng)求失敗，請(qǐng)稍后重試...";
        }
        onErrorT(msg);
    }

    @Override
    public void onNext(T t) {
        if(t != null) {
            Gson gson = new Gson();
            String result = gson.toJson(t);
            resultTask.setJson(result);
            onNextT(resultTask.getResult());
        }
    }

    public abstract void onNextT(T t);

    public abstract void onErrorT(String msg);

    // 獲取超類類型
    private Type getSuperclassTypeParameter(Class<?> clazz, int index)
    {
        Type genType = clazz.getGenericSuperclass();

        if (!(genType instanceof ParameterizedType)) {
            return Object.class;
        }
        Type[] params = ((ParameterizedType) genType).getActualTypeArguments();

        if (index >= params.length || index < 0) {
            return Object.class;
        }
        if (!(params[index] instanceof Class)) {
            return Object.class;
        }

        return (Class) params[index];
    }
  
    public static Type getSuperClassGenricType(final Class clazz, final int index) {

        //返回表示此 Class 所表示的實(shí)體（類、接口、基本類型或 void）的直接超類的 Type。
        Type genType = clazz.getGenericSuperclass();

        if (!(genType instanceof ParameterizedType)) {
            return Object.class;
        }
        //返回表示此類型實(shí)際類型參數(shù)的 Type 對(duì)象的數(shù)組。
        Type[] params = ((ParameterizedType) genType).getActualTypeArguments();

        if (index >= params.length || index < 0) {
            return Object.class;
        }
        if (!(params[index] instanceof Type)) {
            return Object.class;
        }

        return params[index];
    }

}

第一種連接方式跟第二種在這里是有區(qū)別的，第二種批量參數(shù)上傳對(duì)比起第一種相對(duì)比較復(fù)雜，是因?yàn)檫@里沒(méi)有用到retrofit2自動(dòng)解析json的功能，要自己手動(dòng)去解析，所以這里就只列出第二種連接方式給大家看看。
以下是參考鏈接：
RxJava簡(jiǎn)潔封裝之道

3.Dagger2

對(duì)于Dagger2，我只能說(shuō)自己的理解能力有限，一直都是靠文章和大神的幫助才慢慢理解，所以這里就不發(fā)表自己的愚見(jiàn)了，直接上幾篇寫(xiě)的比較好的文章給大家參考吧~
Android：dagger2讓你愛(ài)不釋手-基礎(chǔ)依賴注入框架篇
Dagger2從入門(mén)到放棄再到恍然大悟
Dagger2 入門(mén),以初學(xué)者角度

4.相關(guān)工具類

相關(guān)工具類.png

應(yīng)有盡有的相關(guān)工具類滿足你的一切要求~
由衷感謝我的好友兼我的大神jaminchanks對(duì)我安卓學(xué)習(xí)提供的巨大支持，我有很多安卓資料都是從他那里學(xué)習(xí)的。他比較低調(diào)，但是他知道的比我多太多了，這是他的簡(jiǎn)書(shū)賬號(hào)。
接下來(lái)可能我還會(huì)更新圖片框架的封裝和其他的一些改善。
如果有哪位朋友喜歡這個(gè)框架的，可以下載源碼，一起交流一下哪里可以改進(jìn)的，共同進(jìn)步~
源碼下載鏈接

最后編輯于 ：
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點(diǎn)，簡(jiǎn)書(shū)系信息發(fā)布平臺(tái)，僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容