知识框架（脑图）

RecyclerView脑图

技术出现的背景

• ListView没有强制要求ViewHolder
• ListView不能快速实现线性、网格和瀑布流效果
• ListView和GridView设计上重合度高
• MD设计的流行

解决的思路

• 使用RecyclerView统一ListView和GridView
• RecyclerView内部提供Adapter并强制要求提供ViewHolder
• RecyclerView内部提供LayoutManager并提供线性、网格和瀑布流的实现
• RecyclerView内部提供ItemAnimator并默认实现列表项删除和添加动画

RecyclerView设计思路

理念：简化数据的显示操作和处理大数据集

Adapter：提供view来显示数据集中的元素
LayoutManager：放置元素到布局中
ItemAnimator：设置添加和移除元素的动画

具体步骤

1. 添加依赖库并在layout文件中引入RecyclerView

（1）添加依赖

compile 'com.android.support:recyclerview-v7:21.0.+'

（2） 引入RecyclerView

<android.support.v7.widget.RecyclerView
    android :id= "@+id/recycler_news"
    android :layout_width= "match_parent"
    android :layout_height= "match_parent" />

2. 指定RecyclerView是否固定大小

如果Adapter的变化不会影响RecyclerView的大小，也就是说RecyclerView的大小跟里面的列表项的多少和大小无关的话，请设置setHasFixedSize( true)，这样可以提高性能，因为不同去动态计算RecyclerView的大小。

mRecyclerView.setHasFixedSize( true) ;

3. 新建并设置LayoutManager

private RecyclerView.LayoutManager mLayoutManager;
// 线性布局，可以设置方向
mLayoutManager = new LinearLayoutManager(this);
// or 网格布局，可以设置列数和方向，是否反向显示
mLayoutManager = new GridLayoutManager(this,2,LinearLayoutManager.HORIZONTAL,false);
// or 瀑布流布局，可以设置列数和方向
mLayoutManager = new StaggeredGridLayoutManager(2,StaggeredGridLayoutManager.VERTICAL);
mRecyclerView.setLayoutManager(mLayoutManager);

4. 继承并设置Adapter

（1）新建Adapter类，继承自RecyclerView.Adapter
（2）新建ViewHolder内部类，继承自RecyclerView.ViewHolder并让Adapter的泛型设为该内部类
（3）实现Adapter的方法
1. 构造方法：一般用于接收数据集
2. onCreateViewHolder：用于从列表项布局文件中装载布局并新建一个ViewHolder装入列表项视图
3. onBindViewHolder：用于数据和ViewHolder（视图 ）的绑定
4. getItemCount：用于指定数据项的多少

public class MyAdapter extends RecyclerView.Adapter<MyAdapter.ViewHolder> {
    private String[] mDataset;

    // 提供视图和数据项之间的引用
    public static class ViewHolder extends RecyclerView.ViewHolder {
        // each data item is just a string in this case
        public TextView mTextView;
        public ViewHolder(TextView v) {
            super(v);
            mTextView = v;
        }
    }

    // 依赖于数据集的构造方法
    public MyAdapter(String[] myDataset) {
        mDataset = myDataset;
    }

    // 创建一个新的View (由布局管理器调用)
    @Override
    public MyAdapter.ViewHolder onCreateViewHolder(ViewGroup parent,
                                                  int viewType) {
        View v = LayoutInflater.from(parent.getContext())
                              .inflate(R.layout.my_text_view, parent, false);
        ...
        ViewHolder vh = new ViewHolder(v);
        return vh;
    }

    // 替换View的内容 (由布局管理器调用)
    @Override
    public void onBindViewHolder(ViewHolder holder, int position) {
        // - 获取数据集中该position的元素
        // - 使用该元素替换View的内容
        holder.mTextView.setText(mDataset[position]);

    }

    // 返回数据集的大小 (由布局管理器调用)
    @Override
    public int getItemCount() {
        return mDataset.length;
    }
}

Q&A

问题1：如何设置列表项点击事件？

（1） 解决思路

使用Java的回调机制

（2） 具体解决方法

在Adapter中提供OnItemClickListener接口和设置接口的方法

public interface OnItemClickListener {
    void onItemClick(View View, int position);
}

private OnItemClickListener onItemClickListener;

public void setOnItemClickListener(OnItemClickListener onItemClickListener) {
    this.onItemClickListener = onItemClickListener;
}

在onBindViewHolder方法中设置点击监听器并调用接口方法

if (onItemClickListener != null) {
    holder.itemView.setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View v) {
            onItemClickListener.onItemClick(holder.itemView, newPosition);
        }
    });
}

在Activity/Fragment中实现接口方法

@Override
public void onNewsItemClick(String newsId) {
    // do sth.
}

问题2：如何实现上拉加载？

（1）解决思路

给RecyclerView添加OnScrollListener，判定是否到达底部，然后执行加载更多操作

（2）具体步骤

