RecyclerView 知识梳理(2) - Adapter

一、概述

当我们使用RecyclerView时，第一件事就是要继承于RecyclerView.Adapter，实现其中的抽象方法，来处理数据的展示逻辑，今天，我们就来介绍一下Adapter中的相关方法。

二、基础用法

我们从一个简单的线性列表布局开始，介绍RecyclerView.Adapter的基础用法。
首先，需要导入远程依赖包：

 compile'com.android.support:recyclerview-v7:25.3.1'

接着，继承于RecyclerView.Adapter来实现自定义的NormalAdapter：

public class NormalAdapter extends RecyclerView.Adapter<NormalAdapter.NormalViewHolder> {

    private List<String> mTitles = new ArrayList<>();

    public NormalAdapter(List<String> titles) {
        mTitles = titles;
    }

    @Override
    public NormalViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
        View itemView = LayoutInflater.from(parent.getContext()).inflate(R.layout.layout_normal_item, parent, false);
        return new NormalViewHolder(itemView);
    }

    @Override
    public void onBindViewHolder(NormalViewHolder holder, int position) {
        holder.setTitle(mTitles.get(position));
    }

    @Override
    public int getItemCount() {
        return mTitles.size();
    }

    class NormalViewHolder extends RecyclerView.ViewHolder {

        private TextView mTextView;

        NormalViewHolder(View itemView) {
            super(itemView);
            mTextView = (TextView) itemView.findViewById(R.id.tv_title);
        }

        void setTitle(String title) {
            mTextView.setText(title);
        }

    }
}

当我们实现自己的Adapter时，至少要做四个工作：

第一：继承于RecyclerView.ViewHolder，编写自己的ViewHolder
这个子类用来描述RecyclerView中每个Item的布局以及和它关联的数据，它同时也是RecyclerView.Adapter<VH>中需要指定的VH类型。
在构造方法中，除了需要调用super(View view)方法来传入Item的跟布局来给基类中itemView变量赋值，还应当提前执行findViewById来获得其中的子View以便我们之后对它们进行更新。
第二：实现onCreateViewHolder(ViewGroup parent, int viewType)
当RecyclerView需要我们提供类型为viewType的新ViewHolder时，会回调这个方法。
在这里，我们实例化出了Item的根布局，并返回一个和它绑定的ViewHolder。
第三：实现onBindViewHolder(VH viewHolder, int position)
当RecyclerView需要展示对应position位置的数据时会回调这个方法。
通过viewHolder中持有的对应position上的View，我们可以更新视图。
第四：实现getItemCount()
返回Item的总数。

在Activity中，我们给Adapter传递数据，使用方法和ListView基本相同，只是多了一句在设置LayoutManager的操作，这个我们后面再分析。

    private void init() {
        RecyclerView recyclerView = (RecyclerView) findViewById(R.id.rv_content);
        mTitles = new ArrayList<>();
        for (int i = 0; i < 20; i++) {
            mTitles.add("My name is " + i);
        }
        NormalAdapter normalAdapter = new NormalAdapter(mTitles);
        recyclerView.setLayoutManager(new LinearLayoutManager(this));
        recyclerView.setAdapter(normalAdapter);
    }

这样，一个RecyclerView的例子就完成了：

三、只有一种`ViewType`下的复用情况分析

下面，我们来分析一下两个关键方法的调用时机：

onCreateViewHolder
onBindViewHolder

通过这两个方法回调的时机，我们可以对RecyclerView复用的机制有一个大概的了解。

3.1 初始进入

刚开始进入界面的时候，我们只展示了3个Item，此时这两个方法的调用情况如下，可以看到，RecyclerView只实例化了屏幕内可见的ViewHolder，并且onBindViewHolder是在对应的onCreateViewHolder调用完后立即调用的：

3.2 开始滑动

当我们手指触摸到屏幕，并开始向下滑动，我们会发现，虽然position=3的Item还没有展示出来，但是这时候它的onCreateViewHolder和onBindViewHolder就被回调了，也就是说，我们会预加载一个屏幕以外的Item：

3.3 继续滑动

当我们继续往下滑动，position=3的Item一被展示，那么position=4的Item的两个方法就会被回调。

3.4 复用

当postion=6的Item被展示之后，按照前面的分析，这时候就应当回调position=7的onCreateViewHolder和onBindViewHolder方法了，但是我们发现，这时候只回调了onBindViewHolder方法，而传入的ViewHolder其实是position=0的ViewHolder，也就是我们所说的复用：

此时，屏幕中Items的展现情况为：

