Android新特性之RecyclerView的简单使用

Android新特性之RecyclerView的简单使用

RecyclerView是安卓5.0版本中的一个新控件，目的是来取代使用多年的ListView。RecyclerView的灵活性远超ListView，所以RecyclerView扩展性非常高，下面就让我们一起来看看RecyclerView的简单使用。

简介

RecyclerView的设计非常灵活，它通过LayoutManager、ItemDecoration、ItemAnimator这三个类进行所有的布局控制，绑定数据依旧是使用Adapter进行绑定。所以我们只需要掌握这三个类的使用即可。

环境配置

RecyclerView是android系统提供的新控件，自然按照谷歌的一贯作风，我们需要下载一个支持库。android.support.v7。所以使用该控件，我们需要添加v7包的引用。v7下载地址。
下载完成后，我们需要在开发环境中添加该包的引用。简要介绍在Eclipse和Android Studio中的引用方式。

Eclipse添加V7包

1、在eclipse的工作控件将v7包导入到我们的工程中。注意：此时应将我们下载好的v7包放到我们工程目录下，不然后面导入后会出问题。
2、选中我们的项目，右键properties属性，进入如下图，我们点击add，系统就会在我们的工作目录下，找到Library类库，供我们添加，我们选择v7即可。这样我们就可以使用RecyclerView了。

注意：如果你添加到v7包到eclipse了，但是找不到该library，你选中v7包工程右键属性选择Library，然后勾选上图中的isLibrary，点击确定即可。

AndroidStudio中添加v7包

1、要确保已经将Android Support Libraries升级到最新。
2、打开我们的module对应的build.gradle文件，在dependencies中添加

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

3、重新Build一下工程即可。

相关类介绍

一、RecyclerView
我们打开源码，看到

public class RecyclerView extends ViewGroup 

所以这也就是我们常见的自定义ViewGroup，只不过这个玩意比较牛逼罢了。通过源码，我们看到这玩意有很多方法，但是我们仅仅挑选几个常用的来说说。
1、public void setAdapter(Adapter adapter)
根据我们使用的经验，显然这个方法是让我们绑定数据的，只不过这个Adapter是

public static abstract class Adapter<VH extends ViewHolder>

类型的。
2、 public void setLayoutManager(LayoutManager layout)
看到layout开头，显然是跟布局有关，又有manager，所以这个LayoutManager肯定就是负责RecyclerView的布局的类。
3、public void addItemDecoration(ItemDecoration decor, int index)
为每个item附加的子视图，这个方法可用于添加分割线，这点和我们使用ListView的setDivider()有点类似，此时，我们只要传入一个ItemDecoration对象。
4、 public void setItemAnimator(ItemAnimator animator)
这个方法很牛逼，可以设置动画。先来看看官方文档对此方法的注释。

* Sets the {@link ItemAnimator} that will handle animations involving changes
     * to the items in this RecyclerView. By default, RecyclerView instantiates and
     * uses an instance of {@link DefaultItemAnimator}. Whether item animations are
     * enabled for the RecyclerView depends on the ItemAnimator and whether
     * the LayoutManager {@link LayoutManager#supportsPredictiveItemAnimations()
     * supports item animations}.
     */

这段话的大概意思就是通过此方法设置ItemAnimator对象来实现RecyclerView的item的动画，默认情况下，使用DefaultItemAnimator动画。动画是否有效取决于ItemAnimator和LayoutManager的类对象。

以上就是众多方法中比较常用的四个，这四个方法的灵活性很高，所以也铸就了RecyclerView的高度灵活性，看了上面的四个方法，我们可以肯定RecyclerView类的内部肯定有对应的四个类对象来处理所需的效果。

二、LayoutManager
上面也分析了，这个LayoutManager就是我们的布局管理器。我们下来看看一张类的组织结构图。

我们先来看看该类的定义源码来一睹风采。

public static abstract class LayoutManager 

