Android RecylerView入门教程

今年Google I/0大会，Google开放了两个全新的视图：RecyclerView和CardView。这篇文章会提供关于RecylerView的简介。
RecylerView作为support-library发布出来，这对开发者来说绝对是个好消息。因为可以在更低的Android版本上使用这个新视图。下面我们看如何获取RecylerView。首先打开Android SDK Manager，然后更新Extras->Android Support Library即可。

然后在本地../sdk/extras/android/support/v7中找到recyclerview。我已经将下载好的Recyclerview整理成一个Eclipse可编译的Library工程上传到Github，有需求的同学请戳链接。
示例程序
我将通过RecylerView制作一个横向滑动的“ListView”，下面是示例程序的截图。并在ActionBar上设置数据的添加/删除操作。请同学们注意，RecyclerView的接口Google可能会继续优化和修改，所以最终的版本可能和我提供的程序有出入。Demo程序Github链接。

为什么要使用RecyclerView?
Google在是这样描述RecyclerView的：
"A flexible view for providing a limited window into a large data set."
所以RecyclerView适用于无法在一个屏幕范围内展现格式一样的数据时，需要用多行或多列来展示。例如展示联系人，图片，视频等。用户需要滑动屏幕来查看数据，这时RecyclerView的特性就有用武之地了。比如，当用户滑动使当前一个可视的Item滑出屏幕，这个Item的视图将会被回收并在一个新Item进入可视范围后重新被使用。

如下图所示，用户滑动向上滑动左边的RecyclerView，No.0和No.1就会滑出屏幕可视范围，这时右图的No.0和No.1的视图将会被RecyclerView放入一个可重复利用的缓存中以备再次使用。
可回收利用View是个很实用的功能，它不仅可以减少CPU不断inflate View的开销，而且可以节省缓存View的内存开销。
这时，你可能会问：这不是一个新功能啊！是的，我们已经在使用ListView的时候使用了这个机制，但是当使用ListView时，显示，回收等功能是紧密耦合在一起的，Google现在发布RecyclerView，使方法更灵活，开发者也能自定义各种各样的显示效果。
RecyclerView不再负责显示工作
和ListView不一样的是，RecyclerView不再负责Item的摆放等显示方面的功能。所有和布局、绘制等方面的工作Google都其拆分成不同的类进行管理。所以开发者可以自定义各种各样满足定制需求的的功能类。

下面是一些和RecyclerView相关的非常重要的类列表。

ViewHolder
关于ViewHolder，Google早就推荐开发者使用，但也只是建议。但是现在，RecyclerView.Adapter最终要求开发者必须使用ViewHolder。如果你还对ViewHolder不了解，请阅读Android training session。

Demo通过继承RecyclerView.ViewHolder来实现自定义：

public class MyViewHolder extends ViewHolder implements OnClickListener,OnLongClickListener{ public ImageView iv; public TextView tv; private MyItemClickListener mListener; private MyItemLongClickListener mLongClickListener; public MyViewHolder（View rootView,MyItemClickListener listener,MyItemLongClickListener longClickListener） { super（rootView）; iv = （ImageView）rootView.findViewById（R.id.item_iv）; tv = （TextView）rootView.findViewById（R.id.item_tv）; this.mListener = listener; this.mLongClickListener = longClickListener; rootView.setOnClickListener（this）; rootView.setOnLongClickListener（this）; } /** * 点击监听 */ @Override public void onClick（View v） { if（mListener ！= null）{ mListener.onItemClick（v,getPosition（））; } } /** * 长按监听 */ @Override public boolean onLongClick（View arg0） { if（mLongClickListener ！= null）{ mLongClickListener.onItemLongClick（arg0, getPosition（））; } return true; } }

RecyclerView.Adapter
Adapter负责扮演两个角色：不仅为底部数据提供支持而且还负责为数据创建合适的视图。Adapter适用在Android很多控件，例如ListView、AutoCompleteTextView等。

继承RecyclerView.Adapter需要实现以下三个方法：

public ViewHolder onCreateViewHolder（ViewGroup parent,int viewType）public void onBindViewHolder（ViewHolder holder,int position）public int getItemCount（）Demo中的Adapter:[java] view plain copypublic class MyAdapter extends Adapter<MyViewHolder> { private List<MyItemBean> mData; private MyItemClickListener mItemClickListener; private MyItemLongClickListener mItemLongClickListener; public MyAdapter（List<MyItemBean> data）{ this.mData = data; } @Override public int getItemCount（） { return mData.size（）; } @Override public void onBindViewHolder（MyViewHolder holder, int position） { MyItemBean bean = mData.get（position）; holder.tv.setText（bean.tv）; } @Override public MyViewHolder onCreateViewHolder（ViewGroup parent, int viewType） { View itemView = LayoutInflater.from（parent.getContext（））.inflate（R.layout.item, parent,false）; MyViewHolder vh = new MyViewHolder（itemView,mItemClickListener,mItemLongClickListener）;return vh; } }

