一个易维护的 RecyclerView.Adapter 的实现

使用 RecyclerView 实现下面的效果：

有两种布局，红色布局和蓝色布局
偶数位置的是红色布局，奇数位置的是蓝色布局

按照一般的方法来实现 Adapter 的话，代码如下

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

import java.util.List;

public class MyAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolder> {

    private static final int TYPE_RED = 0;
    private static final int TYPE_BLUE = 1;

    private List<String> mDataSource;

    public MyAdapter(List<String> dataSource) {
        mDataSource = dataSource;
    }

    @Override
    public RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
        if (viewType == TYPE_RED) {
            return new RedViewHolder(LayoutInflater.from(parent.getContext()).inflate(R.layout.item_red, parent, false));
        } else {
            return new BlueViewHolder(LayoutInflater.from(parent.getContext()).inflate(R.layout.item_blue, parent, false));
        }
    }

    @Override
    public void onBindViewHolder(RecyclerView.ViewHolder holder, int position) {
        if (holder.getItemViewType() == TYPE_RED) {
            RedViewHolder redViewHolder = (RedViewHolder) holder;
            redViewHolder.tv.setText(mDataSource.get(position));
        } else {
            BlueViewHolder blueViewHolder = (BlueViewHolder) holder;
            blueViewHolder.tv.setText(mDataSource.get(position));
        }
    }

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

    @Override
    public int getItemViewType(int position) {
        if (position % 2 == 0) {
            return TYPE_RED;
        } else {
            return TYPE_BLUE;
        }
    }

    private static class RedViewHolder extends RecyclerView.ViewHolder {

        TextView tv;

        RedViewHolder(View itemView) {
            super(itemView);
            tv = (TextView) itemView.findViewById(R.id.tv);
        }
    }

    private static class BlueViewHolder extends RecyclerView.ViewHolder {

        TextView tv;

        BlueViewHolder(View itemView) {
            super(itemView);
            tv = (TextView) itemView.findViewById(R.id.tv);
        }
    }
}

因为有多种布局，所以重点关注的是如何判断在某一个位置要如何展示哪一个布局，RecyclerView.Adapter 提供了 int getItemViewType(int position) 方法让我们重写，给每一个布局指定一个唯一标识 ItemViewType

按照效果图：偶数位置的是红色布局，奇数位置的是蓝色布局，所以方法重写如下

// 布局的唯一标识
private static final int TYPE_RED = 0;
private static final int TYPE_BLUE = 1;

// 布局的判断
@Override
public int getItemViewType(int position) {
    if (position % 2 == 0) {
        return TYPE_RED;
    } else {
        return TYPE_BLUE;
    }
}

有了布局的唯一标识 ItemViewType 之后，就可以在
RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) 和
void onBindViewHolder(RecyclerView.ViewHolder holder, int position) 中根据这个唯一标识，创建和绑定不同的 ViewHolder 了。

缺陷

这个写法没什么毛病，但是在维护上会有一些问题。如果将来要增加一个新的布局，假设位置的尾数逢 5 的地方需要显示绿色布局，就需要改动几个地方

增加或布局的唯一标识，也就是改动这个地方

private static final int TYPE_RED = 0;
private static final int TYPE_BLUE = 1;
private static final int TYPE_GREEN = 2;  // 增加一个标识

增加一个 ViewHolder

private static class GreenViewHolder extends RecyclerView.ViewHolder {

    TextView tv;

    GreenViewHolder(View itemView) {
        super(itemView);
        tv = (TextView) itemView.findViewById(R.id.tv);
    }
}

修改 int getItemViewType(int position) 的 if-else 判断

@Override
public int getItemViewType(int position) {
    // 这里的 if - else 判断需要修改
    if (position % 2 == 0) {
        return TYPE_RED;
    } else if (position % 5 == 0){
      return TYPE_GREEN;  
    } else {
      return TYPE_BLUE;
    }
}

修改 RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) 方法，增加一个 ViewHolder