看到源码，吓了一跳，原来是一个抽象类，那我们setLayoutManager(LayoutManager layout)时难道要我们自定义一个LayoutManager对象么？哈哈！不会的，如果真是那样，我估计RecyclerView就变的极其复杂了，为什么？且看源码对该类的注释。

 /**
     * A LayoutManager is responsible for measuring and positioning item views
     * within a RecyclerView as well as determining the policy for when to recycle
     * item views that are no longer visible to the user. By changing the LayoutManager
     * a RecyclerView can be used to implement a standard vertically scrolling list,
     * a uniform grid, staggered grids, horizontally scrolling collections and more. Several stock
     * layout managers are provided for general use.
 */

意思就是：LayoutManager负责RecyclerView中item的测量以及放置，同时也管理着item的回收。通过改变LayoutManager可以让RecyclerView形成垂直滚动的效果(ListView)，统一网格效果(GridView)、交错网格效果(瀑布流)、横向滚动效果(HorizontalListView)等等。

所以说，这么复杂的东西怎么能让开发者完全实现呢？安卓肯定会给我们提供几个实现好的类。

• LinearLayoutManager：线性布局管理器，支持横向和纵向形式。
• GridLayoutManager： 网格布局管理器。
• StaggeredGridLayoutManager：瀑布就式布局管理器

所以在实际开发中，我们可以根据实际需要进行使用，一般情况下，这三个子类能完全满足我们的需求，更高需求，请自定义LayoutManager对象。

三、ItemDecoration
为每个item附加的子视图，这个类可用于我们设置分割线，同样也是RecyclerView类的内部类，那么我们看看它的定义形式：

public static abstract class ItemDecoration 

又是一个抽象类，所以注定了它是不平凡的，即我们需要自定义它的子类来实现绚丽的分割效果，官方现在好像还没有吧！以后估计可能有。

四、ItemAnimator
一看，跟Animator沾边，八成就是搞动画的出身。同样该类也是RecyclerView类的内部类，我们看看它的定义吧！

public static abstract class ItemAnimator

所以注定了不平凡有不平凡的伟大，我们需要自定义子类来实现动画，系统也提供默认的。

关于RecyclerView的基本要素，我们简要说了下，总体来说，功能很强大，能玩多6全看自身水平多高，涉及的方面比较多，上手比较容易，想精通这个控件，还是需要下很大功夫的。下面就开始学习使用这个控件了。

RecyclerView的使用

1、基本使用步骤：

View view = inflater.inflate(R.layout.fragment_linear_layout_manager, container, false);
    //RecyclerView的初始化
    mRecyclerView = (RecyclerView)view.findViewById(R.id.recycler_view);
    //创建现行LinearLayoutManager
    mLayoutManager = new LinearLayoutManager(getActivity());
    //设置LayoutMananger
    mRecyclerView.setLayoutManager(mLayoutManager);
    //设置item的动画，可以不设置
    mRecyclerView.setItemAnimator(new DefaultItemAnimator());
    MyAdapter adapter = new MyAdapter(initDate());
    //设置Adapter
    mRecyclerView.setAdapter(adapter);

以上就是使用的几个步骤，很简单，所以我们就开始学习使用。由于演示功能较多，所以我们采用在Fragment中进行。

ListView效果

1、首先我们创建名称为LinearLayoutManagerFragment的Fragment，用于展示线性的布局，然后创建对应的xml布局。在AndroidStudio中我们创建该fragment时系统已经默认帮我们创建好了，Eclipse中就不会。我们直接看xml布局中的RecyclerView的使用吧！

"http://schemas.android.com/apk/res/android"
        android:layout_width="match_parent"
        android:layout_height="match_parent">
        .support.v7.widget.RecyclerView
            android:id="@+id/recycler_view"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            android:scrollbars="vertical"
            />
    

使用很简单，下面看看我们在Fragment中的使用代码：

public class LinearLayoutManagerFragment extends Fragment {
    private RecyclerView mRecyclerView;
    private RecyclerView.LayoutManager mLayoutManager;