onCreateViewHolder中负责为Item创建视图，onBindViewHolder负责将数据绑定到Item的视图上。
RecyclerView.LayoutManager
LayoutManager是RecyclerView中最有意思的类。该类负责将每个Item视图在RecylerView中的布局。目前Google提供了LayoutManager的一个子类：LinearLayoutManager。LinearLayoutManager提供了横向和竖向两种布局，Demo就是使用LinearLayoutManger的横向布局实现的。

如果要自定义LayoutManager，需要实现一个abstract方法
public LayoutParams generateDefaultLayoutParams（）
Demo中为RecylerView添加LinearLayoutManager的片段：
MyLayoutManager manager = new MyLayoutManager（this）;
manager.setOrientation（LinearLayout.HORIZONTAL）;//默认是LinearLayout.VERTICAL
mRecyclerView.setLayoutManager（manager）;
LinearLayoutManager提供了如下几个方法来帮助开发者获取屏幕上的顶部item和底部item：
findFirstVisibleItemPosition（）
findFirstCompletelyVisibleItemPosition（）
findLastVisibleItemPosition（）
findLastCompletelyVisibleItemPosition（）
RecyclerView.ItemDecoration
通过ItemDecoration可以使各个Item在视觉上相互分开，其实和ListView的Divider很像。ItemDecoration并不是RecyclerView必须设置的，开发者可以不设置或者设置多个Decoration。RecyclerView会遍历所有的ItemDecoration并调用各自的绘图方法。

继承ItemDecoration需要实现以下三个方法：
public void onDraw（Canvas c,RecyclerView parent,RecyclerView.State state）
public void getItemOffset（Rect outRect,int itemPosition,RecyclerView parent）
LayoutManager会调用getItemOffset方法来计算每个Item的Decoration合适的尺寸。
Demo中自定义了一个ItemDecoration来实现ListView的Divider效果：

public class MyDecoration extends ItemDecoration { private static final int[] ATTRS = new int[]{ android.R.attr.listDivider }; private Drawable mDivider; public MyDecoration（Context ctx）{ final TypedArray a = ctx.obtainStyledAttributes（ATTRS）; mDivider = a.getDrawable（0）; } @Override public void onDraw（Canvas c, RecyclerView parent, State state） { int top = parent.getPaddingTop（）; int bottom = parent.getHeight（） - parent.getPaddingBottom（）; int childCount = parent.getChildCount（）; for（int i=0;i < childCount;i++）{ View child = parent.getChildAt（i）; RecyclerView.LayoutParams layoutParams = （RecyclerView.LayoutParams）child.getLayoutParams（）; int left = child.getRight（） + layoutParams.rightMargin; int right = left + mDivider.getIntrinsicWidth（）; mDivider.setBounds（left, top, right, bottom）; mDivider.draw（c）; } } @Override public void getItemOffsets（Rect outRect, View view, RecyclerView parent, State state） { outRect.set（0, 0, mDivider.getIntrinsicWidth（）, 0）; } }

RecyclerView.ItemAnimatior
当Item有以下三种操作时ItemAnimatior会为RecyclerView提供动画效果：
删除某一个Item
添加一个新的Item
移动某个Item
Google提供了一个名为DefaultItemAnimator的默认ItemAnimator供开发者使用。如果开发者不为RecyclerView设置ItemAnimator，RecyclerView也会使用默认的DefaultItemAnimator。
显然，为了让动画效果起效，开发者必须通知Adapter数据有改变。之前我们使用Adapter时会调用notifyDataSetChanged（）来通知Adapter数据改变并更新视图，现在RecyclerView,Adapter提供了许多notifyXyz（）方法，例如Demo中使用了以下两个方法：
public final void notifyItemInserted（int position）
public final void notifyItemRemoved（int position）
使用RecyclerView
首先，我们先看如何在xml中使用RecyclerView

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools" android:layout_width="match_parent" android:layout_height="match_parent" tools:context="com.xmy.recylerviewdemo.MainActivity" > <android.support.v7.widget.RecyclerView android:id="@+id/recyclerView" android:layout_width="wrap_content" android:layout_height="wrap_content"/> </RelativeLayout>

然后需要开发者在代码中实现RecyclerView的组装，大体可概括为以下步骤：

实例化RecyclerView

为RecyclerView设置LayoutManager

为RecyclerView设置Adapater

如果有需求，可以设置一个或多个ItemDecorations，当然，也可以不设置

如果有需求，可以设置ItemAnimator