一、引言

從事android開發已經快三年了，相信大家和我一樣，寫了無數列表View的介面卡，不知大家是否厭倦了這些重複的流程和程式碼？反正我是早厭倦了。本篇旨在從一段司空見慣的RecyclerView介面卡程式碼開始，一步一步抽取程式碼的重複部分，打造和ListView通用介面卡類似的RecyclerView通用介面卡，一來為大家提供RecyclerView通用介面卡，提高開發效率，二來分享一種程式碼抽取的思路。記得之前帶我的師傅曾說過：框架不是一下子空想出來的，是”演化”而來的，就像大家熟知的Imageloarder，1.0版本絕對不是現在這個樣子。。。廢話就扯到這裡，下面先看看一段讓人熟悉到吐的介面卡程式碼：

package com.star.xadapter;

import android.support.v7.widget.RecyclerView;
import android.view.View;
import android.view.ViewGroup;
import android.widget.TextView;

import java.util.List;

/**
 * Created by kakaxicm on 16/7/7.
 */
public class TestAdapter extends RecyclerView.Adapter<RecyclerView
 
.ViewHolder>{
    private List<String> mData;
    public TestAdapter(List<String> data){
        mData = data;
    }
    @Override
    public RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
        return new TestViewHolder(View.inflate(parent.getContext(),R.layout.item_test, null
 
));
    }

    @Override
    public void onBindViewHolder(RecyclerView.ViewHolder holder, int position) {
        TestViewHolder tHolder = (TestViewHolder) holder;
        tHolder.tv.setText(mData.get(position));
    }

    @Override
    public int getItemCount() {
        return mData == null ? 0 : mData.size();
    }

    private class TestViewHolder extends RecyclerView.ViewHolder{
        TextView tv;
        public TestViewHolder(View itemView) {
            super(itemView);
            tv = (TextView) itemView.findViewById(R.id.tv);
        }


    }
}

當每個頁面的RecyclerView的Model和View不同時，都得另寫一個介面卡，流程都是標準化的：
1.覆寫getItemCount、onCreateViewHolder、onBindViewHolder方法，多型別支援還要覆寫getItemViewType方法；
2.根據每個位置返回的itemview型別，構造不同的ViewHolder，ViewHolder和佈局檔案通過onBindViewHolder建立繫結關係。
既然流程是標準化的，那麼這些公共的流程就可以抽取出來，具體的實現細節暴露給呼叫者實現。下面就來一步一步來“演化”程式碼，打造通用的介面卡。

二、通用介面卡初步演化

從第一節的分析，我們可以把公共的部分抽取出來，具體的細節通過介面暴露給呼叫者實現。那麼公共部分有哪些呢？哪些細節是和業務相關的呢？
1.上面提到的四個方法規定了公共的流程，可以抽取出來；
2.資料層是一個列表，支援的Model型別由使用者決定，所以可以做泛型支援；
3.View層即ViewHolder，也可以通過介面由使用者構造。當然介面卡在多type情況下支援不同的ViewHolder,也需要做泛型支援;
4.從以上3點的分析，那麼對外暴露的介面就應該是這樣:暴露兩個個方法，一個方法繫結資料入參是model和viewholder，另外一個方法構造viewholder。介面程式碼如下：

   /**
     * 繫結資料的介面
     * @param <T> model
     * @param <H> viewholder
     */
    interface OnBindDataInterface<T, H extends RecyclerView.ViewHolder>{
        void onBindData(T model, H holder, int viewType);
        H getViewHolder(ViewGroup parent, int viewType);
    }

結合標準流程的方法，初步演化的介面卡程式碼如下:

package com.star.xadapter;

import android.support.v7.widget.RecyclerView;
import android.view.ViewGroup;

import java.util.List;

/**
 * Created by kakaxicm on 16/7/6.
 */
public class UniversalAdapterBeta<T, H extends RecyclerView.ViewHolder> extends RecyclerView.Adapter<H>{
    private List<T> mData;