mRecyclerView.addOnScrollListener(new RecyclerView.OnScrollListener() {
    @Override
    public void onScrollStateChanged(RecyclerView recyclerView, int newState) {
    }

    @Override
    public void onScrolled(RecyclerView recyclerView, int dx, int dy) {
        //得到当前显示的最后一个item的view
        View lastChildView = recyclerView.getLayoutManager().getChildAt(recyclerView.getLayoutManager().getChildCount()-1);
        //得到lastChildView的bottom坐标值
        int lastChildBottom = lastChildView.getBottom();
        //得到Recyclerview的底部坐标减去底部padding值，也就是显示内容最底部的坐标
        int recyclerBottom =  recyclerView.getBottom()-recyclerView.getPaddingBottom();
        //通过这个lastChildView得到这个view当前的position值
        int lastPosition  = recyclerView.getLayoutManager().getPosition(lastChildView);

        //判断lastChildView的bottom值跟recyclerBottom
        //判断lastPosition是不是最后一个position
        //如果两个条件都满足则说明是真正的滑动到了底部
        if(lastChildBottom == recyclerBottom && lastPosition == recyclerView.getLayoutManager().getItemCount()-1 ){
            Toast.makeText(getContext(), "滑动到底了", Toast.LENGTH_SHORT).show();
        }
    }
});

问题3：如何实现下拉刷新？

（1）解决思路

使用SwipeRefreshLayout包裹RecyclerView，并设置OnRefreshListener

（2）具体步骤
// 略

问题4：如何添加Header和Footer？

（1）解决思路

重写Adapter的getItemViewType方法，使得不同索引位置的ItemView定义为不同的类型。
要修改onCreateViewHolder、onBindViewHolder、getItemCount方法以及ViewHolder的构造方法。

（2）具体步骤

提供HeaderView的获取和设置方法

public void setHeaderView(View headerView) {
    mHeaderView = headerView;
    notifyItemInserted(0);
}

public View getHeaderView() {
    return mHeaderView;
}

定义两种列表项类型

public static final int TYPE_HEADER = 0;
public static final int TYPE_NORMAL = 1;

重写getItemViewType方法

@Override
public int getItemViewType(int position) {
    if(mHeaderView == null) return TYPE_NORMAL;
    if(position == 0) return TYPE_HEADER;
    return TYPE_NORMAL;
}

修改onCreateViewHolder、onBindViewHolder、getItemCount方法以及ViewHolder的构造方法

@Override
public RecyclerView.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
    if(mHeaderView != null && viewType == TYPE_HEADER) return new Holder(mHeaderView);
    View layout = LayoutInflater.from(parent.getContext()).inflate(R.layout.item, parent, false);
    return new Holder(layout);
}

@Override
public void onBindViewHolder(RecyclerView.ViewHolder viewHolder, int position) {
    if(getItemViewType(position) == TYPE_HEADER) return;
    final int pos = getRealPosition(viewHolder);
    final String data = mDatas.get(pos);
    if(viewHolder instanceof Holder) {
        ((Holder) viewHolder).text.setText(data);
    }
}

public int getRealPosition(RecyclerView.ViewHolder holder) {
    int position = holder.getLayoutPosition();
    return mHeaderView == null ? position : position - 1;
}

@Override
public int getItemCount() {
    return mHeaderView == null ? mDatas.size() : mDatas.size() + 1;
}

class Holder extends RecyclerView.ViewHolder {
    TextView text;
    public Holder(View itemView) {
        super(itemView);
        if(itemView == mHeaderView) return;
        text = (TextView) itemView.findViewById(R.id.text);
    }
}

问题5：如何添加列表项的分隔线？

（1）解决思路

RecyclerView内部提供ItemDecoration抽象类，用于实现列表项之间的分割线、高亮或分组。

• 提供getItemOffsets方法用于设置列表项之间的间隔；
• 提供onDraw方法在列表项之前绘制分割线；
• 提供onDrawOver方法在列表下之后绘制分割线。

使用addItemDecoration方法可以给RecyclerView添加ItemDecoration。

（2）使用步骤

以设置列表项之间的间隔为例

mRecyclerView.addItemDecoration(new RecyclerView.ItemDecoration() {
    @Override
    public void getItemOffsets(Rect outRect, View view, RecyclerView parent, RecyclerView.State state) {
        super.getItemOffsets(outRect, view, parent, state);
        if (parent.getChildAdapterPosition(view) != 0) { //排除第一个
            outRect.top = getContext().getResources().getDimensionPixelSize(R.dimen.list_item_vertical_margin);
        }
    }
});

问题6：如何自定义添加和删除动画？

（1）解决思路

RecyclerView默认使用DefaultItemAnimator，要自定义的话，需要继承ItemAnimator，并调用RecyclerView的addItemAnimator方法。

（2）具体步骤

//todo

问题7：StaggeredGridLayoutManager为什么不需要传入Context？

三个LayoutManager之间的关系

LinearLayoutManager中虽然要求要Context，但是实际上内部并没有使用，可能是留待以后扩展用，GridLayoutManager继承自LinearLayoutManager，所以也需要Context；StaggeredGridLayoutManager在设计时就不要求Context。

参考文档

1. 创建列表和卡片
2. RecyclerView用法介绍
3. RecyclerView添加Header的正确方式
4. Android中Recyclerview监听是否滑动到底部