@Override
public RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
    if (viewType == TYPE_RED) {
        return new RedViewHolder(LayoutInflater.from(parent.getContext())
                .inflate(R.layout.item_red, parent, false));
    } else if (viewType == TYPE_GREEN){
        // 增加一个 GreenViewHolder
        return new GreenViewHolder(LayoutInflater.from(parent.getContext())
                .inflate(R.layout.item_green, parent, false));
    } else {
        return new BlueViewHolder(LayoutInflater.from(parent.getContext())
                .inflate(R.layout.item_blue, parent, false));
    }
}

修改 void onBindViewHolder(RecyclerView.ViewHolder holder, int position) 方法，处理 GreenViewHolder 的逻辑

@Override
public void onBindViewHolder(RecyclerView.ViewHolder holder, int position) {
    if (holder.getItemViewType() == TYPE_RED) {
        RedViewHolder redViewHolder = (RedViewHolder) holder;
        redViewHolder.tv.setText(mDataSource.get(position));
    } else if (holder.getItemViewType() == TYPE_GREEN){
        // 处理 GreenViewHolder 的逻辑
        GreenViewHolder greenViewHolder = (GreenViewHolder) holder;
        greenViewHolder.tv.setText(mDataSource.get(position));
    } else {
        BlueViewHolder blueViewHolder = (BlueViewHolder) holder;
        blueViewHolder.tv.setText(mDataSource.get(position));
    }
}

发现问题

可以看到增加一个布局，需要改动很多地方。问题的根源就在于 if-else 判断这一块代码。如果让一个类来帮我们在 int getItemViewType(int position) 方法中返回唯一标识，同时在 RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) 和
void onBindViewHolder(RecyclerView.ViewHolder holder, int position) 方法中帮我们根据 itemViewType 拿到 ViewHolder，这样就能大幅度地减少代码。

实现

可以看到 itemViewType 和 ViewHolder 是一一对应的关系，那么就可以使用 HashMap<Integer, RecyclerView.ViewHolder> 来存放 itemViewType 和 ViewHolder。

接着再定义一个接口

public interface AdapterDelegate<T> {

    /**
     * 确定唯一标识
     */
    boolean isForViewType(List<T> items, int position);

    /**
     * 创建 ViewHolder
     */
    RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent);

    /**
     * 绑定 ViewHolder
     */
    void onBindViewHolder(List<T> items, int position, RecyclerView.ViewHolder holder);
}

把确定唯一标识、创建 ViewHolder 和绑定 ViewHolder 的工作交给实现接口的具体的 ViewHolder 来实现。

最终效果

MyAdapter 现在只有这些代码

public class MyAdapter extends RecyclerView.Adapter<RecyclerView.ViewHolder> {

    private AdapterDelegatesManager<String> mAdapterDelegatesManager;

    private List<String> mDataSource;

    public MyAdapter(List<String> dataSource) {
        mDataSource = dataSource;
        mAdapterDelegatesManager = new AdapterDelegatesManager<>();
        mAdapterDelegatesManager  // 在这里绑定 ViewHolder
                .addDelegate(new RedViewHolder())
                .addDelegate(new GreenViewHolder())
                .addDelegate(new BlueViewHolder());
    }

    @Override
    public RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
        return mAdapterDelegatesManager.onCreateViewHolder(parent, viewType);
    }

    @Override
    public void onBindViewHolder(RecyclerView.ViewHolder holder, int position) {
        mAdapterDelegatesManager.onBindViewHolder(mDataSource, position, holder);
    }

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

    @Override
    public int getItemViewType(int position) {
        return mAdapterDelegatesManager.getItemViewType(mDataSource, position);
    }
}

剩下的就是定义 ViewHolder 实现 AdapterDelegate<T> 接口就行

/**
 * RedViewHolder
 */
private static class RedViewHolder implements AdapterDelegate<String> {

    @Override
    public boolean isForViewType(List<String> items, int position) {
        return position % 2 == 0;
    }

    @Override
    public RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent) {
        return new ViewHolder(LayoutInflater.from(parent.getContext())
                .inflate(R.layout.item_red, parent, false));
    }

    @Override
    public void onBindViewHolder(List<String> items, int position, RecyclerView.ViewHolder holder) {
        ViewHolder redViewHolder = (ViewHolder) holder;
        redViewHolder.tv.setText(items.get(position));
    }

    private class ViewHolder extends RecyclerView.ViewHolder {

        TextView tv;

        ViewHolder(View itemView) {
            super(itemView);
            tv = (TextView) itemView.findViewById(R.id.tv);
        }
    }
}