目前不可见的Item为position=0,1,2，所以，我们可以得出结论：在单一布局的情况，RecyclerView在复用的时候，会取相反方向中超出显示范围的第3个Item来复用，而并不是超出显示范围的第一个Item进行复用。

四、多种类型的布局

4.1 基本使用

当我们需要在列表当中展示不同类型的Item时，我们一般需要重写下面的方法，告诉RecyclerView在对应的position上需要展示什么类型的Item。

public int getItemViewType(int position)

RecyclerView在回调onCreateViewHolder的时候，同时也会把viewType传递进来，我们根据viewType来创建不同的布局。
下面，我们就来演示一下它的用法，这里我们返回三种不同类型的item：

public class NormalAdapter extends RecyclerView.Adapter<NormalAdapter.NormalViewHolder> {

    private List<String> mTitles = new ArrayList<>();

    public NormalAdapter(List<String> titles) {
        mTitles = titles;
    }

    @Override
    public NormalViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
        View itemView = null;
        switch (viewType) {
            case 0:
                itemView = LayoutInflater.from(parent.getContext()).inflate(R.layout.layout_normal_item_1, parent, false);
                break;
            case 1:
                itemView = LayoutInflater.from(parent.getContext()).inflate(R.layout.layout_normal_item_2, parent, false);
                break;
            case 2:
                itemView = LayoutInflater.from(parent.getContext()).inflate(R.layout.layout_normal_item_3, parent, false);
                break;

        }
        NormalViewHolder viewHolder = new NormalViewHolder(itemView);
        Log.d("NormalAdapter", "onCreateViewHolder, address=" + viewHolder.toString());
        return viewHolder;
    }

    @Override
    public void onBindViewHolder(NormalViewHolder holder, int position) {
        Log.d("NormalAdapter", "onBindViewHolder, address=" + holder.toString() + ",position=" + position);
        int viewType = getItemViewType(position);
        String title = mTitles.get(position);
        holder.setTitle1("title=" + title + ",viewType=" + viewType);
    }

    @Override
    public int getItemCount() {
        return mTitles.size();
    }

    @Override
    public int getItemViewType(int position) {
        return position % 3;
    }

    class NormalViewHolder extends RecyclerView.ViewHolder {

        private TextView mTv1;

        NormalViewHolder(View itemView) {
            super(itemView);
            mTv1 = (TextView) itemView.findViewById(R.id.tv_title_1);
        }

        void setTitle1(String title) {
            mTv1.setText(title);
        }

    }
}

最终，会得到下面的界面：

4.2 多种`viewType`下的复用情况分析

前面，我们已经研究过一种viewType下的复用情况，现在，我们再来分析一下多种viewType时候的复用情况。

4.2.1 初始进入

此时，我们屏幕中展示了postion=0~6这七个Item，onCreateViewHolder和onBindViewHolder的回调和之前相同，只会生成屏幕内可见的ViewHolder

4.2.2 开始滑动和继续滑动

这两种情况都和单个viewType时相同，会预加载屏幕以外的一个Item：

4.2.3 复用

关键，我们看一下何时会复用position=0/viewType=1的Item：

此时，屏幕内最上方的Item为position=4/viewType=1，最下方的Item为position=11/viewType=2，按照之前的分析，RecyclerView会保留相反方向的2个ViewHolder，也就是保留postion=2,3的ViewHolder，并复用position=1的ViewHolder，但是现在position=0的ViewHolder的viewType=1，不可以复用，因此，会继续往上寻找，这时候就找到了position=0的ViewHolder进行复用。

五、数据更新

5.1 更新方式

当数据源发生变化的时候，我们一般会通过Adatper. notifyDataSetChanged()来进行界面的刷新，RecyclerView.Adapter也提供了相同的方法：

public final void notifyDataSetChanged()

除此之外，它还提供了下面几种方法，让我们进行局部的刷新：

//position的数据变化
notifyItemChanged(int postion)
//在position的下方插入了一条数据
notifyItemInserted(int position)
//移除了position的数据
notifyItemRemoved(int postion)
//从position开始，往下n条数据发生了改变
notifyItemRangeChanged(int postion, int n)
//从position开始，插入了n条数据
notifyItemRangeInserted(int position, int n)
//从position开始，移除了n条数据
notifyItemRangeRemoved(int postion, int n)

下面是一些简单的使用方法：

   //在头部添加多个数据.
   public void addItems() {
        mTitles.add(0, "add Items, name=0");
        mTitles.add(0, "add Items, name=1");
        mNormalAdapter.notifyItemRangeInserted(0, 2);
    }
    //移除头部的多个数据.
    public void removeItems() {
        mTitles.remove(0);
        mTitles.remove(0);
        mNormalAdapter.notifyItemRangeRemoved(0, 2);
    }
    //移动数据.
    public void moveItems() {
        mTitles.remove(1);
        mTitles.add(2, "move Items name=0");
        mNormalAdapter.notifyItemMoved(1, 2);
    }