    @Override
    public View onCreateView(LayoutInflater inflater, ViewGroup container,
                             Bundle savedInstanceState) {
        View view = inflater.inflate(R.layout.fragment_linear_layout_manager, container, false);
        //RecyclerView的初始化
        mRecyclerView = (RecyclerView)view.findViewById(R.id.recycler_view);
        //创建现行LinearLayoutManager
        mLayoutManager = new LinearLayoutManager(getActivity());
        //设置LayoutMananger
        mRecyclerView.setLayoutManager(mLayoutManager);
        //设置item的动画，可以不设置
        mRecyclerView.setItemAnimator(new DefaultItemAnimator());
        MyAdapter adapter = new MyAdapter(initDate());
        //设置Adapter
        mRecyclerView.setAdapter(adapter);
        return view;
    }

    private List initDate(){
        List list = new ArrayList<>();
        for(int i=0;i<50;i++){
            list.add("测试用例：" + i);
        }
        return list;
    }

    class MyAdapter  extends RecyclerView.Adapter{
        private List items;

        public MyAdapter(List items) {
            this.items = items;
        }

        /**
         * 创建ViewHolder的布局
         * @param parent
         * @param viewType
         * @return
         */
        @Override
        public MyAdapter.ViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
            View view = LayoutInflater.from(parent.getContext()).inflate(R.layout.item,parent,false);
            return new ViewHolder(view);
        }

        /**
         * 通过ViewHolder将数据绑定到界面上进行显示
         * @param holder
         * @param position
         */
        @Override
        public void onBindViewHolder(MyAdapter.ViewHolder holder, int position) {
            holder.mTextView.setText(items.get(position));
        }

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

        public class ViewHolder extends RecyclerView.ViewHolder{
            public TextView mTextView;
            public ViewHolder(View itemView) {
                super(itemView);
                mTextView = (TextView) itemView.findViewById(R.id.textView);
            }
        }
    }
    }

item的布局，仅仅包含一个TextView用于展示。

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical" android:layout_width="match_parent"
    android:layout_height="match_parent">
     <TextView
        android:id="@+id/textView"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:padding="20dp"
        android:background="#7fa87f"
        android:textColor="#ffffff"
        android:gravity="center_horizontal"/>
    LinearLayout>

使用步骤与我们开篇说的一样，其实和ListView的使用差异不大，初始化控件，然后设置控件的相关属性，接着绑定数据，只不Recyclerview的属性设置有些复杂罢了。比较明显的变化就数Adapter的变化了。以前在使用ListView时，我们继承BaseAdapter来自定义Adatper适配器，然后使用ViewHolder进行复用Item。现在我们在看看RecyclerView.Adapter。

public static abstract class Adapter<VH extends ViewHolder>

看到这个类的定义确实吓一跳，Adapter里面都是ViewHolder类型，难道系统有ViewHolder，猜对了，系统中已经带了ViewHolder类型，

public static abstract class ViewHolder

所以我们我们要继承此ViewHolder来自定义我们的ViewHolder。就有了上面的写法，来发效果图！

ok，简单的使用已经完成，我们前面也分析了，RecyclerView可以实现横向的ListView，那么我们来看看效果，我们创建名为HorrizontalManagerFragment的fragment。内容可以完全复制LinearLayoutManagerFragment的内容，只需要做以下几点修改：

 private LinearLayoutManager mLayoutManager;
    mLayoutManager.setOrientation(LinearLayoutManager.HORIZONTAL);

即可。效果图：

上面的效果实现了，但是感觉是不是很别扭，少了点什么。就是分割线，下面我们来给我们的RecyclerView添加分割线。当我们调用mRecyclerView.addItemDecoration()方法添加decoration的时候，RecyclerView在绘制的时候，去会绘制decorator，即调用该类的onDraw和onDrawOver方法，

• onDraw方法先于drawChildren
• onDrawOver在drawChildren之后，一般我们选择复写其中一个即可。
• getItemOffsets 可以通过outRect.set()为每个Item设置一定的偏移量，主要用于绘制Decorator。

我们建一个包用来放我们的ItemDecoration，我们先找一个现成的例子，来试试。

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) {
        Log.v("recyclerview - itemdecoration", "onDraw()");

        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);
            android.support.v7.widget.RecyclerView v = new android.support.v7.widget.RecyclerView(parent.getContext());
            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);
        }
    }
    }

