前言
RecyclerView是Android5.0带来的一个旨在替代ListView的新控件，收录在android.support.v7.widget包下。转眼之间，它已经面世2年了，大家也或多或少了解或运用过这个吊吊的控件，下面就由我带领您走向RecyclerView的世界。
初识RecyclerView
我们先来看看这个控件的名字，所谓RecyclerView，意思就是老子只负责回收复用View，其它的事不管。看它趾高气扬的样子，你是不是想弄死它？其实啊，人家确实有装B的资格，相比较ListView而言，我们可以更加灵活地定制控件的效果。
要使用RecyclerView，首先需要了解以下两个相关的类：
LayoutManager
这个类主要用于控制RecyclerView的显示规则的，它是一个抽象类，系统给我们提供了三个默认的实现类，它们是LinearLayoutManager 、 GridLayoutManager和StaggeredGridLayoutManager。
从名字就可以看出，我们可以利用它们分别让RecyclerView显示线性布局，网格布局和瀑布流布局。
RecyclerView.Adapter
同ListView一样，RecyclerView也提供一个适配器来控制每个item的显示内容。我们需要继承RecyclerView.Adapter<VH extends VeiwHolder>，并将泛型中的类名指定为自定义的ViewHolder类名，接着创建一个静态的自定义ViewHolder（RecyclerView帮我们封装好了ViewHolder，我们只需要在它的基础上实现功能即可），然后复写以下三个方法：
onCreateViewHolder
该方法主要为每一个item加载布局，并将布局传递给自定义的ViewHolder。onBindViewHolder
该方法主要是建立起自定义ViewHolder中视图与数据的关联。getItemCount
该方法用于对item进行计数。
简单的实现
废话不多说，下面我们来进入实战，首先我们要实现一个ListView显示item项的效果。
在AS中新建一个项目，我们这里就叫做RecyclerViewTest吧，添加以下依赖：
dependencies {
...//其它依赖
compile 'com.android.support:recyclerview-v7:24.2.1'
}
接着在布局文件中创建我们的RecyclerView布局：
<RelativeLayout
xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:id="@+id/activity_main"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context="com.wuminmiao.recycleviewtest.MainActivity">
<android.support.v7.widget.RecyclerView
android:layout_width="match_parent"
android:layout_height="match_parent"
android:scrollbars="vertical"/>
</RelativeLayout>
并创建item的布局：
<?xml version="1.0" encoding="utf-8"?>
<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:background="#add8e6"
android:layout_height="70dp">
<TextView
android:id="@+id/text"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:gravity="center"/>
</FrameLayout>
然后在MainActivity的onCreate方法中获取RecyclerView的实例，并且为它设置适配器Adapter和布局管理器LayoutManager。MainActivity的代码如下：
import android.app.Activity;
import android.os.Bundle;
import android.support.v7.widget.LinearLayoutManager;
import android.support.v7.widget.RecyclerView;
import java.util.ArrayList;
import java.util.List;
public class MainActivity extends Activity {
private RecyclerView mRecyclerView;
private RecyclerView.Adapter mAdapter;
private RecyclerView.LayoutManager mLayoutManager;
private List<String> mDataset;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate (savedInstanceState);
setContentView (R.layout.activity_main);
initViews();
initData();
mLayoutManager = new LinearLayoutManager (this,
LinearLayoutManager.VERTICAL, false);//这里我们使用默认的线性布局管理器,将其设为垂直显示
mRecyclerView.setLayoutManager (mLayoutManager);//设置布局管理器
mAdapter = new TestAdapter(this, mDataset);//实例化适配器
mRecyclerView.setAdapter (mAdapter);//设置适配器
}
private void initViews() {
mRecyclerView = (RecyclerView) findViewById (R.id.test_recycle_view);
}
private void initData() {
mDataset = new ArrayList<String> ();
for ( int i = 0; i <= 50; i++) {
mDataset.add( "item"+i);
}
}
}
接着我们就要创建自定义Adapter了：
import android.content.Context;
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;
/**
* Created by wuminmiao on 2016/10/13.
*/
public class TestAdapter extends RecyclerView.Adapter<TestAdapter.MyViewHolder> {
private Context mContext;
private List<String> mDataset;
private LayoutInflater mInflater;
//提供一个合适的构造方法
public TestAdapter(Context context, List<String> dataset) {
this.mContext = context;
this.mDataset = dataset;
mInflater = LayoutInflater.from (context);
}
/**
*将布局转换为View并传递给自定义的MyViewHolder
* @param viewGroup
* @param viewType
* @return
*/
@Override
public MyViewHolder onCreateViewHolder(ViewGroup viewGroup, int viewType) {
View view = mInflater.inflate (R.layout.item, viewGroup, false);
MyViewHolder viewHolder = new MyViewHolder (view);
return viewHolder;
}
/**
* 建立起MyViewHolder中视图与数据的关联
* @param viewHolder
* @param position
*/
@Override
public void onBindViewHolder(MyViewHolder viewHolder, int position) {
viewHolder.mTextView.setText(mDataset.get (position));
}
/**
* 获取item的数目
* @return
*/
@Override
public int getItemCount() {
return mDataset.size ();
}
//自定义的ViewHoder，持有item的所有控件
public static class MyViewHolder extends RecyclerView.ViewHolder {
TextView mTextView;
public MyViewHolder(View view) {
super (view);
mTextView = (TextView) view.findViewById(R.id.text);
}
}
}
现在，我们这个例子就可以正常运行了，效果如下：
恩？好像哪里不对！分割线哪里去了？以前用ListView时，我们还可以通过divider属性来设置分割线，但到了RecyclerView这却不行了。这位大爷除了回收复用外啥事都不管，什么设置分割线啊，给item设置动画效果啊等等它丫的统统抛在脑后！那是不是就没辙了？肯定不是啦，前面我们就说过，我们可以自由地定制RecyclerView，那分割线这点芝麻大的事肯定也不在话下啦。
系统给我们提供了一个叫做ItemDecoration的抽象类，却并没有提供它的实现类供我们使用，所以我们必须通过自定义它去使用它，这里我就不重复造轮子啦，网上有很多现成的ItemDecoration的实现类，我们挑一个比较好用的来实现分割线效果:
在我们的项目中添加DividerItemDecoration，该类的代码如下：
import android.content.Context;
import android.content.res.TypedArray;
import android.graphics.Canvas;
import android.graphics.Rect;
import android.graphics.drawable.Drawable;
import android.support.v7.widget.LinearLayoutManager;
import android.support.v7.widget.RecyclerView;
import android.view.View;
public class DividerItemDecoration extends RecyclerView.ItemDecoration {
private static final int[] ATTRS = new int[]{
android.R.attr.listDivider
};
public static final int HORIZONTAL_LIST = LinearLayoutManager.HORIZONTAL;
public static final int VERTICAL_LIST = LinearLayoutManager.VERTICAL;
private Drawable mDivider;
private int mOrientation;
public DividerItemDecoration(Context context, int orientation) {
final TypedArray a = context.obtainStyledAttributes(ATTRS);
mDivider = a.getDrawable(0);
a.recycle();
setOrientation(orientation);
}
public void setOrientation(int orientation) {
if (orientation != HORIZONTAL_LIST && orientation != VERTICAL_LIST) {
throw new IllegalArgumentException("invalid orientation");
}
mOrientation = orientation;
}
@Override
public void onDraw(Canvas c, RecyclerView parent) {
if (mOrientation == VERTICAL_LIST) {
drawVertical(c, parent);
} else {
drawHorizontal(c, parent);
}
}
public void drawVertical(Canvas c, RecyclerView parent) {
final int left = parent.getPaddingLeft();
final int right = parent.getWidth() - parent.getPaddingRight();
final int childCount = parent.getChildCount();
for (int i = 0; i < childCount; i++) {
final View child = parent.getChildAt(i);
final RecyclerView.LayoutParams params = (RecyclerView.LayoutParams) child
.getLayoutParams();
final int top = child.getBottom() + params.bottomMargin;
final int bottom = top + mDivider.getIntrinsicHeight();
mDivider.setBounds(left, top, right, bottom);
mDivider.draw(c);
}
}
public void drawHorizontal(Canvas c, RecyclerView parent) {
final int top = parent.getPaddingTop();
final int bottom = parent.getHeight() - parent.getPaddingBottom();
final int childCount = parent.getChildCount();
for (int i = 0; i < childCount; i++) {
final View child = parent.getChildAt(i);
final RecyclerView.LayoutParams params = (RecyclerView.LayoutParams) child
.getLayoutParams();
final int left = child.getRight() + params.rightMargin;
final int right = left + mDivider.getIntrinsicHeight();
mDivider.setBounds(left, top, right, bottom);
mDivider.draw(c);
}
}
@Override
public void getItemOffsets(Rect outRect, int itemPosition, RecyclerView parent) {
if (mOrientation == VERTICAL_LIST) {
outRect.set(0, 0, 0, mDivider.getIntrinsicHeight());
} else {
outRect.set(0, 0, mDivider.getIntrinsicWidth(), 0);
}
}
}
现在我们只需要在MainActivity的onCreate方法中添加如下代码即可添加分隔线了：
mRecyclerView.addItemDecoration (new DividerItemDecoration (this,
DividerItemDecoration.VERTICAL_LIST));
运行程序，效果如下：
由于原来的背景颜色太淡导致分隔线显示不明显，所以我换了一个背景色。
总结
在这篇文章里，我们对RecyclerView有了一个基本的认识并实现了它的一个简单用法，在接下来的几篇博文里，我将给您带来RecyclerView的更多用法。
下篇文章请戳Android RecyclerView的使用解析（二）
该系列文章首发在我的个人博客中
- Android RecyclerView的使用解析（一）
- Android RecyclerView的使用解析（二）
- Android RecyclerView的使用解析（完结篇）