/**
 * BlueViewHolder
 */
private static class BlueViewHolder implements AdapterDelegate<String> {

    @Override
    public boolean isForViewType(List<String> items, int position) {
        return position % 2 != 0;
    }

    @Override
    public RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent) {
        return new ViewHolder(LayoutInflater.from(parent.getContext())
                .inflate(R.layout.item_blue, parent, false));
    }

    @Override
    public void onBindViewHolder(List<String> items, int position, RecyclerView.ViewHolder holder) {
        ViewHolder viewHolder = (ViewHolder) holder;
        viewHolder.tv.setText(items.get(position));
    }

    private class ViewHolder extends RecyclerView.ViewHolder {

        TextView tv;

        ViewHolder(View itemView) {
            super(itemView);
            tv = (TextView) itemView.findViewById(R.id.tv);
        }
    }
}


/**
 * GreenViewHolder
 */
private static class GreenViewHolder implements AdapterDelegate<String> {

    @Override
    public boolean isForViewType(List<String> items, int position) {
        return position % 5 == 0;
    }

    @Override
    public RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent) {
        return new ViewHolder(LayoutInflater.from(parent.getContext())
                .inflate(R.layout.item_green, parent, false));
    }

    @Override
    public void onBindViewHolder(List<String> items, int position, RecyclerView.ViewHolder holder) {
        ViewHolder viewHolder = (ViewHolder) holder;
        viewHolder.tv.setText(items.get(position));
    }

    private class ViewHolder extends RecyclerView.ViewHolder {

        TextView tv;

        ViewHolder(View itemView) {
            super(itemView);
            tv = (TextView) itemView.findViewById(R.id.tv);
        }
    }
}

核心代码的实现

这个类是按照 JOE'S GREAT ADAPTER HELL ESCAPE 介绍的思想来实现的，核心指出就在于 itemViewType 和 ViewHolder 是一一对应的关系。

AdapterDelegate 接口

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

import java.util.List;

public interface AdapterDelegate<T> {

    boolean isForViewType(List<T> items, int position);

    RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent);

    void onBindViewHolder(List<T> items, int position, RecyclerView.ViewHolder holder);
}

AdapterDelegatesManager 的实现

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

import java.util.List;

public class AdapterDelegatesManager<T> {

    /**
     * Key: ItemViewType
     * Value: AdapterDelegate
     */
    private SparseArray<AdapterDelegate<T>> mDelegates = new SparseArray<>();

    public AdapterDelegatesManager<T> addDelegate(AdapterDelegate<T> delegate) {
        if (delegate == null) {
            throw new NullPointerException("AdapterDelegate of item can not be null");
        } else {
            int newItemViewType = mDelegates.size();
            mDelegates.put(newItemViewType, delegate);
        }
        return this;
    }

    public int getItemViewType(List<T> items, int position) {
        int delegateCount = mDelegates.size();
        for (int itemViewType = 0; itemViewType < delegateCount; itemViewType++) {
            AdapterDelegate<T> delegate = mDelegates.valueAt(itemViewType);
            if (delegate.isForViewType(items, position)) {
                return itemViewType;
            }
        }
        throw new IllegalArgumentException(
                "No AdapterDelegate added that matches position=" + position + " in data source");
    }

    public RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
        AdapterDelegate delegate = mDelegates.get(viewType);
        if (delegate == null) {
            throw new NullPointerException("No AdapterDelegate added for ViewType " + viewType);
        } else {
            return delegate.onCreateViewHolder(parent);
        }
    }

    public void onBindViewHolder(List<T> items, int position, RecyclerView.ViewHolder viewHolder) {
        AdapterDelegate<T> delegate = mDelegates.get(viewHolder.getItemViewType());
        if (delegate == null) {
            throw new NullPointerException(
                    "No AdapterDelegate added for ViewType " + viewHolder.getItemViewType());
        } else {
            delegate.onBindViewHolder(items, position, viewHolder);
        }
    }
}

参考来源

http://hannesdorfmann.com/android/adapter-delegates
https://github.com/sockeqwe/AdapterDelegates

最后编辑于：2017.12.07 11:13:59

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