在Fragment中只需增加

mRecyclerView.addItemDecoration(new DividerItemDecoration(getActivity(),LinearLayoutManager.VERTICAL));

来看看效果图：

通过上面的实例，线条已经画出来了，我们只需要改变Draw的实例就可以了，所以这个玩的空间就比较大了。比如：

    <shape xmlns:android="http://schemas.android.com/apk/res/android"
    android:shape="rectangle" >
        <solid android:color="#00ff00"/>
        <corners android:radius="20dp"/>
        <size android:height="4dp"/>
    shape>

效果图：

总之不单单添加分割线，其它用处也很多，样式更加随心所欲。

GridView效果

步骤如上，我们只需要更改LayoutManager所指向的对象即可。

mLayoutManager = new GridLayoutManager(getActivity(),4);

这样就能实现一个GridView效果，我们要处理的就是ItemDecrator的处理。
下面引自张鸿洋写的一个效果：

/**
     * 
     * @author zhy
     * 
     */
    public class DividerGridItemDecoration extends RecyclerView.ItemDecoration
    {

        private static final int[] ATTRS = new int[] { android.R.attr.listDivider };
        private Drawable mDivider;

        public DividerGridItemDecoration(Context context)
        {
            final TypedArray a = context.obtainStyledAttributes(ATTRS);
            mDivider = a.getDrawable(0);
            a.recycle();
        }

        @Override
        public void onDraw(Canvas c, RecyclerView parent, State state)
        {

            drawHorizontal(c, parent);
            drawVertical(c, parent);

        }

        private int getSpanCount(RecyclerView parent)
        {
            // 列数
            int spanCount = -1;
            LayoutManager layoutManager = parent.getLayoutManager();
            if (layoutManager instanceof GridLayoutManager)
            {

                spanCount = ((GridLayoutManager) layoutManager).getSpanCount();
            } else if (layoutManager instanceof StaggeredGridLayoutManager)
            {
                spanCount = ((StaggeredGridLayoutManager) layoutManager)
                        .getSpanCount();
            }
            return spanCount;
        }

        public void drawHorizontal(Canvas c, RecyclerView parent)
        {
            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.getLeft() - params.leftMargin;
                final int right = child.getRight() + params.rightMargin
                        + mDivider.getIntrinsicWidth();
                final int top = child.getBottom() + params.bottomMargin;
                final int bottom = top + mDivider.getIntrinsicHeight();
                mDivider.setBounds(left, top, right, bottom);
                mDivider.draw(c);
            }
        }

        public void drawVertical(Canvas c, RecyclerView parent)
        {
            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.getTop() - params.topMargin;
                final int bottom = child.getBottom() + params.bottomMargin;
                final int left = child.getRight() + params.rightMargin;
                final int right = left + mDivider.getIntrinsicWidth();

                mDivider.setBounds(left, top, right, bottom);
                mDivider.draw(c);
            }
        }

        private boolean isLastColum(RecyclerView parent, int pos, int spanCount,
                int childCount)
        {
            LayoutManager layoutManager = parent.getLayoutManager();
            if (layoutManager instanceof GridLayoutManager)
            {
                if ((pos + 1) % spanCount == 0)// 如果是最后一列，则不需要绘制右边
                {
                    return true;
                }
            } else if (layoutManager instanceof StaggeredGridLayoutManager)
            {
                int orientation = ((StaggeredGridLayoutManager) layoutManager)
                        .getOrientation();
                if (orientation == StaggeredGridLayoutManager.VERTICAL)
                {
                    if ((pos + 1) % spanCount == 0)// 如果是最后一列，则不需要绘制右边
                    {
                        return true;
                    }
                } else
                {
                    childCount = childCount - childCount % spanCount;
                    if (pos >= childCount)// 如果是最后一列，则不需要绘制右边
                        return true;
                }
            }
            return false;
        }

        private boolean isLastRaw(RecyclerView parent, int pos, int spanCount,
                int childCount)
        {
            LayoutManager layoutManager = parent.getLayoutManager();
            if (layoutManager instanceof GridLayoutManager)
            {
                childCount = childCount - childCount % spanCount;
                if (pos >= childCount)// 如果是最后一行，则不需要绘制底部
                    return true;
            } else if (layoutManager instanceof StaggeredGridLayoutManager)
            {
                int orientation = ((StaggeredGridLayoutManager) layoutManager)
                        .getOrientation();
                // StaggeredGridLayoutManager 且纵向滚动
                if (orientation == StaggeredGridLayoutManager.VERTICAL)
                {
                    childCount = childCount - childCount % spanCount;
                    // 如果是最后一行，则不需要绘制底部
                    if (pos >= childCount)
                        return true;
                } else
                // StaggeredGridLayoutManager 且横向滚动
                {
                    // 如果是最后一行，则不需要绘制底部
                    if ((pos + 1) % spanCount == 0)
                    {
                        return true;
                    }
                }
            }
            return false;
        }

        @Override
        public void getItemOffsets(Rect outRect, int itemPosition,
                RecyclerView parent)
        {
            int spanCount = getSpanCount(parent);
            int childCount = parent.getAdapter().getItemCount();
            if (isLastRaw(parent, itemPosition, spanCount, childCount))// 如果是最后一行，则不需要绘制底部
            {
                outRect.set(0, 0, mDivider.getIntrinsicWidth(), 0);
            } else if (isLastColum(parent, itemPosition, spanCount, childCount))// 如果是最后一列，则不需要绘制右边
            {
                outRect.set(0, 0, 0, mDivider.getIntrinsicHeight());
            } else
            {
                outRect.set(0, 0, mDivider.getIntrinsicWidth(),
                        mDivider.getIntrinsicHeight());
            }
        }
    }