5.2 比较

数据的更新分为两种：

Item changes：除了Item所对应的数据被更新外，没有其它的变化，对应notifyXXXChanged()方法。
Structural changes：Items在数据集中被插入、删除或者移动，对应notifyXXXInsert/Removed/Moved方法。

notifyDataSetChanged会把当前所有的Item和结构都视为已经失效的，因此它会让LayoutManager重新绑定Items，并对他们重新布局，这在我们知道已经需要更新某个Item的时候，其实是不必要的，这时候就可以选择进行局部更新来提高效率。

六、监听`ViewHolder`的状态

RecyclerView.Adapter中还提供了一些回调，让我们能够监听某个ViewHolder的变化：

    @Override
    public void onViewRecycled(NormalViewHolder holder) {
        Log.d("NormalAdapter", "onViewRecycled=" + holder);
        super.onViewRecycled(holder);
    }

    @Override
    public void onViewDetachedFromWindow(NormalViewHolder holder) {
        Log.d("NormalAdapter", "onViewDetachedFromWindow=" + holder);
        super.onViewDetachedFromWindow(holder);
    }

    @Override
    public void onViewAttachedToWindow(NormalViewHolder holder) {
        Log.d("NormalAdapter", "onViewAttachedToWindow=" + holder);
        super.onViewAttachedToWindow(holder);
    }

下面，我们就从实例来讲解这几个方法的调用时机，初始时刻，我们的界面为：

初始进入时，position=0~6的onViewAttachedToWindow被回调：
当滑动到postion=7可见时，它的onViewAttachedToWindow被回调：
当postion=0被移出屏幕可视范围内，它的onViewDetachedFromWindow被回调：
而当我们继续往下滑动，当position=2被移出屏幕之后，此时position=0的onViewRecycled被回调：

现在回忆一下之前我们对复用情况的分析，RecyclerView最多会保留相反方向上的两个ViewHolder，此时虽然position=1,2不可见，但是依然需要保留它们，这时候会回收position=0的ViewHolder以备之后被复用。

七、监听`RecyclerView`和`RecyclerView.Adapter`的关系

RecyclerView和Adapter是通过setAdapter方法来绑定的，因此在Adapter中也通过了绑定的监听：

public void onAttachedToRecyclerView(RecyclerView recyclerView) {}
public void onDetachedFromRecyclerView(RecyclerView recyclerView) {}

八、小结

这篇文章，主要总结了一些RecyclerView.Adapter中平时我们不常注意的细节问题，也通过实例了解到了关键方法的含义，最后，推荐一个Adapter的开源库：BaseRecyclerViewAdapterHelper。

RecyclerView 知识梳理(2) - Adapter

RecyclerView 知识梳理(2) - Adapter

一、概述

二、基础用法

三、只有一种`ViewType`下的复用情况分析

3.1 初始进入

3.2 开始滑动

3.3 继续滑动

3.4 复用

四、多种类型的布局

4.1 基本使用

4.2 多种`viewType`下的复用情况分析

4.2.1 初始进入

4.2.2 开始滑动和继续滑动

4.2.3 复用

五、数据更新

5.1 更新方式

5.2 比较

六、监听`ViewHolder`的状态

七、监听`RecyclerView`和`RecyclerView.Adapter`的关系

八、小结

更多文章，欢迎访问我的 Android 知识梳理系列：

推荐阅读更多精彩内容

RecyclerView 知识梳理(2) - Adapter

一、概述

二、基础用法

三、只有一种ViewType下的复用情况分析

3.1 初始进入

3.2 开始滑动

3.3 继续滑动

3.4 复用

四、多种类型的布局

4.1 基本使用

4.2 多种viewType下的复用情况分析

4.2.1 初始进入

4.2.2 开始滑动和继续滑动

4.2.3 复用

五、数据更新

5.1 更新方式

5.2 比较

六、监听ViewHolder的状态

七、监听RecyclerView和RecyclerView.Adapter的关系

八、小结

更多文章，欢迎访问我的 Android 知识梳理系列：

推荐阅读更多精彩内容

三、只有一种`ViewType`下的复用情况分析

4.2 多种`viewType`下的复用情况分析

六、监听`ViewHolder`的状态

七、监听`RecyclerView`和`RecyclerView.Adapter`的关系