    public UniversalAdapterBeta(List<T> data , OnBindDataInterface<T, H> bindInterface){
        mData = data;
        mOnBindDataInterface = bindInterface;
    }

    /**
     * 繫結資料的介面
     * @param <T> model
     * @param <H> viewholder
     */
    interface OnBindDataInterface<T, H extends RecyclerView.ViewHolder>{
        void onBindData(T model, H holder, int viewType);
        H getViewHolder(ViewGroup parent, int viewType);
    }

    private OnBindDataInterface<T, H> mOnBindDataInterface;

    @Override
    public H onCreateViewHolder(ViewGroup parent, int viewType) {
        //構建ViewHolder 入參 parant viewType layoutid
        return mOnBindDataInterface.getViewHolder(parent, viewType);
    }

    @Override
    public void onBindViewHolder(H holder, int position) {
        mOnBindDataInterface.onBindData(mData.get(position), holder, getItemViewType(position));
    }

    @Override
    public int getItemCount() {
        return mData == null ? 0 : mData.size();
    }

}

用例：

 UniversalAdapterBeta<String, UniversalViewHolderBeta> adapter = new UniversalAdapterBeta<>(mData, new UniversalAdapterBeta.OnBindDataInterface<String, UniversalViewHolderBeta>() {
            @Override
            public void onBindData(String model, UniversalViewHolderBeta holder, int type) {
                holder.mTv.setText(model);
            }

            @Override
            public UniversalViewHolderBeta getViewHolder(ViewGroup parent, int viewType) {
                return new UniversalViewHolderBeta(parent, R.layout.item_test);
            }
        });

可以看到，使用者只需要構造viewholder和繫結資料就行，而不必關心流程是怎麼走的。初步演化的思想是把View層的viewholder(H) 和 model(T)分開,把model和viewholder都暴露給使用者來構造。

三、通用ViewHolder的封裝

初步演化出來的介面卡需要呼叫者構造model和holder，細想一下，viewholder的構造最關鍵的只有一個引數:佈局檔案id，而這個佈局檔案中有哪些view元素,都交給viewholder封裝即可。至於多種型別的item對應多種viewholder,也是對應不同的layoutid和它的子view。這樣就可以抽取出不同ViewHolder所共有的元素與方法，實現內部構造ViewHolder，進而把介面中ViewHolder構造的方法隱藏起來。那麼這個通用的ViewHolder有哪些共有屬性和方法呢？
1.佈局檔案id
2.子View元素集合
3.子View元素的訪問方法
UniversalViewHolder具體程式碼:

package com.star.xadapter;
import android.support.v7.widget.RecyclerView;
import android.util.SparseArray;
import android.view.View;
import android.view.ViewGroup;

/**
 * Created by kakaxicm on 16/7/6.
 *
 */
public class UniversalViewHolder extends RecyclerView.ViewHolder{
    private SparseArray<View> mViews;//子View元素集合
    private View mContentView;//itemView，用於查詢子View
    public static UniversalViewHolder getViewHolder(ViewGroup parent, int layoutId)
    {
        return new UniversalViewHolder(View.inflate(parent.getContext(), layoutId, null));
    }

    public UniversalViewHolder(View itemView) {
        super(itemView);
        mViews = new SparseArray<>();
        mContentView = itemView;
    }

    /**
     * 子View元素的訪問方法
     * @param viewId 
     * @param <T>
     * @return
     */
    public <T extends View> T getSubView(int viewId){
        View view = mViews.get(viewId);
        if(view == null){
            view = mContentView.findViewById(viewId);
            mViews.put(viewId, view);
        }
        return (T)view;
    }

}

對使用者暴露的介面就變成了這樣:

    /**
     * 繫結資料的介面
     * @param <T> model
     */
    interface OnBindDataInterface<T>{
        void onBindData(T model, UniversalViewHolder hodler, int type);
        int getItemLayoutId(int viewType);
    }

方法getItemLayoutId就是使用者構造不同的UniversalViewHolder的。於是通用的介面卡就出來了:

package com.star.xadapter;
import android.support.v7.widget.RecyclerView;
import android.view.ViewGroup;