效果图：

瀑布流效果

同样，我们只需要修改LayoutManager来实现效果：

mLayoutManager = new StaggeredGridLayoutManager(3, StaggeredGridLayoutManager.VERTICAL);

效果图：

我们发现，每个item都很整齐，但是瀑布流的效果不是这样的啊！那我们怎么搞，就是在onBindViewHolder方法中修改每个view的大小。

 @Override
        public void onBindViewHolder(MyAdapter.ViewHolder holder, int position) {
            ViewGroup.LayoutParams params= holder.mTextView.getLayoutParams();
            params.height = (int) (100 + Math.random() * 400);
            holder.mTextView.setLayoutParams(params);
            holder.mTextView.setText(items.get(position));
        }

效果图：

至此，所有的展示工作已经完成，那么我们进行点击事件处理。

点击效果处理

RecyclerView没有像ListView有setOnItemClick的事件，那么只有我们通过回调接口进行设置。

public interface OnItemClick {
    public void onItemClick(int position);
    }

     public void setOnItemClick(OnItemClick onItemClick){
            this.onItemClick = onItemClick;
     }

    public void onBindViewHolder(final MyAdapter.ViewHolder holder, int position) {
            holder.mTextView.setText(items.get(position));
            if(onItemClick != null){
                holder.itemView.setOnClickListener(new View.OnClickListener() {
                    @Override
                    public void onClick(View v) {
                        onItemClick.onItemClick(holder.getPosition());
                    }
                });
            }
        }

这样我们就能进行点击事件的处理了。效果图：

至此，关于RecyclerView的基本用法讲解完毕，还是要多练习，比如分割线的处理以及动画的处理，这部分是个亮点也是难点。

源码下载地址

参考文档:
http://www.devstore.cn/new/newInfo/868.html
http://blog.jobbole.com/74208/
http://www.jcodecraeer.com/a/anzhuokaifa/androidkaifa/2014/1118/2004.html
http://blog.csdn.net/lmj623565791/article/details/45059587
http://blog.csdn.net/guxiao1201/article/details/40399777

作者：mr_dsw 欢迎转载，与人分享是进步的源泉！

转载请保留地址：http://blog.csdn.net/mr_dsw