import java.util.List;

/**
 * Created by kakaxicm on 16/7/6.
 */
public class UniversalAdapter<T> extends RecyclerView.Adapter<UniversalViewHolder>{
    private List<T> mData;

    public UniversalAdapter(List<T> data , OnBindDataInterface<T> bindInterface){
        mData = data;
        mOnBindDataInterface = bindInterface;
    }

    public UniversalAdapter(List<T> data , OnMultiTypeBindDataInterface<T> bindInterface){
        mData = data;
        mOnMultiTypeBindDataInterface = bindInterface;
        mOnBindDataInterface = bindInterface;
    }

    /**
     * 繫結資料的介面
     * @param <T> model
     */
    interface OnBindDataInterface<T>{
        void onBindData(T model, UniversalViewHolder hodler, int type);
        int getItemLayoutId(int viewType);
    }

    /**
     * 多型別支援
     * @param <T>
     */
    interface OnMultiTypeBindDataInterface<T> extends OnBindDataInterface<T>{
        int getItemViewType(int postion);
    }

    private OnBindDataInterface<T> mOnBindDataInterface;
    private OnMultiTypeBindDataInterface<T> mOnMultiTypeBindDataInterface;

    @Override
    public int getItemViewType(int position) {
        if(mOnMultiTypeBindDataInterface != null){
            return mOnMultiTypeBindDataInterface.getItemViewType(position);
        }
        return 0;
    }

    @Override
    public UniversalViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
        //構建ViewHolder 入參 parant viewType layoutid
        int layoutId = mOnBindDataInterface.getItemLayoutId(viewType);
        UniversalViewHolder holder = UniversalViewHolder.getViewHolder(parent, layoutId);
        return holder;
    }

    @Override
    public void onBindViewHolder(UniversalViewHolder holder, int position) {
        mOnBindDataInterface.onBindData(mData.get(position), holder, getItemViewType(position));
    }

    @Override
    public int getItemCount() {
        return mData == null? 0 : mData.size();
    }

}

說明:
1.這個演化將ViewHolder的構造交給通用的ViewHolder處理，ViewHolder持有子View的id和物件的對映關係。與第一個版本相比，使用者不用構造新的ViewHolder類，只需要設定layout即可;
2.為了支援多型別item,這裡引入OnBindDataInterface的子介面OnMultiTypeBindDataInterface，getItemViewType方法返回item型別，使用者根據返回型別在onBindData方法裡做不同處理。用例如下:

UniversalAdapter<String> adapter = new UniversalAdapter<>(mData, new UniversalAdapter.OnMultiTypeBindDataInterface<String>() {
            @Override
            public int getItemViewType(int postion) {
                if(postion % 2 == 0){
                    return 0;
                }
                if(postion % 3 == 0){
                    return 2;
                }
                return 1;
            }

            @Override
            public void onBindData(String model, UniversalViewHolder holder, int type) {
                switch (type){
                    case 0:
                        TextView tv = holder.getSubView(R.id.tv);
                        tv.setText(model);
                        break;
                    case 1:
                        break;
                    case 2:
                        Button btn = holder.getSubView(R.id.btn);
                        btn.setText(model);
                        break;
                    default:
                        break;
                }

            }

            @Override
            public int getItemLayoutId(int viewType) {
                switch (viewType){
                    case 0:
                        return R.layout.item_test;
                    case 1:
                        return R.layout.item_test2;
                    case 2:
                        return R.layout.item_test3;
                }
                return 0;
            }
        });

補充：UniversalViewHolder持有子View的引用，可以新增一些常用輔助方法，如setImageSrc(int viewId, int drawid)等方法，方便使用者呼叫。
總結:逐步抽取程式碼構建通用框架的設計思想就是典型的模板方法設計模式，它由公用的模板規定流程，通過子類或者介面實現具體每個流程的細節。希望大家從這篇部落格中得到的不僅僅是一個通用的介面卡，更重要的是”重複的事情簡單做”的框架演化思想。